diff options
author | Sami Kerola <kerolasa@iki.fi> | 2010-10-04 20:57:58 +0200 |
---|---|---|
committer | Karel Zak <kzak@redhat.com> | 2010-10-07 10:20:31 +0200 |
commit | 6cebde5c9647f2c9b1dc5cc5c1a230864c0c2570 (patch) | |
tree | 3b7509e225931a164b5f1def75822d0d192154ab /text-utils | |
parent | a4cc8dfe7d603e7c9386a782c1e128c64bcc27e2 (diff) | |
download | util-linux-old-6cebde5c9647f2c9b1dc5cc5c1a230864c0c2570.tar.gz |
column: update manual page to match column switches
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'text-utils')
-rw-r--r-- | text-utils/column.1 | 99 |
1 files changed, 36 insertions, 63 deletions
diff --git a/text-utils/column.1 b/text-utils/column.1 index 1da59ccb..e3b2b941 100644 --- a/text-utils/column.1 +++ b/text-utils/column.1 @@ -31,72 +31,45 @@ .\" .\" @(#)column.1 8.1 (Berkeley) 6/6/93 .\" -.Dd June 6, 1993 -.Os -.Dt COLUMN 1 -.Sh NAME -.Nm column -.Nd columnate lists -.Sh SYNOPSIS -.Nm column -.Op Fl tx -.Op Fl c Ar columns -.Op Fl s Ar sep -.Op Ar -.Sh DESCRIPTION -The -.Nm column -utility formats its input into multiple columns. -Rows are filled before columns. -Input is taken from -.Ar file -operands, or, by default, from the standard input. -Empty lines are ignored. -.Pp -The options are as follows: -.Bl -tag -width Ds -.It Fl c -Output is formatted for a display -.Ar columns -wide. -.It Fl s -Specify a set of characters to be used to delimit columns for the -.Fl t -option. -.It Fl t +.TH COLUMN 1 "Local" +.SH NAME +column - columnate lists +.SH SYNOPSIS +.B column +.RI [ options ] +.IR file ... +.SH DESCRIPTION +The column utility formats its input into multiple columns. Rows +are filled before columns. Input is taken from file or, by +default, from the standard input. Empty lines are ignored. +.PP +.SH OPTIONS +.IP "\fB\-c, \-\-columns\fP \fIwidth\fP" +Output is formatted to a width specified as number of charcaters. +.IP "\fB\-t, \-\-table\fP" Determine the number of columns the input contains and create a table. Columns are delimited with whitespace, by default, or with the characters -supplied using the -.Fl s -option. -Useful for pretty-printing displays. -.It Fl x +supplied using the separator. Table output is useful for pretty-printing. +.IP "\fB\-s, \-\-separator\fP \fIseparator\fP" +Specify table separator (default is whitespace). +.IP "\fB\-x, \-\-fillrows\fP" Fill columns before filling rows. -.El -.Pp -.Nm Column -exits 0 on success, >0 if an error occurred. -.Sh ENVIRONMENT -.Bl -tag -width COLUMNS -.It Ev COLUMNS -The environment variable -.Ev COLUMNS -is used to determine the size of +.IP "\fB\-h, \-\-help\fP" +Print help and exit. +.SH ENVIRONMENT +The environment variable COLUMNS is used to determine the size of the screen if no other information is available. -.El -.Sh EXAMPLES -.Dl (printf \&"PERM LINKS OWNER GROUP SIZE MONTH DAY HH:MM/YEAR\ NAME\en\&"\ \&\e -.Dl \&; ls -l \&| sed 1d) \&| column -t -.Sh SEE ALSO -.Xr colrm 1 , -.Xr ls 1 , -.Xr paste 1 , -.Xr sort 1 -.Sh HISTORY -The -.Nm -command appeared in -.Bx 4.3 Reno . -.Sh AVAILABILITY +.SH EXAMPLES +.nf +sed 's/#.*//' /etc/fstab | column -t +.nf +.SH "SEE ALSO" +.BR colrm (1), +.BR ls (1), +.BR paste (1), +.BR sort (1) +.SH HISTORY +The column command appeared in 4.3BSD-Reno. +.SH AVAILABILITY The column command is part of the util-linux-ng package and is available from ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/. |