infinite loop on bad file name
[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.\"
16.\" @(#)column.1 5.1 (Berkeley) %G%
17.\"
18.UC 7
19.TH COLUMN 1 ""
20.UC 1
21.SH NAME
22column \- columnate lists
23.SH SYNOPSIS
24\fBcolumn [ \fI-x\fB ] [\fI-c columns\fB ] [ \fIfile ...\fB ]
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
38.I -c
39Output is formatted for a display
40.I columns
41wide.
42.TP
43.I -x
44Fill columns before filling rows.
45.PP
46.I Column
47exits 0 on success, >0 if an error occurred.
48.SH ENVIRONMENT
49.TP
50.I COLUMNS
51The environmental variable COLUMNS is used to determine the size of
52the screen if no other information is available.
53.SH "SEE ALSO"
54ls(1), paste(1), sort(1)