AutoGen: 5.1 autogen usage help (-?)

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

## 5.1 autogen usage help (-?)

This is the automatically generated usage text for autogen:

    autogen - The Automated Program Generator - Ver. 5.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
                                      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

    version and help 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 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 /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:  autogen-users@lists.sf.net

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

This document was generated by Bruce Korb on April, 24 2005 using texi2html 1.76.