summaryrefslogtreecommitdiff
path: root/static/v10/man1/column.1
blob: 316a062f84204c06ce11a9106c9d7ec7f665260c (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
.TH COLUMN 1
.CT 1 files writing_output
.SH NAME
col, 2, 3, 4, 5, 6, mc, fold, expand \- column alignment
.SH SYNOPSIS
.B col
[
.B -bfx 
]
.PP
.B 2
[
.I file
]
.PP
.B mc
[
.B -
]
[
.BI - N
]
[
.B -t
]
[
.I file ...
]
.PP
.B fold
[
.BI - N
]
[
.I file ...
]
.PP
.B expand
[
.BI - stops
]
[
.I file ...
]
.SH DESCRIPTION
These programs rearrange files for appearance's sake.
All read the standard input and write the standard output.
Some optionally read from files instead.
.PP
.I Col
overlays lines to expunge reverse line feeds
(ESC-7)
and half line feeds (ESC-9 and ESC-8)
as produced by
.I nroff
for .2C in
.IR ms (6)
and for 
.IR tbl (1).
It normally emits only full line feeds;
option 
.B -f
(fine) allows half line feeds too.
Option 
.B -b
removes backspaces, printing just one of each pile of overstruck
characters.
.I Col
normally converts white space to tabs;
option
.B -x
overrides this feature.
Other escaped characters and non-printing characters, except for
SO and SI, are ignored.
.PP
.I Col
should not be used for printing on an HP ThinkJet printer with
.I think
.RI ( thinkblt (9.1)),
which performs the
.I col
function itself.
.PP
Commands
.I "2, 3, 4, 5, 6"
convert their input to 2-, 3-, 4-, 5-, or 6-column form,
with consecutive input lines arranged across each row.
.PP
.I Fold
inserts newlines after each
.I N
characters (default
.IR n =80,
or
.IR mux (9.1)
window size)
of long lines.
.PP
.I Mc
splits the input into as many columns as will fit in
.I N
print positions (default
.IR N =80).
Under option
.B -
each input line ending in a colon 
.L :
is printed separately (see example).
On output, multiple spaces are converted to tabs; this
is suppressed by option
.BR -t .
.PP
.I Expand
replaces tabs by spaces.
The optional
.I stops
argument is a comma-separated list of tab stops, counted from 0;
default is every 8 columns.
.SH EXAMPLES
.TP
.L
tbl file | nroff -ms | col | hp
Format some tables for printing on typewriters;
use
.I col
to remove reverse line feeds and 
.I hp
(see
.IR ul (1))
to do underlining, etc., on an HP terminal.
.TP
.L
ls directory1 directory2 | mc -
List files in multiple columns, separated by directory.
.SH SEE ALSO
.IR pr (1)
.SH BUGS
.I Col
can't back up more than 128 lines or
handle more than 800 characters per line,
and understands
.L VT
(013) as reverse line feed.