| autogen (GNU AutoGen) - The Automated Program Generator - Ver. 5.11.7
USAGE: autogen [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ <def-file> ]
Flg Arg Option-Name Description
-L Str templ-dirs Template search directory list
- may appear multiple times
-T Str override-tpl Override template file
- may not be preset
-l Str lib-template Library template file
- may appear multiple times
-b Str base-name Base name for output file(s)
- may not be preset
Str definitions Definitions input file
- disabled as --no-definitions
- enabled by default
- may not be preset
-S Str load-scheme Scheme code file to load
-F Str load-functions Load scheme function library
-s Str skip-suffix Omit the file with this suffix
- may not be preset
- may appear multiple times
-o opt select-suffix specify this output suffix
- may not be preset
- may appear multiple times
no source-time set mod times to latest source
- disabled as --no-source-time
-m no no-fmemopen Do not use in-mem streams
Str equate characters considered equivalent
no writable Allow output files to be writable
- disabled as --not-writable
- may not be preset
The following options are often useful while debugging new templates:
Flg Arg Option-Name Description
Num loop-limit Limit on increment loops
- is scalable with a suffix: k/K/m/M/g/G/t/T
- It must lie in one of the ranges:
-1 exactly, or
1 to 16777216
Str shell name or path name of shell to use
-t Num timeout Time limit for server shell
- it must be: 0 to 3600
KWd trace tracing level of detail
Str trace-out tracing output file or filter
--- show-defs This option has been disabled
no used-defines Show the definitions used
- may not be preset
These options can be used to control what gets processed
in the definitions files and template files.
Flg Arg Option-Name Description
-D Str define name to add to definition list
- may appear multiple times
-U Str undefine definition list removal pattern
- an alternate for define
These options can be used to automate dependency tracking.
Flg Arg Option-Name Description
-M opt make-dep emit make dependency file
- may not be preset
- may appear multiple times
-C no core Leave a core dump on a failure exit
version and help options:
Flg Arg Option-Name Description
-v opt version Output version information and exit
-? no help Display extended usage information and exit
-! no more-help Extended usage information passed thru pager
-u no usage Abbreviated usage to stdout
-> opt save-opts Save the option state to a config file
-< Str load-opts Load options from a config file
- disabled as --no-load-opts
- may appear multiple times
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
AutoGen creates text files from templates using external definitions.
The following option preset mechanisms are supported:
- reading file $HOME
- reading file ./.autogenrc
- examining environment variables named AUTOGEN_*
The valid "trace" option keywords are:
nothing debug-message server-shell templates block-macros
expressions everything
or an integer from 0 through 6
AutoGen is a tool designed for generating program files that contain
repetitive text with varied substitutions.
Packaged by Bruce (2011-03-07)
Report autogen bugs to bkorb@gnu.org
|