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