Mike Borella <mike@borella.net>

NOTE: the documentation is slightly out of date...

------------------------------------------------------------------------------

DESCRIPTION

Genparse is a generic command line parser generator.  From simple and
concise specification file, you can define the command line parameters
and switches that you would like to be able to pass to your program.
Genparse creates the C or C++ code of the parser for you, which you can then
compile as a separate file and link with your program.

Genparse is documented completely in the accompanying texinfo file.
Standard installation will set this file up for you.  Alternatively,
you can dump the texinfo to postscript or PDF.

-------------------------------------------------------------------------------

OPERATION

usage: genparse [ -dcoflphqv ]  <file>
  [ -d ]  Turns on logging. 
  [ -c ]  [ --cppext ]  C++ file extension. (default = cc)
  [ -o ]  [ --outfile ]  Output file name. (default = parse_cl)
  [ -f ]  [ --logfile ]  Log file name. (default = genparse.log)
  [ -l ]  [ --language ]  Output language. (default = c)
  [ -p ]  [ --parsefunc ]  Name of parsing function / class. 
                           (default = Cmdline)
  [ -h ]  [ --help ]  Display help information. (default = 0)
  [ -v ]  [ --version ]  Output version. (default = 0)

-------------------------------------------------------------------------------

COMMENTS

I wrote genparse because I got tired of writing a new command line
parser for every little utility I made.  Most of these parsers are
very similar, so it seemed as if a great deal of the functionality
required by most programs could be automatically generated.  So far,
genparse has saved me a lot of time.  In fact, I used genparse to
create the command-line parser for itself! However, I imagine that it
may not be powerful enough for large applications with complex sets of
parameters.


Please send me all comments, feedback, and bug reports.
