]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
aad107b6 MB |
2 | //// |
3 | Copyright (c) 1990 The Regents of the University of California. | |
4 | All rights reserved. | |
5 | ||
6 | This code is derived from software contributed to Berkeley by | |
7 | Michael Rendell. | |
8 | ||
9 | Redistribution and use in source and binary forms, with or without | |
10 | modification, are permitted provided that the following conditions | |
11 | are met: | |
12 | 1. Redistributions of source code must retain the above copyright | |
13 | notice, this list of conditions and the following disclaimer. | |
14 | 2. Redistributions in binary form must reproduce the above copyright | |
15 | notice, this list of conditions and the following disclaimer in the | |
16 | documentation and/or other materials provided with the distribution. | |
17 | 3. All advertising materials mentioning features or use of this software | |
18 | must display the following acknowledgement: | |
19 | This product includes software developed by the University of | |
20 | California, Berkeley and its contributors. | |
21 | 4. Neither the name of the University nor the names of its contributors | |
22 | may be used to endorse or promote products derived from this software | |
23 | without specific prior written permission. | |
24 | ||
25 | THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
26 | ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
27 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
28 | ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
29 | FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
30 | DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
31 | OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
32 | HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
33 | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
34 | OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
35 | SUCH DAMAGE. | |
36 | ||
37 | @(#)col.1 6.8 (Berkeley) 6/17/91 | |
38 | //// | |
39 | = col(1) | |
40 | :doctype: manpage | |
f42ed819 | 41 | :man manual: User Commands |
aad107b6 MB |
42 | :man source: util-linux {release-version} |
43 | :page-layout: base | |
44 | :command: col | |
45 | ||
46 | == NAME | |
47 | ||
48 | col - filter reverse line feeds from input | |
49 | ||
50 | == SYNOPSIS | |
51 | ||
52 | *col* _options_ | |
53 | ||
aad107b6 MB |
54 | == DESCRIPTION |
55 | ||
56 | *col* filters out reverse (and half-reverse) line feeds so the output is in the correct order, with only forward and half-forward line feeds. It also replaces any whitespace characters with tabs where possible. This can be useful in processing the output of *nroff*(1) and *tbl*(1). | |
57 | ||
58 | *col* reads from standard input and writes to standard output. | |
59 | ||
aad107b6 MB |
60 | == OPTIONS |
61 | ||
62 | *-b*, *--no-backspaces*:: | |
bbeadfdd | 63 | Do not output any backspaces, printing only the last character written to each column position. |
aad107b6 MB |
64 | |
65 | *-f*, *--fine*:: | |
bbeadfdd | 66 | Permit half-forward line feeds. Normally characters destined for a half-line boundary are printed on the following line. |
aad107b6 MB |
67 | |
68 | *-h*, *--tabs*:: | |
bbeadfdd | 69 | Output tabs instead of multiple spaces. |
aad107b6 MB |
70 | |
71 | *-l*, *--lines* _number_:: | |
bbeadfdd | 72 | Buffer at least _number_ lines in memory. By default, 128 lines are buffered. |
aad107b6 MB |
73 | |
74 | *-p*, *--pass*:: | |
bbeadfdd | 75 | Force unknown control sequences to be passed through unchanged. Normally *col* will filter out any control sequences other than those recognized and interpreted by itself, which are listed below. |
aad107b6 MB |
76 | |
77 | *-x*, *--spaces*:: | |
bbeadfdd | 78 | Output multiple spaces instead of tabs. |
aad107b6 | 79 | |
5fbfa64e CG |
80 | *-H*, *--help*:: |
81 | Display help text and exit. | |
82 | ||
83 | *-V*, *--version*:: | |
84 | Print version and exit. | |
aad107b6 | 85 | |
aad107b6 MB |
86 | == CONFORMING TO |
87 | ||
88 | The *col* utility conforms to the Single UNIX Specification, Version 2. The *-l* option is an extension to the standard. | |
89 | ||
aad107b6 MB |
90 | == NOTES |
91 | ||
92 | The control sequences for carriage motion that *col* understands and their decimal values are listed in the following table: | |
93 | ||
aad107b6 | 94 | *ESC-7*:: |
bbeadfdd | 95 | reverse line feed (escape then 7) |
aad107b6 | 96 | *ESC-8*:: |
bbeadfdd | 97 | half reverse line feed (escape then 8) |
aad107b6 | 98 | *ESC-9*:: |
bbeadfdd | 99 | half forward line feed (escape then 9) |
aad107b6 | 100 | *backspace*:: |
bbeadfdd | 101 | moves back one column (8); ignored in the first column |
aad107b6 | 102 | *newline*:: |
bbeadfdd | 103 | forward line feed (10); also does carriage return |
aad107b6 | 104 | *carriage return*:: |
bbeadfdd | 105 | (13) |
aad107b6 | 106 | *shift in*:: |
bbeadfdd | 107 | shift to normal character set (15) |
aad107b6 | 108 | *shift out*:: |
bbeadfdd | 109 | shift to alternate character set (14) |
aad107b6 | 110 | *space*:: |
bbeadfdd | 111 | moves forward one column (32) |
aad107b6 | 112 | *tab*:: |
bbeadfdd | 113 | moves forward to next tab stop (9) |
aad107b6 | 114 | *vertical tab*:: |
bbeadfdd | 115 | reverse line feed (11) |
aad107b6 MB |
116 | |
117 | All unrecognized control characters and escape sequences are discarded. | |
118 | ||
119 | *col* keeps track of the character set as characters are read and makes sure the character set is correct when they are output. | |
120 | ||
121 | If the input attempts to back up to the last flushed line, *col* will display a warning message. | |
122 | ||
aad107b6 MB |
123 | == HISTORY |
124 | ||
125 | A *col* command appeared in Version 6 AT&T UNIX. | |
126 | ||
aad107b6 MB |
127 | == SEE ALSO |
128 | ||
129 | *expand*(1), | |
130 | *nroff*(1), | |
131 | *tbl*(1) | |
132 | ||
625e9c61 | 133 | include::man-common/bugreports.adoc[] |
aad107b6 | 134 | |
625e9c61 | 135 | include::man-common/footer.adoc[] |
aad107b6 MB |
136 | |
137 | ifdef::translation[] | |
625e9c61 | 138 | include::man-common/translation.adoc[] |
aad107b6 | 139 | endif::[] |