sbase/cols.1

42 lines
996 B
Groff
Raw Normal View History

2014-12-08 15:07:19 +00:00
.Dd December 8, 2014
.Dt COLS 1 sbase\-VERSION
.Os
.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
2012-05-21 22:16:46 +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
2012-05-21 22:16:46 +00:00
character columns.
If no file is given, cols 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
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.
2014-12-08 15:07:19 +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.