Ausam/doc/man/man1/plot.1

Find at most related files.
including files from this version of Unix.

.tr ~
.th PLOT I 1/1/1979
.sh NAME
plot \*- graph a file
.sh SYNOPSIS
.bd plot
[-[p][s][b][c][w][n]] file...
.sh DESCRIPTION
.bd Plot
reads the given data files and produces a scaled
labelled graph
suitable for displaying on a Tektronix terminal or plotter.
.br
The files in the argument list may optionally
contain scaling and formatting intructions (see "PLOT: a user's guide").
If no files are given
.bd plot
will read from standard input, and hence may be used as a filter.
.s2
.ti +4
Flags that may be used with
.bd plot
are:
.s2
.lp +6 5
-w	Suppress the output of warnings from the program.
Fatal errors cannot be suppressed.
.s2
.lp +6 5
-c	Perform a syntax check on the input.
.bd Plot
will look for errors without producing graphics, hence this
check may be performed on any terminal.
.s2
.lp +6 5
-p	Send the output directly to the hard copy plotter.
If the plotter is a tektronix, then the "prompt light"
will glow and the "call button" will have to be pressed
once to commence plotting.
.s2
.lp +6 5
-s	Used in conjunction with the -p option, this flag
will cause the hard copy plotter to pause at every stage
of the plot, so that pen colour changes may take place.
Plotting is resumed by pressing the call button.
.s2
.lp +6 5
-n	This flag is used if the file does not contain
any plotting instructions, ie only data is present.
Normally however the program looks for and expects at least
some intructions on what it should do.
.s2
.lp +6 5
-b	The numbers on the axes will be suppressed but the
tick marks and axes themselves will still be drawn.
Thus the numbers on the axes may be manually added later or
replaced with other symbols (~eg JAN FEB MAR etc~).
.i0
.dt
.sh "SEE ALSO"
"PLOT: a user's guide"
.sh DIAGNOSTICS
Error messages are self-explanatory and occur when a file cannot be opened,
or when the plot specifications are syntactically incorrect.
.br
Warnings occur when
.bd plot
discovers garbage in the data file.
.sh AUTHOR
Richard Grevis (UNSW)
.sh BUGS
They will surface as use of the program increases.