gutil(1) CLIX gutil(1)
NAME
gutil - A set of graphical utilities
SYNOPSIS
command [flag ... ] [file ... ]
FLAGS
rn Translate objects in GPS region n.
u Translate all objects in the GPS universe.
DESCRIPTION
The gutil commands are a set of independent utility commands found in
/usr/bin/graf. If no files are given, input is from stdin. All output is
to stdout. Graphical data is stored in GPS format; see gps.
bel Sends bell character (\007) to terminal
cvrtopt [= sstring fstring istring tstring] [arg ... ] - flags converter
The cvrtopt command reformats args (usually the command line
arguments of a calling shell procedure) to facilitate processing
by shell procedures. An arg is either a filename (a string not
beginning with a -, or a - by itself) or a flag string (a string
of flags beginning with a -). Output is of the form:
-flag ... filename ...
All flags appear singularly and precede any filenames. Flags
that take values (for example, -r1.1) or are two letters long
must be described through flags to cvrtopt.
The cvrtopt command is usually used with set in the following
manner as the first line of a shell procedure:
set - `cvrtopt =option ... $@`
Options to cvrtopt are:
sstring Accept string values.
fstring Accept floating-point numbers as values.
istring Accept integers as values.
tstring A two-letter flag name that takes no value.
2/94 - Intergraph Corporation 1
gutil(1) CLIX gutil(1)
The string argument is a one- or two-letter flag name.
gd [file ... ] - GPS dump
The gd command displays a human readable listing of GPS.
gtop [-rn] [-u] [file ... ] - GPS to plot filter
The gtop command transforms a GPS into plot commands displayable
by plot filters. GPS objects are translated if they fall within
the window that circumscribes the first file unless a flag is
given.
pd [plot file ... ] - plot dump
The pd command displays a human readable listing of plot format
graphical commands.
ptog [plot file ... ] - plot to GPS filter
The ptog command transforms plot commands into a GPS.
quit Terminate session
remcom [file ... ] - remove comments
The remcom command copies its input to its output with comments
removed. Comments are as defined in C (that is, /* comment */).
whatis [-o] [name ... ] - Brief online documentation
The whatis command displays a brief description of each name
given. If no name is given, then the current list of description
names is displayed. The command whatis \* displays every
description.
Flag:
-o Just display command options
yoo file - pipe fitting
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 as it causes a read and write
on the same file simultaneously.
EXAMPLES
1. To display a human readable form of the GPS file /tmp/gpsinfo.out:
2 Intergraph Corporation - 2/94
gutil(1) CLIX gutil(1)
gd /tmp/gpsinfo.out
2. To translate the GPS file /tmp/gpsinfo.out into plot commands:
gtop /tmp/gpsinfo.out
3. To remove comments from the file foo.c:
remcom foo.c
4. To display a description of the ls command:
whatis ls
EXIT VALUES
These commands return 0 on success. Otherwise a value of 1 is returned.
DIAGNOSTICS
illegal format code: char
Illegal format code
cannot open filename
The specified file does not exist or has incorrect permissions
input not GPS
The file does not contain GPS information
missing */ assumed
File ended with a mismatched ``/* ... */'' sequence
don't know what word is
Does not know the specified command
RELATED INFORMATION
Commands: graphics(1)
Files: gps(4), plot(4)
2/94 - Intergraph Corporation 3