.\" man page for gg
.ds PS P\s-2OST\s+2S\s-2CRIPT\s+2
.\" typeset examples in fixed size font as indented paragraph
.de Ex
.sp
.RS
.nf
.ft C
..
.de Xe
.RE
.sp
.fi
..
.TH GG 1 "13 August 1992" 
.SH NAME
gg \- produce GRIP graph from GRIP raw statistics file 
.SH SYNOPSIS
.B gg
[ args ] [file1] [file2]
.SH DESCRIPTION
The program
.B gg
produces GRIP graphs from raw statistics generated by the GRIP machine. 
If no files are specified the program acts as a filter reading
from stdin and output to stdout. If one file name is given then
that is taken to be the name of the input file and output is placed 
in a file of the same name with a ".ps" extension. If two 
file names are given the first is the input file,
the second is the output file.
Unless specified otherwise a Full size landscape graph
of Activity is produced. The default ordering of activity graphs is GC, Reduction,Idle,Flush.
.SH OPTIONS
The args are:
.IP "\fB\-E\fP\fIint\fPx\fIint\fP"
Generate encapsulated \*(PS suitable for inclusion in LaTeX documents.
The output produced is in portrait mode, and by default half A4 size.
The two integer arguments are supplied, these are taken to be
the required width and height (in centimetres) 
of the output respectively.
The resulting \*(PS file conforms to the  
.I "Encapsulated Post Script"
(EPS) convention, and it can be included in a LaTeX document using Rokicki's 
dvi-to-\*(PS converter
.B dvips.
.IP "\fB\-F\fP "
Display output in full A4 landscape mode.
.IP "\fB\-G\fP "
Display output in landscape mode for gs previewer.
.IP "\fB\-A\fP[\fI{specifiers}\fP]"
Produce a graph of processor activity. This is the default. It is possible
to select the aspects of activity required and the order in which these are stacked.
This is done by specifying a list of \fIspecifiers\fP. A specifier
is one of
.B G 
for Garbage Collection,
.B R
for Reduction,
.B I
for Idle and
.B F
for Flushing. If no list is given the default 
.B [G,R,I,F] is used.
.IP "\fB\-S\fP[\fI{specifiers}\fP]"
Produce a graph of sparks. Again, it is possible
to select the different kinds of recorded sparks displayed and the order in which these are stacked.
This is done by specifying a list of \fIspecifiers\fP. A specifier
is one of
.B C 
for Created sparks Collection,
.B U
for Used sparks,
.B R
for Resumed sparks and
.B L
for Lost sparks. If no list is given the default 
.B [R,U,C,L] is used.
.IP "\fB\-P\fP "
Produces a Spark pool profile. This profiles the residency of sparks in the
sparks pool. It also indicates where sparks are used (as a opposed to lost).
.IP "\fB\-p\fP[\fI{penames}\fP]"
Flag restricts gathering of statistics to those processing elements
indicated in the list.
At the bottom of a graph the current configuration of processing elements
is shown. Those whose statistics are incorporated in the graph are
displayed in bold type. The manager processor element is never 
included as part of the graphs statistics. It is displayed in the
configuration in italics.
The program will exit if an incorrect processor is specified.
If no processors are specified, all processors are plotted.

.SH "SEE ALSO"
dvips(1), latex(1)
.SH NOTES
\*(PS is a registered trademark of Adobe Systems Incorporated.
.SH AUTHOR
Iain Checkland, University of York.