8.5.1 getdefs usage help

This is the automatically generated usage text for getdefs:

@exampleindent 0

getdefs - AutoGen Definition Extraction Tool - Ver. 1.4 USAGE: getdefs [ <option-name>[{=| }<val>] ]... Arg Option-Name Description Str defs-to-get Regexp to look for after the "/*=" opt ordering Alphabetize or use named file - disabled as --no-ordering - enabled by default Num first-index The first index to apply to groups Str input Input file to search for defs - may appear multiple times - default option for unnamed options Str subblock subblock definition names - may appear multiple times Str listattr attribute with list of values - may appear multiple times opt filelist Insert source file names into defs Definition insertion options Arg Option-Name Description Str assign Global assignments - may appear multiple times Str common-assign Assignments common to all blocks - may appear multiple times Str copy File(s) to copy into definitions - may appear multiple times opt srcfile Insert source file name into each def opt linenum Insert source line number into each def Definition output disposition options: Arg Option-Name Description Str output Output file to open - an alternate for autogen opt autogen Invoke AutoGen with defs - disabled as --no-autogen - enabled by default Str template Template Name Str agarg AutoGen Argument - prohibits these options: output - may appear multiple times Str base-name Base name for output file(s) - prohibits these options: output Auto-supported Options: Arg Option-Name Description 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 All arguments are named options. If no ``input'' argument is provided or is set to simply "-", and if ``stdin'' is not a ``tty'', then the list of input files will be read from ``stdin''. The following option preset mechanisms are supported: - reading file /dev/null This program extracts AutoGen definitions from a list of source files. Definitions are delimited by `/*=<entry-type> <entry-name>\n' and `=*/\n'. From that, this program creates a definition of the following form: #line nnn "source-file-name" entry_type = { name = entry_name; ... }; The ellipsis '...' is filled in by text found between the two delimiters, with everything up through the first sequence of asterisks deleted on every line. There are two special ``entry types'': * The entry_type enclosure and the name entry will be omitted and the ellipsis will become top-level definitions. -- The contents of the comment must be a single getdefs option. The option name must follow the double hyphen and its argument will be everything following the name. This is intended for use with the ``subblock'' and ``listattr'' options. please send bug reports to: [email protected]

@exampleindent 4