mgetty+sendfax manual: g3cat.man
Table of Contents

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

-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

greenie 27 Oct 93 1

BUGS

Hopefully none :-).

SEE ALSO

g32pbm(1), sendfax(8), faxspool(1)

AUTHORS

g3cat is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>

greenie 27 Oct 93 2

Table of Contents