5.5 processing options

These options can be used to control what gets processed in the definitions files and template files. They specify which outputs and parts of outputs to produce.

skip-suffix option (-s).

This is the “skip the file with this ‘suffix’” option. This option takes a string argument ‘SUFFIX’.

This option has some usage constraints. It:

• may appear an unlimited number of times.
• may not be preset with environment variables or configuration (rc/ini) files.
• must not appear in combination with any of the following options: select-suffix.

Occasionally, it may not be desirable to produce all of the output files specified in the template. (For example, only the ‘.h’ header file, but not the ‘.c’ program text.) To do this specify --skip-suffix=c on the command line.

select-suffix option (-o).

This is the “specify this output suffix” option. This option takes a string argument ‘SUFFIX’.

This option has some usage constraints. It:

• may appear an unlimited number of times.
• may not be preset with environment variables or configuration (rc/ini) files.

If you wish to override the suffix specifications in the template, you can use one or more copies of this option. See the suffix specification in the Format of the Pseudo Macro section of the info doc.

define option (-D).

This is the “name to add to definition list” option. This option takes a string argument ‘value’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

The AutoGen define names are used for the following purposes:

1. Sections of the AutoGen definitions may be enabled or disabled by using C-style #ifdef and #ifndef directives.
2. When defining a value for a name, you may specify the index for a particular value. That index may be a literal value, a define option or a value #define-d in the definitions themselves.
3. The name of a file may be prefixed with $NAME/. The $NAME part of the name string will be replaced with the define-d value for NAME.
4. When AutoGen is finished loading the definitions, the defined values are exported to the environment with, putenv(3). These values can then be used in shell scripts with ${NAME} references and in templates with (getenv "NAME").
5. While processing a template, you may specify an index to retrieve a specific value. That index may also be a define-d value.

It is entirely equivalent to place this name in the exported environment. Internally, that is what AutoGen actually does with this option.

undefine option (-U).

This is the “definition list removal pattern” option. This option takes a string argument ‘name-pat’.

This option has some usage constraints. It:

• may appear an unlimited number of times.
• may not be preset with environment variables or configuration (rc/ini) files.

Similar to ’C’, AutoGen uses #ifdef/#ifndef preprocessing directives. This option will cause the matching names to be removed from the list of defined values.

This document was generated by Bruce Korb on August 21, 2015 using texi2html 1.82.