Next: out-handling options, Previous: autogen help/usage (--help), Up: Invoking autogen [Contents][Index]
The following options select definitions, templates and scheme functions to use.
This is the “search for templates in dir” option. This option takes a string argument DIR.
This option has some usage constraints. It:
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.
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:
Definition files specify the standard template that is to be expanded. This option will override that name and expand a different template.
This is the “read definitions from file” option. This option takes a string argument FILE.
This option has some usage constraints. It:
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.
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:
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.
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.
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.)
Next: out-handling options, Previous: autogen help/usage (--help), Up: Invoking autogen [Contents][Index]