1g3cat(1)                     mgetty+sendfax manual                    g3cat(1)
2
3
4

NAME

6       g3cat - concatenate multiple g3 documents
7

SYNOPSIS

9       g3cat [-l] [-a] g3-file1 ...
10

DESCRIPTION

12       g3cat  concatenates  g3 files. These can either be 'raw', that is, bit‐
13       maps packed according to the CCITT  T.4  standard  for  one-dimensional
14       bitmap encoding, or 'digifax' files, created by GNU's GhostScript pack‐
15       age with the digifax drivers. Its output is a concatenation of all  the
16       input files, in raw G3 format, with two white lines in between.
17
18       If a - is given as input file, stdin is used.
19
20       If the input data is malformed, a warning is printed to stderr, and the
21       output file will have a blank line at this place.
22
23

OPTIONS

25       -l     separate files with a one-pixel wide black line.
26
27       -h <blank lines>
28              specifies the number of blank lines g3cat should prepend to each
29              page. Default is 0.
30
31       -L <lines>
32              limit length of output page to maximum <lines> lines.
33

SPECIAL-CASE OPTIONS

35       -w <width>
36              specifies  the desired page width in pixels per line. Default is
37              1728 PELs, and this is mandatory if you want to send the fax  to
38              a standard fax machine.  If one of the input files doesn't match
39              this line width (for example because it was created by a  broken
40              G3  creator), a warning is printed, and the line width is trans‐
41              parently fixed.
42
43       -a     byte-align the end-of-line codes (EOL) in the  file.  Every  EOL
44              will end at a byte boundary, that is, with a  01 byte.
45
46       -p <pad>
47              specifies  a  minimum number of bytes that each output line must
48              be padded to.  Padding is done with 0-bits before the EOL code.
49
50       -R     suppress output of end-of-page code (RTC).
51
52

Example

54       The following example will put a  header  line  on  a  given  g3  page,
55       'page1' and put the result into 'page2':
56
57       echo '$header' | pbmtext | pbm2g3 | g3cat - page1 >page2
58
59

FILES

61       --
62
63

BUGS

65       Hopefully none :-).
66
67

SEE ALSO

69       g32pbm(1), sendfax(8), faxspool(1)
70
71

AUTHORS

73       g3cat is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>
74
75
76
77greenie                            27 Oct 93                          g3cat(1)