version 1.16, 2016/03/17 07:18:34 |
version 1.17, 2016/10/21 07:42:17 |
|
|
The |
The |
.Nm |
.Nm |
utility formats its input into multiple columns. |
utility formats its input into multiple columns. |
Rows are filled before columns. |
Each input line provides the text for one output cell. |
|
Columns are filled before rows. |
|
.Pp |
|
The column width is determined by the longest input line rounded |
|
up to the nearest tabstop; tabstops are assumed to be at multiples |
|
of eight. |
|
Output uses tab characters to advance to the next column. |
|
The number of columns is chosen to fill the terminal width. |
|
.Pp |
Input is taken from |
Input is taken from |
.Ar file |
.Ar file |
operands or, by default, from the standard input. |
operands or, by default, from the standard input. |
Empty lines are ignored. |
Empty lines and lines containing only whitespace are ignored. |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
|
.Ar columns |
.Ar columns |
wide. |
wide. |
.It Fl s Ar sep |
.It Fl s Ar sep |
Specify a set of characters to be used to delimit columns for the |
Specify a set of characters to delimit columns for the |
.Fl t |
.Fl t |
option. |
option. |
|
It defaults to space and tab. |
.It Fl t |
.It Fl t |
Determine the number of columns the input contains and create a table. |
Table mode. |
Columns are delimited with whitespace, by default, or with the characters |
Each input line provides the text for one output row. |
supplied using the |
It is split into cells using the |
.Fl s |
.Fl s |
option. |
option. |
Useful for pretty-printing displays. |
Leading, trailing, and multiple adjacent delimiters are ignored. |
|
Each column is as wide as the widest cell in it. |
|
Columns are separated by two spaces. |
.It Fl x |
.It Fl x |
Fill columns before filling rows. |
Fill rows before filling columns. |
.El |
.El |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width COLUMNS |
.Bl -tag -width LC_CTYPE |
.It Ev COLUMNS |
.It Ev COLUMNS |
If set to a positive integer, |
If set to a positive integer, |
output is formatted to the given width in (terminal) columns. |
output is formatted to the given width in display columns. |
Otherwise, |
Otherwise, |
.Nm |
.Nm |
defaults to the terminal width, or 80 columns if the output is not a terminal. |
defaults to the terminal width, or 80 columns if the output is not a terminal. |
|
.It Ev LC_CTYPE |
|
The character encoding |
|
.Xr locale 1 . |
|
It decides which byte sequences form characters, what their display |
|
width is, and which characters are whitespace. |
|
If unset or set to |
|
.Qq C , |
|
.Qq POSIX , |
|
or an unsupported value, each byte except the tab is treated as a |
|
character of display width 1. |
.El |
.El |
.Sh EXIT STATUS |
.Sh EXIT STATUS |
.Ex -std column |
.Ex -std column |