[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

9.5.1 getdefs usage help

This is the automatically generated usage text for getdefs:

@exampleindent 0
 
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.
@exampleindent 4


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated by Bruce Korb on February, 4 2002 using texi2html