|
|
1.1 root 1: .\" Copyright (c) 1980, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)colcrt.1 6.6 (Berkeley) 7/24/90
19: .\"
20: .Dd July 24, 1990
21: .Dt COLCRT 1
22: .OS BSD 3
23: .Sh NAME
24: .Nm colcrt
25: .Nd filter nroff output for CRT previewing
26: .Sh SYNOPSIS
27: .Nm colcrt
28: .Op Fl
29: .Op Fl \&2
30: .Ar
31: .Sh DESCRIPTION
32: .Nm Colcrt
33: provides virtual half-line and reverse line feed sequences
34: for terminals without such capability, and on which overstriking
35: is destructive.
36: Half-line characters and underlining (changed to dashing `\-')
37: are placed on new lines in between the normal output lines.
38: .Pp
39: .Tw Ds
40: .Tp Fl
41: Suppress all underlining.
42: It is especially useful for previewing
43: .Ar allboxed
44: tables from
45: .Xr tbl 1 .
46: .Pp
47: .Tp Fl 2
48: Causes all half-lines to be printed, effectively double spacing the output.
49: Normally, a minimal space output format is used which will suppress empty
50: lines.
51: The program never suppresses two consecutive empty lines, however.
52: The
53: .Fl 2
54: option is useful for sending output to the line printer when the output
55: contains superscripts and subscripts which would otherwise be invisible.
56: .Tp
57: .Pp
58: A typical use of
59: .Nm colcrt
60: would be
61: .Pp
62: .Dl tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
63: .Sh SEE ALSO
64: .Xr nroff 1 ,
65: .Xr troff 1 ,
66: .Xr col 1 ,
67: .Xr more 1 ,
68: .Xr ul 1
69: .Sh HISTORY
70: Appeared in 3 BSD.
71: .Sh BUGS
72: Should fold underlines onto blanks even with the
73: .Sq Fl
74: option so that
75: a true underline character would show; if we did this, however,
76: .Nm colcrt
77: wouldn't get rid of
78: .Ar cu'd
79: underlining
80: completely.
81: .Pp
82: Can't back up more than 102 lines.
83: .Pp
84: General overstriking is lost;
85: as a special case `\&|' overstruck with `\-' or underline becomes `+'.
86: .Pp
87: Lines are trimmed to 132 characters.
88: .Pp
89: Some provision should be made for processing superscripts and subscripts
90: in documents which are already double-spaced.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.