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     ! 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.