2014-12-08 15:07:19 +00:00
|
|
|
.Dd December 8, 2014
|
2015-01-31 13:20:02 +00:00
|
|
|
.Dt COLS 1
|
2015-01-31 19:37:03 +00:00
|
|
|
.Os sbase
|
2014-12-08 15:07:19 +00:00
|
|
|
.Sh NAME
|
|
|
|
.Nm cols
|
|
|
|
.Nd columnize output
|
|
|
|
.Sh SYNOPSIS
|
2015-01-30 20:17:58 +00:00
|
|
|
.Nm
|
2014-12-08 15:07:19 +00:00
|
|
|
.Op Fl c Ar chars
|
|
|
|
.Op Ar file ...
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Nm
|
2015-01-31 13:43:27 +00:00
|
|
|
reads each file in sequence and writes them to stdout, in as many vertical
|
|
|
|
columns as will fit in
|
2014-12-08 15:07:19 +00:00
|
|
|
.Ar chars
|
2015-01-31 13:43:27 +00:00
|
|
|
character columns. If no
|
|
|
|
.Ar file
|
|
|
|
is given,
|
|
|
|
.Nm
|
|
|
|
reads from stdin.
|
2014-12-08 15:07:19 +00:00
|
|
|
.Sh OPTIONS
|
|
|
|
.Bl -tag -width xxxxxxxx
|
|
|
|
.It Fl c Ar chars
|
|
|
|
Specifies the maximum number of character columns to use
|
2012-05-21 22:16:46 +00:00
|
|
|
(unless the input contains lines longer than
|
2014-12-08 15:07:19 +00:00
|
|
|
.Ar chars
|
2015-01-31 13:43:27 +00:00
|
|
|
characters). By default cols tries to figure out the width of the output
|
|
|
|
device, if that fails it defaults to 65 chars.
|
2014-12-08 15:14:43 +00:00
|
|
|
.El
|
2015-01-31 13:43:27 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
.Nm
|
|
|
|
is similar to the mc(1) command on Plan 9. It was renamed to
|
|
|
|
.Nm
|
|
|
|
to avoid the name collision with the popular file manager
|
|
|
|
Midnight Commander.
|
2014-12-08 15:07:19 +00:00
|
|
|
.Sh BUGS
|
2012-05-21 22:16:46 +00:00
|
|
|
This implementation of
|
2014-12-08 15:07:19 +00:00
|
|
|
.Nm
|
|
|
|
assumes that each UTF-8 code point occupies one character cell,
|
|
|
|
and thus mishandles TAB characters (among others).
|
|
|
|
.Pp
|
|
|
|
.Nm
|
2012-05-21 22:16:46 +00:00
|
|
|
currently mangles files which contain embedded NULs.
|