make output line buffered if selecting only some of the entries
[unix-history] / usr / src / usr.bin / column / column.1
CommitLineData
52f8e680
KB
1.\" Copyright (c) 1989 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms are permitted
5.\" provided that the above copyright notice and this paragraph are
6.\" duplicated in all such forms and that any documentation,
7.\" advertising materials, and other materials related to such
8.\" distribution and use acknowledge that the software was developed
9.\" by the University of California, Berkeley. The name of the
10.\" University may not be used to endorse or promote products derived
11.\" from this software without specific prior written permission.
12.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
13.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
14.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
15.\"
c379bc96 16.\" @(#)column.1 5.3 (Berkeley) %G%
52f8e680
KB
17.\"
18.UC 7
19.TH COLUMN 1 ""
20.UC 1
21.SH NAME
22column \- columnate lists
23.SH SYNOPSIS
c379bc96 24\fBcolumn [ \fI\-tx\fB ] [ \fI\-s sep\fB ] [\fI\-c columns\fB ] [ \fIfile ...\fB ]
52f8e680
KB
25.ft R
26.SH DESCRIPTION
27The
28.I column
29utility formats its input into multiple columns.
30Rows are filled before columns.
31Input is taken from
32.I file
33operands, or, by default, from the standard input.
34Empty lines are ignored.
35.PP
36The options are as follows:
37.TP
ff1bcce4 38.I \-c
52f8e680
KB
39Output is formatted for a display
40.I columns
41wide.
42.TP
c379bc96
KB
43.I \-s
44Specify a set of characters to be used to delimit columns for the
ff1bcce4 45.I \-t
c379bc96
KB
46option.
47.TP
48.I \-t
49Determine the number of columns the input contains and create a table.
50Columns are delimited by whitespace, by default, or by the characters
51supplied using the
52.I \-s
53option.
ff1bcce4
KB
54Useful for pretty-printing displays, for example:
55.sp
56(printf "PERM LINKS OWNER SIZE MONTH DAY HH:MM/YEAR NAME\en";
57.br
58ls -l | sed 1d) | column -t
59.TP
60.I \-x
52f8e680
KB
61Fill columns before filling rows.
62.PP
63.I Column
64exits 0 on success, >0 if an error occurred.
65.SH ENVIRONMENT
66.TP
67.I COLUMNS
68The environmental variable COLUMNS is used to determine the size of
69the screen if no other information is available.
70.SH "SEE ALSO"
ff1bcce4 71colrm(1), ls(1), paste(1), sort(1)