X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/1c15e88899094343f75aeba04122cd96a96b428e..af359dea2e5ab3e937b62107ecd6a51d78189ed7:/usr/src/usr.bin/colcrt/colcrt.1

diff --git a/usr/src/usr.bin/colcrt/colcrt.1 b/usr/src/usr.bin/colcrt/colcrt.1
index 9850a68ccb..7ed3f996d8 100644
--- a/usr/src/usr.bin/colcrt/colcrt.1
+++ b/usr/src/usr.bin/colcrt/colcrt.1
@@ -1,25 +1,39 @@
 .\" Copyright (c) 1980, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
-.\" 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.
 .\"
-.\"     @(#)colcrt.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
+.\"     @(#)colcrt.1	6.7 (Berkeley) 3/14/91
+.\"
+.Dd March 14, 1991
 .Dt COLCRT 1
-.OS BSD 3
+.Os BSD 3
 .Sh NAME
 .Nm colcrt
 .Nd filter nroff output for CRT previewing
@@ -27,7 +41,7 @@
 .Nm colcrt
 .Op Fl
 .Op Fl \&2
-.Ar
+.Op Ar
 .Sh DESCRIPTION
 .Nm Colcrt
 provides virtual half-line and reverse line feed sequences
@@ -36,15 +50,15 @@ is destructive.
 Half-line characters and underlining (changed to dashing `\-')
 are placed on new lines in between the normal output lines.
 .Pp
-.Tw Ds
-.Tp Fl
+Available options:
+.Bl -tag -width Ds
+.It Fl
 Suppress all underlining.
 It is especially useful for previewing
-.Ar allboxed
+.Em allboxed
 tables from
 .Xr tbl 1 .
-.Pp
-.Tp Fl 2
+.It Fl 2
 Causes all half-lines to be printed, effectively double spacing the output.
 Normally, a minimal space output format is used which will suppress empty
 lines.
@@ -53,38 +67,47 @@ The
 .Fl 2
 option is useful for sending output to the line printer when the output
 contains superscripts and subscripts which would otherwise be invisible.
-.Tp
-.Pp
+.El
+.Sh EXAMPLES
 A typical use of
 .Nm colcrt
 would be
-.Pp
-.Dl tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
+.Bd -literal
+tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
+.Ed
 .Sh SEE ALSO
 .Xr nroff 1 ,
 .Xr troff 1 ,
 .Xr col 1 ,
 .Xr more 1 ,
 .Xr ul 1
-.Sh HISTORY
-Appeared in 3 BSD.
 .Sh BUGS
 Should fold underlines onto blanks even with the
-.Sq Fl
+.Ql Fl
 option so that
 a true underline character would show; if we did this, however,
 .Nm colcrt
 wouldn't get rid of
-.Ar cu'd
+.Ar cu Ns 'd
 underlining
 completely.
 .Pp
 Can't back up more than 102 lines.
 .Pp
 General overstriking is lost;
-as a special case `\&|' overstruck with `\-' or underline becomes `+'.
+as a special case
+.Ql \&|
+overstruck with
+.Ql \-
+or underline becomes
+.Ql \&+ .
 .Pp
 Lines are trimmed to 132 characters.
 .Pp
 Some provision should be made for processing superscripts and subscripts
 in documents which are already double-spaced.
+.Sh HISTORY
+The
+.Nm
+command appeared in 
+.Bx 3.0 .