Commit | Line | Data |
---|---|---|
b5dc1377 | 1 | .\" Copyright (c) 1989, 1990 The Regents of the University of California. |
52f8e680 KB |
2 | .\" All rights reserved. |
3 | .\" | |
b5dc1377 | 4 | .\" %sccs.include.redist.man% |
52f8e680 | 5 | .\" |
eefffb84 | 6 | .\" @(#)column.1 5.9 (Berkeley) %G% |
52f8e680 | 7 | .\" |
b5dc1377 | 8 | .Dd |
0e853b88 | 9 | .Os |
b5dc1377 CL |
10 | .Dt COLUMN 1 |
11 | .Sh NAME | |
12 | .Nm column | |
13 | .Nd columnate lists | |
14 | .Sh SYNOPSIS | |
15 | .Nm column | |
0e853b88 | 16 | .Op Fl tx |
eefffb84 KB |
17 | .Op Fl c Ar columns |
18 | .Op Fl s Ar sep | |
0e853b88 | 19 | .Op Ar |
b5dc1377 | 20 | .Sh DESCRIPTION |
52f8e680 | 21 | The |
b5dc1377 | 22 | .Nm column |
52f8e680 KB |
23 | utility formats its input into multiple columns. |
24 | Rows are filled before columns. | |
25 | Input is taken from | |
b5dc1377 | 26 | .Ar file |
52f8e680 KB |
27 | operands, or, by default, from the standard input. |
28 | Empty lines are ignored. | |
b5dc1377 | 29 | .Pp |
52f8e680 | 30 | The options are as follows: |
0e853b88 CL |
31 | .Bl -tag -width Ds |
32 | .It Fl c | |
52f8e680 | 33 | Output is formatted for a display |
b5dc1377 | 34 | .Ar columns |
52f8e680 | 35 | wide. |
0e853b88 | 36 | .It Fl s |
c379bc96 | 37 | Specify a set of characters to be used to delimit columns for the |
b5dc1377 | 38 | .Fl t |
c379bc96 | 39 | option. |
0e853b88 | 40 | .It Fl t |
c379bc96 | 41 | Determine the number of columns the input contains and create a table. |
0e853b88 | 42 | Columns are delimited with whitespace, by default, or with the characters |
c379bc96 | 43 | supplied using the |
b5dc1377 | 44 | .Fl s |
c379bc96 | 45 | option. |
961349fb | 46 | Useful for pretty-printing displays. |
0e853b88 | 47 | .It Fl x |
52f8e680 | 48 | Fill columns before filling rows. |
0e853b88 | 49 | .El |
b5dc1377 CL |
50 | .Pp |
51 | .Nm Column | |
52f8e680 | 52 | exits 0 on success, >0 if an error occurred. |
b5dc1377 | 53 | .Sh ENVIRONMENT |
0e853b88 CL |
54 | .Bl -tag -width COLUMNS |
55 | .It Ev COLUMNS | |
5325ced3 CL |
56 | The environment variable |
57 | .Ev COLUMNS | |
58 | is used to determine the size of | |
52f8e680 | 59 | the screen if no other information is available. |
0e853b88 | 60 | .El |
b5dc1377 | 61 | .Sh EXAMPLES |
eefffb84 | 62 | .Dl (printf \&"PERM LINKS OWNER SIZE MONTH DAY HH:MM/YEAR NAME\en\&"\ \&;\ \&\e |
0c269528 | 63 | .Dl ls -l \&| sed 1d) \&| column -t |
b5dc1377 CL |
64 | .Sh SEE ALSO |
65 | .Xr colrm 1 , | |
66 | .Xr ls 1 , | |
67 | .Xr paste 1 , | |
68 | .Xr sort 1 | |
69 | .Sh HISTORY | |
0e853b88 CL |
70 | The |
71 | .Nm | |
72 | command appeared in | |
73 | .Bx 4.3 Reno . |