sbase/cols.1

44 lines
988 B
Groff
Raw Normal View History

2014-12-08 15:07:19 +00:00
.Dd December 8, 2014
.Dt COLS 1
.Os sbase
2014-12-08 15:07:19 +00:00
.Sh NAME
.Nm cols
.Nd columnize output
.Sh SYNOPSIS
.Nm
2014-12-08 15:07:19 +00:00
.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
2014-12-08 15:07:19 +00:00
.Ar chars
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
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
.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.