


      GUTIL(1)                    (UNIX 5.2)                   GUTIL(1)



      NAME
           gutil - graphical utilities

      SYNTAX
           command-name [options] [files]

      DESCRIPTION
           Below is a list of miscellaneous device independent utility
           commands found in /usr/bin/graf.  If no files are given,
           input is from the standard input.  All output is to the
           standard output.  Graphical data is stored in GPS format;
           see gps(4).


           bel        - send bel character to terminal

           cvrtopt   [=sstring fstring istring tstring]  [args]  -
                     options converter
                     Cvrtopt reformats args (usually the command line
                     arguments of a calling shell procedure) to
                     facilitate processing by shell procedures.  An arg
                     is either a file name (a string not beginning with
                     a -, or a - by itself) or an option string (a
                     string of options beginning with a -).  Output is
                     of the form:
                               -option -option . . . file name(s)
                     All options appear singularly and preceding any
                     file names.  Options that take values (e.g.,
                     -r1.1) or are two-letters long must be described
                     through options to cvrtopt.

                     Cvrtopt is usually used with set in the following
                     manner as the first line of a shell procedure:
                               set - `cvrtopt =[options] $@`
                     Options to cvrtopt are:

                     sstring   String accepts string values.

                     fstring   String accepts floating point numbers as
                               values.

                     istring   String accepts integers as values.

                     tstring   String is a two-letter option name that
                               takes no value.

                     String is a one- or two-letter option name.

           gd        [GPS files ]  - GPS dump
                     Gd prints a human readable listing of GPS.

           gtop      [-rnu ]  [GPS files ]  - GPS to plot(4) filter



      Page 1                                          (73 A2 02MT REV1)






      GUTIL(1)                    (UNIX 5.2)                   GUTIL(1)



                     Gtop transforms a GPS into plot(4) commands
                     displayable by plot filters.  Unless an option is
                     given, GPS objects are translated if they fall
                     within the window that circumscribes the first
                     file.
                     Options:

                     rn        translate objects in GPS region n.

                     u         translate all objects in the GPS
                               universe.

           pd        [ plot(5) files ]  - plot(4) dump
                     Pd prints a human readable listing of plot(4)
                     format graphical commands.

           ptog      [ plot(5) files ]  - plot(4) to GPS filter
                     Ptog transforms plot(4) commands into a GPS.

           quit       - terminate session

           remcom    [ files ]  - remove comments
                     Remcom copies its input to its output with
                     comments removed.  Comments are as defined in C
                     (i.e., /* comment */).

           whatis    [-o ]  [ names ]  - brief on-line documentation
                     Whatis prints a brief description of each name
                     given.  If no name is given, then the current list
                     of description names is printed.  The command
                     whatis \* prints out every description.
                     Option:

                     o         just print command options

           yoo       file - pipe fitting
                     Yoo is a piping primitive that deposits the output
                     of a pipeline into a file used in the pipeline.
                     Without yoo, this operation is usually not
                     successful, as it causes a read and write on the
                     same file simultaneously.

      SEE ALSO
           graphics(1).
           gps(4), plot(4) in the ROS Reference Manual.










      Page 2                                          (73 A2 02MT REV1)



