sbase/cols.1
Hiltjo Posthuma f769c2402f fix mandoc warnings
- sort references in SEE ALSO section to section number, name.
- cols.1: proper order of sections.
- wrap lines to max 79 column length.
2015-01-31 14:43:27 +01:00

44 lines
982 B
Groff

.Dd December 8, 2014
.Dt COLS 1
.Os
.Sh NAME
.Nm cols
.Nd columnize output
.Sh SYNOPSIS
.Nm
.Op Fl c Ar chars
.Op Ar file ...
.Sh DESCRIPTION
.Nm
reads each file in sequence and writes them to stdout, in as many vertical
columns as will fit in
.Ar chars
character columns. If no
.Ar file
is given,
.Nm
reads from stdin.
.Sh OPTIONS
.Bl -tag -width xxxxxxxx
.It Fl c Ar chars
Specifies the maximum number of character columns to use
(unless the input contains lines longer than
.Ar chars
characters). By default cols tries to figure out the width of the output
device, if that fails it defaults to 65 chars.
.El
.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.
.Sh BUGS
This implementation of
.Nm
assumes that each UTF-8 code point occupies one character cell,
and thus mishandles TAB characters (among others).
.Pp
.Nm
currently mangles files which contain embedded NULs.