Annotation of src/usr.bin/colcrt/colcrt.1, Revision 1.1.1.1
1.1 deraadt 1: .\" $NetBSD: colcrt.1,v 1.3 1995/03/26 05:30:59 glass Exp $
2: .\"
3: .\" Copyright (c) 1980, 1990, 1993
4: .\" The Regents of the University of California. All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
14: .\" 3. All advertising materials mentioning features or use of this software
15: .\" must display the following acknowledgement:
16: .\" This product includes software developed by the University of
17: .\" California, Berkeley and its contributors.
18: .\" 4. Neither the name of the University nor the names of its contributors
19: .\" may be used to endorse or promote products derived from this software
20: .\" without specific prior written permission.
21: .\"
22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32: .\" SUCH DAMAGE.
33: .\"
34: .\" @(#)colcrt.1 8.1 (Berkeley) 6/30/93
35: .\"
36: .Dd June 30, 1993
37: .Dt COLCRT 1
38: .Os BSD 3
39: .Sh NAME
40: .Nm colcrt
41: .Nd filter nroff output for CRT previewing
42: .Sh SYNOPSIS
43: .Nm colcrt
44: .Op Fl
45: .Op Fl \&2
46: .Op Ar
47: .Sh DESCRIPTION
48: .Nm Colcrt
49: provides virtual half-line and reverse line feed sequences
50: for terminals without such capability, and on which overstriking
51: is destructive.
52: Half-line characters and underlining (changed to dashing `\-')
53: are placed on new lines in between the normal output lines.
54: .Pp
55: Available options:
56: .Bl -tag -width Ds
57: .It Fl
58: Suppress all underlining.
59: This option is especially useful for previewing
60: .Em allboxed
61: tables from
62: .Xr tbl 1 .
63: .It Fl 2
64: Causes all half-lines to be printed, effectively double spacing the output.
65: Normally, a minimal space output format is used which will suppress empty
66: lines.
67: The program never suppresses two consecutive empty lines, however.
68: The
69: .Fl 2
70: option is useful for sending output to the line printer when the output
71: contains superscripts and subscripts which would otherwise be invisible.
72: .El
73: .Sh EXAMPLES
74: A typical use of
75: .Nm colcrt
76: would be
77: .Bd -literal
78: tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
79: .Ed
80: .Sh SEE ALSO
81: .Xr nroff 1 ,
82: .Xr troff 1 ,
83: .Xr col 1 ,
84: .Xr more 1 ,
85: .Xr ul 1
86: .Sh BUGS
87: Should fold underlines onto blanks even with the
88: .Ql Fl
89: option so that
90: a true underline character would show.
91: .Pp
92: Can't back up more than 102 lines.
93: .Pp
94: General overstriking is lost;
95: as a special case
96: .Ql \&|
97: overstruck with
98: .Ql \-
99: or underline becomes
100: .Ql \&+ .
101: .Pp
102: Lines are trimmed to 132 characters.
103: .Pp
104: Some provision should be made for processing superscripts and subscripts
105: in documents which are already double-spaced.
106: .Sh HISTORY
107: The
108: .Nm
109: command appeared in
110: .Bx 3.0 .