USAGE:


      ppp [<input_file> (or stdin)] [-h (help)] > sourcefragment


PURPOSE:

Create C-source fragment for reading a set of command line parameter values. Initial default values can be specified, these can be overwritten with values from a initialization file. Additionally, automatic help options (.-h for description of options, -H for list of current values) will be provided.

REQUIRES:

Program using generated source fragment must know the routines skip_comments and ascanf (link with libnst or use skip_comments-routine from the source code below).

FORMAT OF INPUT FILE:

Consists of a number of lines of the format

     OptName VarName{InitialValue} # optional comment

For each such line, the first token OptName specifies the name of the option. The second token VarName is assumed to be the name of an associated C-variable intended to hold the value of an argument parameter following the option on the command line. VarName must start with one of the letters 'b' (binary integer), 'i' (integer), 'c' (char) 'f' (float), 't' (text string). The next letter must be a capital letter. The variable name may be optionally preceded (without intervening white space) by the character '>'. The presence of this character indicates that the first argument after the flag must follow without intervening space. The variable name may be followed (no interrupting white space!) by an optional initial value that must be enclosed in curly braces (text strings must be enclosed in apostrophes). After that, an optional comment (starting with a '#' - char) may follow. The comment may use multiple lines (each continuation line starting with a '#'). Any backslash in a comment is interpreted as a line break for the comment text. The specified comment text and the type info from the first letter of VarName will be used to automatically create a help text for an automatically created -h - option. Another automatically created -H - option will display the values of the argument parameters.

SEE ALSO:

mkopt, dpp

FILE

/local/homes/rhaschke/nst7/man/../o.linx86//../nstsrc/ppp.c