usr/man/cat1/col.0



COL(1)              UNIX Programmer's Manual               COL(1)


N\bNA\bAM\bME\bE
     col - filter reverse line feeds

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     c\bco\bol\bl [ -\b-b\bbf\bfh\bh ]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bC_\bo_\bl 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).  _\bC_\bo_\bl is particularly useful for filtering
     multicolumn output made with the `.rt' command of _\bn_\br_\bo_\bf_\bf and
     output resulting from use of the _\bt_\bb_\bl(1) preprocessor.

     Although _\bc_\bo_\bl accepts half line motions in its input, it nor-
     mally does not emit them on output.  Instead, text that
     would appear between lines is moved to the next lower full
     line boundary.  This treatment can be suppressed by the -\b-f\bf
     (fine) option; in this case the output from _\bc_\bo_\bl may contain
     forward half line feeds (ESC-9), but will still never con-
     tain either kind of reverse line motion.

     If the -\b-b\bb option is given, _\bc_\bo_\bl assumes that the output dev-
     ice 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 control characters SO (ASCII code 017), and SI (016) are
     assumed to start and end text in an alternate character set.
     The character set (primary or alternate) associated with
     each printing character read is remembered; on output, SO
     and SI characters are generated where necessary to maintain
     the correct treatment of each character.

     If the -\b-h\bh option is given, _\bc_\bo_\bl converts white space to tabs
     to shorten printing time.

     All control characters are removed from the input except
     space, backspace, tab, return, newline, ESC (033) followed
     by one of 7, 8, 9, SI, SO, and VT (013).  This last charac-
     ter is an alternate form of full reverse line feed, for com-
     patibility with some other hardware conventions.  All other
     non-printing characters are ignored.

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     troff(1), tbl(1)

B\bBU\bUG\bGS\bS
     Can't back up more than 128 lines.
     No more than 800 characters, including backspaces, on a
     line.


Printed 7/9/88            May 16, 1986                          1