COLPRO(1,C)                 AIX Commands Reference                  COLPRO(1,C)



-------------------------------------------------------------------------------
colpro



PURPOSE

Column filter for IBM 4201 Proprinter.

SYNTAX


                         +--------+
/usr/lib/ibmlp/colpro ---| +----+ |---|
                         +-| -b |-+
                          ^| -f ||
                          || -h ||
                          |+----+|
                          +------+


Note:  This command does not have MBCS support.

DESCRIPTION

The colpro command reads the standard input and writes the standard output.  It
performs the line overlays implied by reverse line feeds (Esc-7 in ASCII) and
by forward and reverse half line feeds (Esc-9 and Esc-8).  colpro is
particularly useful for filtering multiple-column output made with the nroff.rt
command of nroff and output resulting from use of the tbl preprocessor.  colpro
is intended for use with prfl.

Although colpro accepts half line motions in its input, it normally does not
emit them on output.  Instead, text appearing between lines is moved to the
next lower full line boundary.  This treatment can be suppressed by the -f
(fine) option.  In this case the output from colpro may contain forward half
line feeds Esc-9, but will still never contain either kind of reverse line
motion.

If the -b option is given, colpro assumes the output device in use is not
capable of backspacing.  In this case, if several characters are to appear in
the same place, only the last one read will be taken.

The colpro command may also be used with the IBM 5152 Graphics Printer.  Even
though the graphics printer cannot back up, the -b option should not be used
since backspaces tell the post filter to use underlining.

Esc sequences are treated according to one of three rules:

  1. Esc-7, Esc-8, and Esc-9 are line positioning commands and are treated as
    above.




Processed November 8, 1990        COLPRO(1,C)                                 1

COLPRO(1,C)                 AIX Commands Reference                  COLPRO(1,C)



  2. Esc-Ax sequences are assumed to be printer control sequences (initialize
    printer, start bold, stop bold, etc.).  These are echoed to standard output
    and are treated as if they have "0" width.

  3. All other Esc sequences are assumed to be 3 characters long (for example
    Esc c1 c2), and are echoed to standard output as is (even if one of the
    characters is a control character).  The filter assumes the three-character
    escape sequence specifies a single printable character.

If the -h option is given, colpro converts white space to tabs to shorten
printing time.

No control characters are passed to the output except space, backspace, tab,
return, newline, Esc (033) followed by any 2 characters (except 7, 8, or 9) and
VT (013).  This last character is an alternate form of full reverse line feed,
for compatibility with some other hardware conventions.  All other non-printing
characters are ignored.

The colpro command is provided primarily for use by proff.

RELATED INFORMATION

See the following commands:  "col,"  "nroff, troff," "proff" and "tbl."
































Processed November 8, 1990        COLPRO(1,C)                                 2