sbase/cols.1

58 lines
1.1 KiB
Groff
Raw Normal View History

.Dd February 19, 2015
.Dt COLS 1
.Os sbase
2014-12-08 15:07:19 +00:00
.Sh NAME
.Nm cols
.Nd columnize output
.Sh SYNOPSIS
.Nm
2015-01-31 23:55:22 +00:00
.Op Fl c Ar num
2014-12-08 15:07:19 +00:00
.Op Ar file ...
.Sh DESCRIPTION
.Nm
2015-01-31 23:55:22 +00:00
reads each
.Ar file
in sequence and writes them to stdout, in as many vertical
columns as will fit in
2015-01-31 23:55:22 +00:00
.Ar num
character columns. If no
.Ar file
is given,
.Nm
reads from stdin.
.Pp
By default
.Nm cols
tries to figure out the width of the output
device. If that fails, it defaults to 65 chars.
2014-12-08 15:07:19 +00:00
.Sh OPTIONS
2015-01-31 23:55:22 +00:00
.Bl -tag -width Ds
2014-12-08 15:07:19 +00:00
.It Fl c Ar chars
2015-01-31 23:55:22 +00:00
Set the maximum number of character columns to use
2012-05-21 22:16:46 +00:00
(unless the input contains lines longer than
2015-01-31 23:55:22 +00:00
.Ar num
characters).
.El
.Sh ENVIRONMENT
.Bl -tag -width COLUMNS
.It COLUMNS
If this variable is set, the value is used as the
width of the output device.
2014-12-08 15:14:43 +00:00
.El
.Sh HISTORY
.Nm
2015-02-01 19:52:28 +00:00
is similar to
.Xr mc 1
in Plan 9. It was renamed to
.Nm
to avoid the name collision with the popular file manager
Midnight Commander.
2015-01-31 23:55:22 +00:00
.Sh CAVEATS
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.