2014-03-12 10:43:45 -04:00
|
|
|
.TH COLS 1 sbase\-VERSION
|
2012-05-21 18:16:46 -04:00
|
|
|
.SH NAME
|
2014-03-12 10:43:45 -04:00
|
|
|
cols \- columnize output
|
2012-05-21 18:16:46 -04:00
|
|
|
.SH SYNOPSIS
|
2014-03-12 10:43:45 -04:00
|
|
|
.B cols
|
2012-05-21 18:16:46 -04:00
|
|
|
.RB [ \-c
|
|
|
|
.IR chars ]
|
|
|
|
.RI [ file ...]
|
|
|
|
.SH DESCRIPTION
|
2014-03-12 10:43:45 -04:00
|
|
|
.B cols
|
2012-05-21 18:16:46 -04:00
|
|
|
reads each file in sequence and writes them to stdout,
|
|
|
|
in as many vertical columns as will fit in
|
|
|
|
.I chars
|
|
|
|
character columns.
|
2014-03-12 10:43:45 -04:00
|
|
|
If no file is given, cols reads from stdin.
|
2012-05-21 18:16:46 -04: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
|
2014-03-12 10:43:45 -04:00
|
|
|
characters). By default cols tries to figure out the width
|
2014-01-20 07:03:01 -05:00
|
|
|
of the output device, if that fails it defaults to 65
|
|
|
|
chars.
|
2012-05-21 18:16:46 -04:00
|
|
|
.SH BUGS
|
|
|
|
This implementation of
|
2014-03-12 10:43:45 -04:00
|
|
|
.B cols
|
2012-05-21 18:16:46 -04:00
|
|
|
assumes that every byte is a character
|
|
|
|
which takes up one column on the screen.
|
2014-12-05 16:32:08 -05:00
|
|
|
It does not handle TAB characters correctly.
|
2014-03-12 10:43:45 -04:00
|
|
|
.B cols
|
2012-05-21 18:16:46 -04:00
|
|
|
currently mangles files which contain embedded NULs.
|
2014-03-12 10:43:45 -04:00
|
|
|
.B cols
|
2014-01-20 07:03:01 -05:00
|
|
|
does not allow the user to set a default width in its environment.
|