sbase/cols.1

36 lines
904 B
Groff
Raw Normal View History

.TH COLS 1 sbase\-VERSION
2012-05-21 22:16:46 +00:00
.SH NAME
cols \- columnize output
2012-05-21 22:16:46 +00:00
.SH SYNOPSIS
.B cols
2012-05-21 22:16:46 +00:00
.RB [ \-c
.IR chars ]
.RI [ file ...]
.SH DESCRIPTION
.B cols
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
.I chars
character columns.
If no file is given, cols reads from stdin.
2012-05-21 22:16:46 +00:00
.SH OPTIONS
.TP
.BI \-c " chars"
specifies the maximum number of character columns to use
(unless the input contains lines longer than
.I chars
characters). By default cols tries to figure out the width
of the output device, if that fails it defaults to 65
chars.
2012-05-21 22:16:46 +00:00
.SH BUGS
This implementation of
.B cols
2012-05-21 22:16:46 +00:00
assumes that every byte is a character
which takes up one column on the screen.
It does not handle non-ASCII UTF-8 runes
or TAB characters correctly.
.B cols
2012-05-21 22:16:46 +00:00
currently mangles files which contain embedded NULs.
.B cols
does not allow the user to set a default width in its environment.