5.1 autogen usage help (-?)

This is the automatically generated usage text for autogen:

@exampleindent 0

autogen - The Automated Program Generator - Ver. 5.5.4 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 callout 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 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 it must lie in one of the ranges: -1 exactly, or 1 to 16777216 -t Num timeout Time limit for servers it must lie in the range: 0 to 3600 KWd trace tracing level of detail Str trace-out tracing output file or filter 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 Auto-supported Options: Flg Arg Option-Name Description -v opt version Output version information and exit -? no help Display usage information and exit -! no more-help Extended usage information passed thru pager -> opt save-opts Save the option state to an rc file -< Str load-opts Load options from an rc 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 /dev/null - reading file ./.autogenrc - examining environment variables named AUTOGEN_* The valid trace option keywords are: nothing templates block-macros expressions everything The definitions file (`<def-file>') can be specified with the `definitions' option or as the command argument, but not both. Omitting it or specifying `-' will result in reading definitions from standard input. The output file names are based on the template, but generally use the base name of the definition file. If standard in is read for the definitions, then `stdin' will be used for that base name. The suffixes to the base name are gotten from the template. However, the template file may specify the entire output file name. The generated files are always created in the current directory. If you need to place output in an alternate directory, `cd' to that directory and use the `--templ_dirs' option to search the original directory. `loop-limit' is used in debugging to stop runaway expansions. please send bug reports to: [email protected]

@exampleindent 4