| | getdefs - AutoGen Definition Extraction Tool - Ver. 1.3
USAGE: getdefs { <option-name>[{=| }<val>] }...
Arg Option-Name Req? Description
YES defs-to-get opt Regexp to look for after the "/*="
opt ordering opt Alphabetize or use named file
- disabled as --no-ordering
- enabled by default
Num first-index opt The first index to apply to groups
YES input YES Input file to search for defs
- may appear multiple times
- default option for unnamed options
YES subblock opt subblock definition names
- may appear multiple times
YES listattr opt attribute with list of values
- may appear multiple times
opt filelist opt Insert source file names into defs
Definition insertion options
Arg Option-Name Req? Description
YES assign opt Global assignments
- may appear multiple times
YES common-assign opt Assignments common to all blocks
- may appear multiple times
YES copy opt File(s) to copy into definitions
- may appear multiple times
opt srcfile opt Insert source file name into each def
opt linenum opt Insert source line number into each def
Definition output disposition options:
Arg Option-Name Req? Description
YES output opt Output file to open
- an alternate for autogen
opt autogen opt Invoke AutoGen with defs
- disabled as --no-autogen
- enabled by default
YES template opt Template Name
YES agarg opt AutoGen Argument
- prohibits these options:
output
- may appear multiple times
YES base-name opt Base name for output file(s)
- prohibits these options:
output
Auto-supported Options:
Arg Option-Name Req? Description
opt version opt Output version information and exit
no help opt Display usage information and exit
no more-help opt Extended usage information passed thru pager
opt save-opts opt Save the option state to an rc file
YES load-opts opt Load options from an rc file
- disabled as --no-load-opts
- may appear multiple times
All arguments are named options.
The following option preset mechanisms are supported:
- reading file /dev/null/.getdefsrc
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.
|