g3cat(1) mgetty+sendfax manual g3cat(1)
g3cat - concatenate multiple g3 documents
g3cat [-l] [-a] g3-file1 ...
g3cat concatenates g3 files. These can either be 'raw', that is, bitmaps packed according
to the CCITT T.4 standard for one-dimensional bitmap encoding, or 'digifax' files, created
by GNU's GhostScript package with the digifax 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.
-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
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
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
Hopefully none :-).
g32pbm(1), sendfax(8), faxspool(1)
g3cat is Copyright (C) 1993 by Gert Doering, <email@example.com>
greenie 27 Oct 93 g3cat(1)