g3cat(1)

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  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
       --

BUGS
       Hopefully none :-).

SEE ALSO
       g32pbm(1) sendfax(8) faxspool(1) 

AUTHORS
       g3cat  is  Copyright (C) 1993 by Gert Doering, <gert@gree-
       nie.muc.de>