Previous: , Up: Program Description Attributes   [Contents][Index]


7.5.1.4 User Presentation Attributes

Attributes that affect the user’s experience.

allow-errors

The presence of this attribute indicates ignoring any command line option errors. This may also be turned on and off by invoking the macros ERRSKIP_OPTERR and ERRSTOP_OPTERR from the generated interface file.

long-opts

Presence indicates GNU-standard long option processing. Partial name matches are accepted, if they are at least two characters long and the partial match is unique. The matching is not case sensitive, and the underscore, hyphen and carat characters are all equivalent (they match).

If any options do not have an option value (flag character) specified, and least one does specify such a value, then you must specify long-opts. If none of your options specify an option value (flag character) and you do not specify long-opts, then command line arguments are processed in "named option mode". This means that:

  • Every command line argument must be a long option.
  • The flag markers - and -- are completely optional.
  • The argument program attribute is disallowed.
  • One of the options may be specified as the default (as long as it has a required option argument).
no-xlate

Modifies when or whether option names get translated. If provided, it must be assigned one of these values:

opt-cfg

to suppress option name translation for configuration file and and environment variable processing.

opt

to suppress option name translation completely. The usage text will always be translated if ENABLE_NLS is defined and you have translations for that text.

anything

Specifies disabling all internationalization support for option code, completely.

See also the various XLAT interface entries in the AutoOpts Programmatic Interface section (see Programmatic Interface).

reorder-args

Normally, POSIX compliant commands do not allow for options to be interleaved with operands. If this is necessary for historical reasons, there are two approaches available:

  • Allow optionProcess to return the index of the operand like it normally does and process the operand(s). When an operand is encountered that starts with a hyphen, then set the AutoOpts current index with the RESTART_OPT macro (see see RESTART_OPT( n ) - Resume Option Processing), and re-invoke optionProcess. This will also allow you to process the operands in context.
  • Specify this attribute. AutoOpts will re-order the command arguments so that the operands appear (in the original order) at the end of the argument list. Differing configuration state is not possible to detect after all options have been processed.
resettable

Specifies that the --reset-option command line option is to be supported. This makes it possible to suppress any setting that might be found in a configuration file or environment variable.


Previous: Programming Details, Up: Program Description Attributes   [Contents][Index]