sbase/cols.1

50 lines
973 B
Groff
Raw Normal View History

2015-01-31 23:55:22 +00:00
.Dd February 1, 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.
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
2015-02-01 19:52:28 +00:00
characters). By default
.Nm cols
tries to figure out the width of the output
2015-01-31 23:55:22 +00:00
device. If that fails, it defaults to 65 chars.
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.