 genpdt(1)

NAME
generate_pdt, genpdt

SYNOPSIS
genpdt [ -? -i -o -q]

DESCRIPTION
Interprets a PDT declaration and generates C statements that
declare and initialize a PDT.  The command line    parser routine
evaluate_parameters uses the PDT to scan a command line for parameters and to display help information about the command.
  Examples:
    genpdt -i pdt_in -o pdt_out
    genpdt <pdt_in >pdt_out In the last example note that since the genpdt input and output files default to stdin and stdout, respectively, normal I/O redirection can be used.

OPTIONS
-help, ?, usage_help, full_help: Display Command Information

  Display information about this command, which includes
  a command description with examples, plus a synopsis of
  the command line parameters. If you specify -full_help
  rather than -help complete parameter help is displayed
  if it's available.

-input, i: file = stdin

  Specifies the name of the input file containing a
  command's Parameter Description Table. The PDT describes
  the names, aliases, types and default values of all the
  command's command line parameters, as well as the path
  name of the ar message module archive file containing
  help text for the command and its parameters.

-output, o: file = stdout

  Specifies the name of the generate_pdt output file. This
  file contains C language statements that are typically
  included in the source of your C application. You then
  call the procedure evaluate_parameters, passing the PDT
  and the user's command line string; the command line is
  parsed and the results of the evaluation stored in the
  PDT.

-qualifier, q: string = ""

  Specifies a qualifying string that uniquely identifies
  this PDT. By default the C statements created by
  generate_pdt define the symbols pdt and pvt to be used
  by your application, which point to the results of the
  evaluation of the user's command line input. Some C
  applications support 'multiple entry points'; that is,
  the same C module acts as more than one user program.
  And typically these 'multiple programs' accept different
  command line arguments. So, there is a requirement that
  multiple instances of the pdt/pvt symbols be defined.

  Another reason to qualify the pdt/pvt symbols is when
  embedding evaluate_parameters into an application. Each
  application command processor requires its own instance
  of these variables to keep parameter names and values
  distinct.

  The value of the qualifier parameter is thus prepended
  to the names pdt/pvt, as well as the `P_' ordinals that
  index into the pvt. Therefore if -quailier = "OQ_" the
  symbols OQ_pdt and OQ_pvt would be defined.

AUTHOR
Stephen O. Lidie, lusol@Lehigh.EDU Copyright (C) 1990 - 1994 by Stephen O. Lidie and Lehigh University. All rights reserved.

SEE ALSO
evap(2)
evap.c(2)
evap.pl(2)
evap.tcl(2)
evap_pac(2)
addmm,add_message_modules(1)
disci,display_command_information(1)
genmp,generate_man_page(1)
genpdt,generate_pdt(1)
gentkp,generate_tk_program(1)