8.1 选项文件格式

选项文件是一个简单的记录列表，记录中的每个域独自占有一行，记录之间由空行分隔。注释独自占有一行，可以出现在文件的任何地方，并且由分号开头。分号前允许有空格。

文件中可以包含下列类型的记录：

• 语言定义记录。这些记录有两个域：字符串‘Language’和语言的名字。一旦通过这种方式声明了一个语言，则可以作为选项属性来使用。参见Option properties。
• A target specific save record to save additional information. These records have two fields: the string ‘TargetSave’, and a declaration type to go in the cl_target_option structure.
• 选项定义记录。这些记录有如下域：
  1. 选项的名字，去掉前导符“-”
  2. 空格分隔的选项属性列表 (参见Option properties)
  3. 帮助文本，用于--help（如果第二个域包含Undocumented属性，则会忽略该域）

  缺省的，所有以“f”，“W”或者“m”开头的选项被隐式的假设会有一个“no-”形式。该形式不必再单独列出来。如果以这些字母开头的选项没有“no-”形式，可以使用RejectNegative属性来去掉。

  帮助文本在显示前会被自动换行。正常情况下，选项的名字会被打印在输出的左边，帮助文本被打印在右边。但是，如果帮助文本包含一个tab字符，则tab左边的文本会被用来替代选项的名字，tab右边的文本作为帮助文本。这样就可以用来详尽的阐述选项会使用什么类型的参数。

• 目标掩码记录。这些记录有一个域，形式为‘Mask(x)’。选项处理脚本将会自动在target_flags（参见Run-time Target）中为每个掩码名字x分配一个位，并且将MASK_x宏对应的位置位。同时，会声明一个TARGET_x宏，当MASK_x位被置位时其值为1，否则为0。

  它们最初是为了声明与用户选项没有联系的目标掩码，或者是因为这些掩码表示内部的开关，或者是因为这些选项不在所有的配置中，但是还需要定义掩码的。