NAME
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 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.
OPTIONS
- -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.
- -L <lines>
- limit lenght of output page to maximum <lines>
lines.
SPECIAL-CASE OPTIONS
- -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.
- -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.
- -p <pad>
- specifies a minimum number of bytes that each output line must
be padded to. Padding is done with 0-bits before the EOL code.
- -R
- suppress output of end-of-page code (RTC).
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
--
BUGS
Hopefully none :-).
SEE ALSO
g32pbm(1),
sendfax(8),
faxspool(1)
AUTHORS
g3cat is Copyright (C) 1993 by Gert Doering,
<gert@greenie.muc.de>