]>
Commit | Line | Data |
---|---|---|
6dbe3af9 KZ |
1 | .\" Copyright (c) 1980, 1990, 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
3 | .\" | |
4 | .\" Redistribution and use in source and binary forms, with or without | |
5 | .\" modification, are permitted provided that the following conditions | |
6 | .\" are met: | |
7 | .\" 1. Redistributions of source code must retain the above copyright | |
8 | .\" notice, this list of conditions and the following disclaimer. | |
9 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
10 | .\" notice, this list of conditions and the following disclaimer in the | |
11 | .\" documentation and/or other materials provided with the distribution. | |
12 | .\" 3. All advertising materials mentioning features or use of this software | |
13 | .\" must display the following acknowledgement: | |
14 | .\" This product includes software developed by the University of | |
15 | .\" California, Berkeley and its contributors. | |
16 | .\" 4. Neither the name of the University nor the names of its contributors | |
17 | .\" may be used to endorse or promote products derived from this software | |
18 | .\" without specific prior written permission. | |
19 | .\" | |
20 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
21 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
22 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
23 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
24 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
25 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
26 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
27 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
28 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
30 | .\" SUCH DAMAGE. | |
31 | .\" | |
32 | .\" @(#)colcrt.1 8.1 (Berkeley) 6/30/93 | |
33 | .\" | |
8220d6ca SK |
34 | .TH COLCRT "1" "September 2011" "util-linux" "User Commands" |
35 | .SH NAME | |
36 | colcrt \- filter nroff output for CRT previewing | |
37 | .SH SYNOPSIS | |
38 | .B colcrt | |
07990fdc BS |
39 | [options] |
40 | .RI [ file ...] | |
8220d6ca SK |
41 | .SH DESCRIPTION |
42 | .B colcrt | |
43 | provides virtual half-line and reverse line feed sequences for terminals | |
44 | without such capability, and on which overstriking is destructive. | |
45 | Half-line characters and underlining (changed to dashing `\-') are placed on | |
46 | new lines in between the normal output lines. | |
47 | .SH OPTIONS | |
48 | .TP | |
b06c1ca6 | 49 | \fB\-\fR, \fB\-\-no\-underlining\fR |
8220d6ca SK |
50 | Suppress all underlining. This option is especially useful for previewing |
51 | .I allboxed | |
6dbe3af9 | 52 | tables from |
8220d6ca SK |
53 | .BR tbl (1). |
54 | .TP | |
b06c1ca6 | 55 | \fB\-2\fR, \fB\-\-half\-lines\fR |
6dbe3af9 KZ |
56 | Causes all half-lines to be printed, effectively double spacing the output. |
57 | Normally, a minimal space output format is used which will suppress empty | |
8220d6ca | 58 | lines. The program never suppresses two consecutive empty lines, however. |
6dbe3af9 | 59 | The |
8220d6ca | 60 | .B \-2 |
6dbe3af9 KZ |
61 | option is useful for sending output to the line printer when the output |
62 | contains superscripts and subscripts which would otherwise be invisible. | |
8220d6ca SK |
63 | .TP |
64 | \fB\-V\fR, \fB\-\-version\fR | |
b4362b6f | 65 | Display version information and exit. |
8220d6ca SK |
66 | .TP |
67 | \fB\-h\fR, \fB\-\-help\fR | |
b4362b6f | 68 | Display help text and exit. |
8220d6ca | 69 | .SH EXAMPLES |
6dbe3af9 | 70 | A typical use of |
8220d6ca | 71 | .B colcrt |
07990fdc | 72 | would be: |
8220d6ca | 73 | .PP |
07990fdc BS |
74 | .RS |
75 | .B tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more | |
76 | .RE | |
8220d6ca | 77 | .SH SEE ALSO |
8220d6ca SK |
78 | .BR col (1), |
79 | .BR more (1), | |
f053ff1e MK |
80 | .BR nroff (1), |
81 | .BR troff (1), | |
8220d6ca SK |
82 | .BR ul (1) |
83 | .SH BUGS | |
6dbe3af9 | 84 | Should fold underlines onto blanks even with the |
8220d6ca SK |
85 | .B '\-' |
86 | option so that a true underline character would show. | |
87 | .PP | |
6dbe3af9 | 88 | Can't back up more than 102 lines. |
8220d6ca SK |
89 | .PP |
90 | General overstriking is lost; as a special case '|' overstruck with '\-' or | |
91 | underline becomes '+'. | |
92 | .PP | |
6dbe3af9 | 93 | Lines are trimmed to 132 characters. |
8220d6ca SK |
94 | .PP |
95 | Some provision should be made for processing superscripts and subscripts in | |
96 | documents which are already double-spaced. | |
97 | .SH HISTORY | |
6dbe3af9 | 98 | The |
8220d6ca SK |
99 | .B colcrt |
100 | command appeared in 3.0BSD. | |
101 | .SH AVAILABILITY | |
601d12fb | 102 | The colcrt command is part of the util-linux package and is available from |
8220d6ca SK |
103 | .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
104 | Linux Kernel Archive | |
105 | .UE . |