gutil

PURPOSE

     Provides graphical utility programs.

SYNOPSIS
     bel

     cvrtopt [ [ =sfit [ string ] ] ] [ args ]

     gd [ file ] ...

     gtop [ [ -u -r [ num ] ] ] file ...

     pd [ file ] ...

     ptog [ file ] ...

     quit

     remcom [ file ] ...

     whatis [ -o ] [ name ] ...

     yoo file

                              OL777039

                                                      OL777039

DESCRIPTION

     The  following are  the miscellaneous  device-independent
     utility  commands found  in the  /usr/bin/graf directory.
     If  you do  not specify  any files,  these commands  read
     standard input.   All output is sent  to standard output.
     Graphical data is stored in  GPS format; see the gps file
     in AIX Operating System Technical Reference.

       bel

     Sends the ASCII BEL character to the terminal.

       cvrtopt

     The cvrtopt command reformats  its arguments (usually the
     command line  arguments of a calling  shell procedure) to
     facilitate  processing by  shell procedures.   An arg  is
     either a  file name  or a  flag string.   A file  name is
     either a  - (minus) by  itself or a string  not beginning
     with a -.   A flag string is a string  of flags beginning
     with a  - (minus).  cvrtopt  produces output of  the fol-
     lowing form:

     -flag  -flag . . .   file . . .

     All flags appear singularly in the output and precede any
     file  names.   Arguments  that  take values  or  are  two
     letters long must be described through flags to cvrtopt.

     The cvrtopt command is usually  used with the set command
     as the  first line of a  shell procedure (see page  for a
     description of the set command):

       set  -  `cvrtopt  [=flags] . . .   $@`

     FLAGS

     sstring  The  specified  string  accepts  string  values,
              where string is a one or two letter flag name.
     fstring  The  specified  string  accepts  floating  point
              numbers as values, where string  is a one or two
              letter flag name.
     istring  The specified string accepts integers as values,
              where string is a one or two letter flag name.
     tstring  The specified  string is a two  letter flag name
              that takes no value.

       gd

     The gd command  produces a readable listing of  a file in
     GPS format.

       gtop

     The gtop command  transforms a GPS format  into plot file
     commands displayable  by plot  filters.  GPS  objects are
     translated if  they fall  within the window  that circum-
     scribes the  first file, unless  specify one of  the fol-
     lowing flags:

     FLAGS

     rnum    Translates objects in GPS region num.
     u       Translates all objects in the GPS universe.

       pd

     The pd command displays a readable listing of plot format
     graphical commands.

       ptog

     The ptog command transforms plot file commands into a GPS
     file.

       quit

     The quit command terminates the session.

       remcom

     The remcom  command copies its  input to its  output with
     comments removed.  Comments are as  defined in the C lan-
     guage (/* comment */).

       whatis

     The whatis  command displays a short  description of each
     name  specified.  If  you  do not  specify  a name,  then
     whatis displays  the current  list of  description names.
     The command "whatis \*" displays every description.

     FLAG

     -o Displays only command flags.

       yoo

     The yoo command  is a piping primitive  that deposits the
     output of  a pipeline into  a file used in  the pipeline.
     Note  that without  yoo, this  is not  usually successful
     because  it causes  a read  and  write on  the same  file
     simultaneously.

RELATED INFORMATION

     The following command: "graphics."

     The gps  format in AIX Operating  System Technical Refer-
     ence.