5.2 input-select options

The following options select definitions, templates and scheme functions to use.

templ-dirs option (-L).

This is the “search for templates in ‘dir’” option. This option takes a string argument ‘DIR’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

Add a directory to the list of directories autogen searches when opening a template, either as the primary template or an included one. The last entry has the highest priority in the search list. That is to say, they are searched in reverse order.

override-tpl option (-T).

This is the “use ‘tpl-file’ for the template” option. This option takes a string argument ‘TPL-FILE’.

This option has some usage constraints. It:

• may not be preset with environment variables or configuration (rc/ini) files.

Definition files specify the standard template that is to be expanded. This option will override that name and expand a different template.

lib-template option (-l).

This is the “load autogen macros from ‘tpl-file’” option. This option takes a string argument ‘TPL-FILE’.

This option has some usage constraints. It:

• may appear an unlimited number of times.

DEFINE macros are saved from this template file for use in processing the main macro file. Template text aside from the DEFINE macros is is ignored.

Do not use this. Instead, use the INCLUDE macro in your template.

NOTE: THIS OPTION IS DEPRECATED

definitions option.

This is the “read definitions from ‘file’” option. This option takes a string argument ‘FILE’.

This option has some usage constraints. It:

• can be disabled with –no-definitions.
• It is enabled by default.
• may not be preset with environment variables or configuration (rc/ini) files.

Use this argument to specify the input definitions file with a command line option. If you do not specify this option, then there must be a command line argument that specifies the file, even if only to specify stdin with a hyphen (-). Specify, --no-definitions when you wish to process a template without any active AutoGen definitions.

shell option.

This is the “name or path name of shell to use” option. This option takes a string argument ‘shell’.

This option has some usage constraints. It:

• must be compiled in by defining SHELL_ENABLED during the compilation.

By default, when AutoGen is built, the configuration is probed for a reasonable Bourne-like shell to use for shell script processing. If a particular template needs an alternate shell, it must be specified with this option on the command line, with an environment variable (SHELL) or in the configuration/initialization file.

no-fmemopen option (-m).

This is the “do not use in-mem streams” option. If the local C library supports "fopencookie(3GNU)", or "funopen(3BSD)" then AutoGen prefers to use in-memory stream buffer opens instead of anonymous files. This may lead to problems if there is a shortage of virtual memory. If, for a particular application, you run out of memory, then specify this option. This is unlikely in a modern 64-bit virtual memory environment.

On platforms without these functions, the option is accepted but ignored. fmemopen(POSIX) is not adequate because its string buffer is not reallocatable. open_memstream(POSIX) is also not adequate because the stream is only opened for output. AutoGen needs a reallocatable buffer available for both reading and writing.

equate option.

This is the “characters considered equivalent” option. This option takes a string argument ‘char-list’. This option will alter the list of characters considered equivalent. The default are the three characters, "_-^". (The last is conventional on a Tandem/HP-NonStop, and I used to do a lot of work on Tandems.)

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