Return to col.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / col

Annotation of 43BSDReno/usr.bin/col/col.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" This code is derived from software contributed to Berkeley by
                      5: .\" Michael Rendell.
                      6: .\"
                      7: .\" Redistribution and use in source and binary forms are permitted provided
                      8: .\" that: (1) source distributions retain this entire copyright notice and
                      9: .\" comment, and (2) distributions including binaries display the following
                     10: .\" acknowledgement:  ``This product includes software developed by the
                     11: .\" University of California, Berkeley and its contributors'' in the
                     12: .\" documentation or other materials provided with the distribution and in
                     13: .\" all advertising materials mentioning features or use of this software.
                     14: .\" Neither the name of the University nor the names of its contributors may
                     15: .\" be used to endorse or promote products derived from this software without
                     16: .\" specific prior written permission.
                     17: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     18: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     19: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     20: .\"
                     21: .\"     @(#)col.1      6.6 (Berkeley) 7/24/90
                     22: .\"
                     23: .Dd July 24, 1990
                     24: .Dt COL 1
                     25: .Os BSD 4.4
                     26: .Sh NAME
                     27: .Nm col
                     28: .Nd filter reverse line feeds from input
                     29: .Sh SYNOPSIS
                     30: .Nm col
                     31: .Op Fl bfx
                     32: .Op Fl l Ar num
                     33: .Sh DESCRIPTION
                     34: .Nm Col
                     35: filters out reverse (and half reverse) line feeds so that the output is
                     36: in the correct order and contains only forward and half forward line
                     37: feeds, and replaces white-space characters with tabs where possible.
                     38: This can be useful in processing the output of
                     39: .Xr nroff 1
                     40: and
                     41: .Xr tbl  1 .
                     42: .Pp
                     43: .Nm Col
                     44: reads from standard input and writes to standard output.
                     45: .Pp
                     46: The options are as follows:
                     47: .Tw Fl
                     48: .Tp Fl b
                     49: Do not output any backspaces \- print only the last character
                     50: written to each column position.
                     51: .Tp Fl f
                     52: Forward half line feeds are permitted (``fine'' mode).
                     53: Normally characters printed on a half line boundary are printed
                     54: on the following line.
                     55: .Tp Fl x
                     56: Output multiple spaces instead of tabs.
                     57: .Tp Cx Fl l
                     58: .Cx Ar num
                     59: .Cx
                     60: Buffer at least
                     61: .Ar num
                     62: lines in memory.
                     63: By default, 128 lines are buffered.
                     64: .Tp
                     65: .Pp
                     66: The control sequences for carriage motion that
                     67: .Nm col
                     68: understands and their decimal values are listed in the following
                     69: table:
                     70: .Pp
                     71: .Dw carriage\ return
                     72: .Di L
                     73: .Dp ESC\-7
                     74: reverse line feed (escape then 7)
                     75: .Dp ESC\-8
                     76: half reverse line feed (escape then 8)
                     77: .Dp ESC\-9
                     78: half forward line feed (escape then 9)
                     79: .Dp backspace
                     80: moves back one column (8); ignored in the first column
                     81: .Dp carriage return
                     82: (13)
                     83: .Dp newline
                     84: forward line feed (10); also does carriage return
                     85: .Dp shift in
                     86: shift to normal character set (15)
                     87: .Dp shift out
                     88: shift to alternate character set (14)
                     89: .Dp space
                     90: moves forward one column (32)
                     91: .Dp tab
                     92: moves forward to next tab stop (9)
                     93: .Dp vertical tab
                     94: reverse line feed (11)
                     95: .Dp
                     96: .Pp
                     97: All unrecognized control characters and escape sequences are
                     98: discarded.
                     99: .Pp
                    100: .Nm Col
                    101: keeps track of the character set as characters are read and makes
                    102: sure the character set is correct when they are output.
                    103: .Pp
                    104: If the input attempts to back up to the last flushed line,
                    105: .Nm col
                    106: will display a warning message.
                    107: .Sh SEE ALSO
                    108: .Xr expand 1 ,
                    109: .Xr nroff 1 ,
                    110: .Xr tbl 1
                    111: .Sh HISTORY
                    112: A
                    113: .Nm col
                    114: command
                    115: appeared in Version 6 AT&T UNIX.  The BSD
                    116: .Nm col
                    117: is derived from code written by Michael Rendell.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.