g3cat - concatenate multiple g3 documents
SYNOPSIS
g3cat [-l] [-a] g3-file1 ...
DESCRIPTION
g3cat concatenates g3 files. These can either be 'raw',
that is, bitmaps packed according to the CCITT T.4 stan
dard for one-dimensional bitmap encoding, or 'digifax'
files, created by GNU's GhostScript package with the digi
fax drivers. Its output is a concatenation of all the
input files, in raw G3 format, with two white lines in
between.
If a - is given as input file, stdin is used.
If the input data is malformed, a warning is printed to
stderr, and the output file will have a blank line at this
place.
OPTIONS
-a byte-align the end-of-line codes (EOL) in the file.
Every EOL will end at a byte boundary, that is,
with a 01 byte.
-l separate files with a one-pixel wide black line.
-h <blank lines>
specifies the number of blank lines g3cat should
prepend to each page. Default is 0.
-w <width>
specifies the desired page width in pixels per
line. Default is 1728 PELs, and this is mandatory
if you want to send the fax to a standard fax
machine. If one of the input files doesn't match
this line width (for example because it was created
by a broken G3 creator), a warning is printed, and
the line width is transparently fixed.
Example
The following example will put a header line on a given g3
page, 'page1' and put the result into 'page2':
echo '$header' | pbmtext | pbm2g3 | g3cat - page1 >page2
FILES
--
Hopefully none :-).
SEE ALSO
g32pbm(1), sendfax(8), faxspool(1)
AUTHORS
g3cat is Copyright (C) 1993 by Gert Doering, <gert@gree
nie.muc.de>
Man(1) output converted with
man2html