.TH GRI_MERGE "1" "2009" "gri_merge "
.SH NAME
gri_merge \- merge multiple Gri output files into a single PostScript file.
.SH "USAGE (style 1):"
.IP
gri_merge [OPTIONS] CxR a.ps b.ps ... > merged_file.ps
.PP
Merges the files onto one page, in 'C' columns and 'R' rows.  The CxR files
are given in the order of words on a page.  The page is presumed to be
8.5x11in in size, as are all the input files, and the input files are sized
to fit, and kept in natural scale.
.SH "USAGE (style 2):"
.IP
gri_merge [OPTIONS] xcm ycm enlarge a.ps [b.ps ...] > merged_file.ps
.PP
Where `enlarge' is a scale factor applied after offsetting `xcm' to
the right and `ycm' upward.
.SS "EXAMPLE (style 2):"
.IP
The following
.TP
gri_merge 2 12 .5 a.ps \e
.IP
12 12 .5 b.ps \e
.IP
2 2 .5 c.ps \e
.IP
12 2 .5 d.ps > all.ps
.PP
produces 4 panels from gri plots done using margins and sizes
as specified in the following lines in a gri commandfile
.IP
set x margin 2

set x size 15

set y margin 2

set y size 15
.PP
The OPTIONS, available if your 'perl' has 'getopts' library, are:
.HP
\fB\-u\fR graylevel \fB\-\-\fR set graylevel for underlay beneath panels, by default 0.75.
.IP
Values range from 0 (black) to 1 (white), although a value
of precisely 1 means do NOT draw underlay.
.HP
\fB\-b\fR graylevel \fB\-\-\fR Set value for background under individual panels, again 0
.IP
for black to 1 for white, with 1 meaning no drawing.
.TP
\fB\-h\fR
\fB\-\-\fR Print this help message and quit.

.SH "SEE ALSO"
.B
gri(1), gri_unpage(1)
