summaryrefslogtreecommitdiffstats
path: root/text-utils/col.1
blob: abd8a766da2ab15aa2707949a2e7c7adfc319d7c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
'\" t
.\"     Title: col
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-01-31
.\"    Manual: User Commands
.\"    Source: util-linux 2.40.1
.\"  Language: English
.\"
.TH "COL" "1" "2024-01-31" "util\-linux 2.40.1" "User Commands"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
col \- filter reverse line feeds from input
.SH "SYNOPSIS"
.sp
\fBcol\fP \fIoptions\fP
.SH "DESCRIPTION"
.sp
\fBcol\fP 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 \fBnroff\fP(1) and \fBtbl\fP(1).
.sp
\fBcol\fP reads from standard input and writes to standard output.
.SH "OPTIONS"
.sp
\fB\-b\fP, \fB\-\-no\-backspaces\fP
.RS 4
Do not output any backspaces, printing only the last character written to each column position.
.RE
.sp
\fB\-f\fP, \fB\-\-fine\fP
.RS 4
Permit half\-forward line feeds. Normally characters destined for a half\-line boundary are printed on the following line.
.RE
.sp
\fB\-h\fP, \fB\-\-tabs\fP
.RS 4
Output tabs instead of multiple spaces.
.RE
.sp
\fB\-l\fP, \fB\-\-lines\fP \fInumber\fP
.RS 4
Buffer at least \fInumber\fP lines in memory. By default, 128 lines are buffered.
.RE
.sp
\fB\-p\fP, \fB\-\-pass\fP
.RS 4
Force unknown control sequences to be passed through unchanged. Normally \fBcol\fP will filter out any control sequences other than those recognized and interpreted by itself, which are listed below.
.RE
.sp
\fB\-x\fP, \fB\-\-spaces\fP
.RS 4
Output multiple spaces instead of tabs.
.RE
.sp
\fB\-H\fP, \fB\-\-help\fP
.RS 4
Display help text and exit.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Print version and exit.
.RE
.SH "CONFORMING TO"
.sp
The \fBcol\fP utility conforms to the Single UNIX Specification, Version 2. The \fB\-l\fP option is an extension to the standard.
.SH "NOTES"
.sp
The control sequences for carriage motion that \fBcol\fP understands and their decimal values are listed in the following table:
.sp
\fBESC\-7\fP
.RS 4
reverse line feed (escape then 7)
.RE
.sp
\fBESC\-8\fP
.RS 4
half reverse line feed (escape then 8)
.RE
.sp
\fBESC\-9\fP
.RS 4
half forward line feed (escape then 9)
.RE
.sp
\fBbackspace\fP
.RS 4
moves back one column (8); ignored in the first column
.RE
.sp
\fBnewline\fP
.RS 4
forward line feed (10); also does carriage return
.RE
.sp
\fBcarriage return\fP
.RS 4
(13)
.RE
.sp
\fBshift in\fP
.RS 4
shift to normal character set (15)
.RE
.sp
\fBshift out\fP
.RS 4
shift to alternate character set (14)
.RE
.sp
\fBspace\fP
.RS 4
moves forward one column (32)
.RE
.sp
\fBtab\fP
.RS 4
moves forward to next tab stop (9)
.RE
.sp
\fBvertical tab\fP
.RS 4
reverse line feed (11)
.RE
.sp
All unrecognized control characters and escape sequences are discarded.
.sp
\fBcol\fP keeps track of the character set as characters are read and makes sure the character set is correct when they are output.
.sp
If the input attempts to back up to the last flushed line, \fBcol\fP will display a warning message.
.SH "HISTORY"
.sp
A \fBcol\fP command appeared in Version 6 AT&T UNIX.
.SH "SEE ALSO"
.sp
\fBexpand\fP(1),
\fBnroff\fP(1),
\fBtbl\fP(1)
.SH "REPORTING BUGS"
.sp
For bug reports, use the issue tracker at \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "AVAILABILITY"
.sp
The \fBcol\fP command is part of the util\-linux package which can be downloaded from \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."