 genptkp(1)

NAME
generate_tk_program, genptkp

SYNOPSIS
gentkp -c [ -? -o]

DESCRIPTION
Generates a Tcl/Tk program to create an X11 R5 Motif GUI
wrapper    around any program using evaluate_parameters as
its command line interface. Interprets the command's -full_help output and builds the necessary windows and widgets. The resulting application
can capture its    standard output in a window; the output can
be saved to a file or directed to a pipeline. Complete help is also provided. General capabilities:
 . Command line parameters are specified via a form. Most
   are Entry widgets, except for parameters of type key,
   switch and boolean which are Radiobutton widgets.
 . For 'list of' command line parameters we make these
   widget distinctions: key parameters use Checkbuttons
   and other types use Entry widgets with multiple items.
 . Complete command and parameter help (from the
   evaluate_parameters Message Module) displayed in a
   scrollable Text widget.
 . A scrollable Entry widget dynamically displays the
   command to be executed.
 . After execution the command's standard output is captured
   in a separate Toplevel window. This window can be saved
   to file or directed to a command pipeline.
 . Parameters are labelled with Button widgets rather than
   Label widgets so clicking on a command line parameter
   Button positions the help window automatically to the
   help text for that parameter. The scrollable Entry
   widget is also repositioned to show the specified
   parameter.
 . Important items that should be highlighted for the user
   to see are displayed in a configurable background color
   using the X11 resource name `name.highlight : color'.
 . An Undo selection to reset all command line parameters to
   their original values.
 . Usage help explaining the characteristics of applications
   generated by generate_tk_program, and details of
   evaluate_parameters.
 . The generated program dynamically determines if your Tk
   has the AddInput extension, and uses non-blocking reads
   of standard output so that the command can be cancelled.
   Without AddInput, the application will hang if the Unix
   program never completes.
  Examples:
    gentkp -c op -o xop
    genpdt -c op > xop In the last example note that since the gentkp output
file defaults to stdout    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.

-command, c: application = $required

  Specifies the name of the command - the command MUST
  use evaluate_parameters as its user interface.

-output, o: file = stdout

  Specifies the name of the generate_tk_program output file.

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)