remove Usef on clean
[unix-history] / usr / src / usr.bin / colcrt / colcrt.1
CommitLineData
d5baed0e
KM
1.\" Copyright (c) 1980 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
14140efb 5.\" @(#)colcrt.1 6.2 (Berkeley) %G%
d5baed0e 6.\"
dd7874f6 7.TH COLCRT 1 ""
d5baed0e
KM
8.UC
9.SH NAME
10colcrt \- filter nroff output for CRT previewing
11.SH SYNOPSIS
12.B colcrt
13[
14.B \-
15] [
16.B \-2
17] [
18file ...
19]
20.SH DESCRIPTION
21.I Colcrt
22provides virtual half-line and reverse line feed sequences
23for terminals without such capability, and on which overstriking
24is destructive.
25Half-line characters and underlining (changed to dashing `\-')
26are placed on new lines in between the normal output lines.
27.PP
28The optional
29.B \-
30suppresses all underlining.
31It is especially useful for previewing
32.I allboxed
33tables from
34.IR tbl (1).
35.PP
36The option
37.B \-2
38causes all half-lines to be printed, effectively double spacing the output.
39Normally, a minimal space output format is used which will suppress empty
40lines.
41The program never suppresses two consecutive empty lines, however.
42The
43.B \-2
44option is useful for sending output to the line printer when the output
45contains superscripts and subscripts which would otherwise be invisible.
46.PP
47A typical use of
48.I colcrt
49would be
50.PP
51.DT
52 tbl exum2.n | nroff \-ms | colcrt \- | more
53.SH "SEE ALSO"
54nroff/troff(1), col(1), more(1), ul(1)
d5baed0e
KM
55.SH BUGS
56Should fold underlines onto blanks even with the
57`\fB\-\fR'
58option so that
59a true underline character would show; if we did this, however,
60.I colcrt
61wouldn't get rid of
62.I cu'd
63underlining
64completely.
65.PP
66Can't back up more than 102 lines.
67.PP
68General overstriking is lost;
69as a special case `|' overstruck with `\-' or underline becomes `+'.
70.PP
71Lines are trimmed to 132 characters.
72.PP
73Some provision should be made for processing superscripts and subscripts
74in documents which are already double-spaced.