BSD 4_3_Net_2 release

[unix-history] / usr / src / usr.bin / col / col.1

diff --git a/usr/src/usr.bin/col/col.1 b/usr/src/usr.bin/col/col.1
index 049252d..1bf9852 100644 (file)
--- a/usr/src/usr.bin/col/col.1
+++ b/usr/src/usr.bin/col/col.1
@@ -4,25 +4,39 @@
 .\" This code is derived from software contributed to Berkeley by
 .\" Michael Rendell.
 .\"
 .\" This code is derived from software contributed to Berkeley by
 .\" Michael Rendell.
 .\"

-.\" Redistribution and use in source and binary forms are permitted provided
-.\" that: (1) source distributions retain this entire copyright notice and
-.\" comment, and (2) distributions including binaries display the following
-.\" acknowledgement:  ``This product includes software developed by the
-.\" University of California, Berkeley and its contributors'' in the
-.\" documentation or other materials provided with the distribution and in
-.\" all advertising materials mentioning features or use of this software.
-.\" Neither the name of the University nor the names of its contributors may
-.\" be used to endorse or promote products derived from this software without
-.\" specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
-.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
-.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"     @(#)col.1      6.6 (Berkeley) 7/24/90
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.

 .\"
 .\"

-.Dd July 24, 1990
+.\"     @(#)col.1      6.8 (Berkeley) 6/17/91
+.\"
+.Dd June 17, 1991

 .Dt COL 1
 .Dt COL 1

-.Os BSD 4.4
+.Os

 .Sh NAME
 .Nm col
 .Nd filter reverse line feeds from input
 .Sh NAME
 .Nm col
 .Nd filter reverse line feeds from input


@@ -32,8 +46,8 @@
 .Op Fl l Ar num
 .Sh DESCRIPTION
 .Nm Col
 .Op Fl l Ar num
 .Sh DESCRIPTION
 .Nm Col

-filters out reverse (and half reverse) line feeds so that the output is
-in the correct order and contains only forward and half forward line
+filters out reverse (and half reverse) line feeds so the output is
+in the correct order with only forward and half forward line

 feeds, and replaces white-space characters with tabs where possible.
 This can be useful in processing the output of
 .Xr nroff 1
 feeds, and replaces white-space characters with tabs where possible.
 This can be useful in processing the output of
 .Xr nroff 1


@@ -44,55 +58,52 @@ and
 reads from standard input and writes to standard output.
 .Pp
 The options are as follows:
 reads from standard input and writes to standard output.
 .Pp
 The options are as follows:

-.Tw Fl
-.Tp Fl b
-Do not output any backspaces \- print only the last character
+.Bl -tag -width "-lnum"
+.It Fl b
+Do not output any backspaces, printing only the last character

 written to each column position.
 written to each column position.

-.Tp Fl f
+.It Fl f

 Forward half line feeds are permitted (``fine'' mode).
 Normally characters printed on a half line boundary are printed
 on the following line.
 Forward half line feeds are permitted (``fine'' mode).
 Normally characters printed on a half line boundary are printed
 on the following line.

-.Tp Fl x
+.It Fl x

 Output multiple spaces instead of tabs.
 Output multiple spaces instead of tabs.

-.Tp Cx Fl l
-.Cx Ar num
-.Cx
+.It Fl l Ns Ar num

 Buffer at least
 .Ar num
 lines in memory.
 By default, 128 lines are buffered.
 Buffer at least
 .Ar num
 lines in memory.
 By default, 128 lines are buffered.

-.Tp
+.El

 .Pp
 The control sequences for carriage motion that
 .Nm col
 understands and their decimal values are listed in the following
 table:
 .Pp
 .Pp
 The control sequences for carriage motion that
 .Nm col
 understands and their decimal values are listed in the following
 table:
 .Pp

-.Dw carriage\ return
-.Di L
-.Dp ESC\-7
+.Bl -tag -width "carriage return" -compact
+.It ESC\-7

 reverse line feed (escape then 7)
 reverse line feed (escape then 7)

-.Dp ESC\-8
+.It ESC\-8

 half reverse line feed (escape then 8)
 half reverse line feed (escape then 8)

-.Dp ESC\-9
+.It ESC\-9

 half forward line feed (escape then 9)
 half forward line feed (escape then 9)

-.Dp backspace
+.It backspace

 moves back one column (8); ignored in the first column
 moves back one column (8); ignored in the first column

-.Dp carriage return
+.It carriage return

 (13)
 (13)

-.Dp newline
+.It newline

 forward line feed (10); also does carriage return
 forward line feed (10); also does carriage return

-.Dp shift in
+.It shift in

 shift to normal character set (15)
 shift to normal character set (15)

-.Dp shift out
+.It shift out

 shift to alternate character set (14)
 shift to alternate character set (14)

-.Dp space
+.It space

 moves forward one column (32)
 moves forward one column (32)

-.Dp tab
+.It tab

 moves forward to next tab stop (9)
 moves forward to next tab stop (9)

-.Dp vertical tab
+.It vertical tab

 reverse line feed (11)
 reverse line feed (11)

-.Dp
+.El

 .Pp
 All unrecognized control characters and escape sequences are
 discarded.
 .Pp
 All unrecognized control characters and escape sequences are
 discarded.


@@ -112,6 +123,4 @@ will display a warning message.
 A
 .Nm col
 command
 A
 .Nm col
 command

-appeared in Version 6 AT&T UNIX.  The BSD
-.Nm col
-is derived from code written by Michael Rendell.
+appeared in Version 6 AT&T UNIX.