hpux support moved
[unix-history] / usr / src / usr.bin / column / column.1
CommitLineData
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 21The
b5dc1377 22.Nm column
52f8e680
KB
23utility formats its input into multiple columns.
24Rows are filled before columns.
25Input is taken from
b5dc1377 26.Ar file
52f8e680
KB
27operands, or, by default, from the standard input.
28Empty lines are ignored.
b5dc1377 29.Pp
52f8e680 30The options are as follows:
0e853b88
CL
31.Bl -tag -width Ds
32.It Fl c
52f8e680 33Output is formatted for a display
b5dc1377 34.Ar columns
52f8e680 35wide.
0e853b88 36.It Fl s
c379bc96 37Specify a set of characters to be used to delimit columns for the
b5dc1377 38.Fl t
c379bc96 39option.
0e853b88 40.It Fl t
c379bc96 41Determine the number of columns the input contains and create a table.
0e853b88 42Columns are delimited with whitespace, by default, or with the characters
c379bc96 43supplied using the
b5dc1377 44.Fl s
c379bc96 45option.
961349fb 46Useful for pretty-printing displays.
0e853b88 47.It Fl x
52f8e680 48Fill columns before filling rows.
0e853b88 49.El
b5dc1377
CL
50.Pp
51.Nm Column
52f8e680 52exits 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
56The environment variable
57.Ev COLUMNS
58is used to determine the size of
52f8e680 59the 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
70The
71.Nm
72command appeared in
73.Bx 4.3 Reno .