midfavila/sbase
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity

Update cols manpage

Browse Source
This commit is contained in:
sin 2014-12-08 15:07:19 +00:00
parent 45086e76f9
commit 909ffd5bf7
2 changed files with 31 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
cols.1
View File

@ -1,34 +1,40 @@
.TH COLS 1 sbase\-VERSION .Dd December 8, 2014
.SH NAME .Dt COLS 1 sbase\-VERSION
cols \- columnize output .Os
.SH SYNOPSIS .Sh NAME
.B cols .Nm cols
.RB [ \-c .Nd columnize output
.IR chars ] .Sh SYNOPSIS
.RI [ file ...] .Nm cols
.SH DESCRIPTION .Op Fl c Ar chars
.B cols .Op Ar file ...
.Sh DESCRIPTION
.Nm
reads each file in sequence and writes them to stdout, reads each file in sequence and writes them to stdout,
in as many vertical columns as will fit in in as many vertical columns as will fit in
.I chars .Ar chars
character columns. character columns.
If no file is given, cols reads from stdin. If no file is given, cols reads from stdin.
.SH OPTIONS .Sh OPTIONS
.TP .Bl -tag -width xxxxxxxx
.BI \-c " chars" .It Fl c Ar chars
specifies the maximum number of character columns to use Specifies the maximum number of character columns to use
(unless the input contains lines longer than (unless the input contains lines longer than
.I chars .Ar chars
characters). By default cols tries to figure out the width characters). By default cols tries to figure out the width
of the output device, if that fails it defaults to 65 of the output device, if that fails it defaults to 65
chars. chars.
.SH BUGS .Sh BUGS
This implementation of This implementation of
.B cols .Nm
assumes that every byte is a character assumes that each UTF-8 code point occupies one character cell,
which takes up one column on the screen. and thus mishandles TAB characters (among others).
It does not handle TAB characters correctly. .Pp
.B cols .Nm
currently mangles files which contain embedded NULs. currently mangles files which contain embedded NULs.
.B cols .Sh HISTORY
does not allow the user to set a default width in its environment. .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.

2
cols.c
View File

@ -20,7 +20,7 @@ static long n_rows;
static void static void
usage(void) usage(void)
{ {
eprintf("usage: %s [-c chars] [FILE...]\n", argv0); eprintf("usage: %s [-c chars] [file ...]\n", argv0);
} }
int int