sbase/cols.1

.Dd 2015-10-08
.Dt COLS 1
.Os sbase
.Sh NAME
.Nm cols
.Nd columnize output
.Sh SYNOPSIS
.Nm
.Op Fl c Ar num
.Op Ar file ...
.Sh DESCRIPTION
.Nm
reads each
.Ar file
in sequence and writes them to stdout, in as many vertical
columns as will fit in
.Ar num
character columns.
If no
.Ar file
is given,
.Nm
reads from stdin.
.Pp
By default
.Nm cols
tries to figure out the width of the output device.
If that fails, it defaults to 65 chars.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl c Ar num
Set maximum number of character columns to
.Ar num ,
unless input lines exceed this limit.
.El
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It COLUMNS
The width of the output device.
.El
.Sh HISTORY
.Nm
is similar to
.Xr mc 1
in Plan 9. It was renamed to
.Nm
to avoid the name collision with the popular file manager
Midnight Commander.
.Sh CAVEATS
This implementation of
.Nm
assumes that each UTF-8 code point occupies one character cell,
and thus mishandles TAB characters (among others).
.Pp
.Nm
currently mangles files which contain embedded NULs.
Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org. 2015-10-08 15:15:08 +00:00			`.Dd 2015-10-08`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 13:20:02 +00:00			`.Dt COLS 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 19:37:03 +00:00			`.Os sbase`
Update cols manpage 2014-12-08 15:07:19 +00:00			`.Sh NAME`
			`.Nm cols`
			`.Nd columnize output`
			`.Sh SYNOPSIS`
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff. 2015-01-30 20:17:58 +00:00			`.Nm`
Finish up cols(1) 2015-01-31 23:55:22 +00:00			`.Op Fl c Ar num`
Update cols manpage 2014-12-08 15:07:19 +00:00			`.Op Ar file ...`
			`.Sh DESCRIPTION`
			`.Nm`
Finish up cols(1) 2015-01-31 23:55:22 +00:00			`reads each`
			`.Ar file`
			`in sequence and writes them to stdout, in as many vertical`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 13:43:27 +00:00			`columns as will fit in`
Finish up cols(1) 2015-01-31 23:55:22 +00:00			`.Ar num`
Audit cols(1) 1) Refactor manpage. 2) De-globalize local values. 3) update usage(). 4) sort local variable declarations. 5) fix wrong argument in strtonum (3 -> 1). 6) argc-argv style, boolean style. 7) check bytes > 0 before accessing b.lines[i][bytes - 1] relying on len only makes sense but let's not push it. 7) don't break on maxlen > (chars - 1) / 2. This didn't even make sense. 8) _correctly_ calculate cols and rows in a readable way. 9) Rewrite loop over rows and cols in a readable way and using putchar in a loop instead of printf-magic or fputs where not necessary. 2015-03-08 18:33:46 +00:00			`character columns.`
			`If no`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 13:43:27 +00:00			`.Ar file`
			`is given,`
			`.Nm`
			`reads from stdin.`
Add COLUMNS support to cols(1) First attempt to see if COLUMNS is set, if that fails an ioctl() is issued to find the width of the output device. If that fails as well, we default to 65 chars per line. 2015-02-19 11:24:28 +00:00			`.Pp`
			`By default`
			`.Nm cols`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 22:37:31 +00:00			`tries to figure out the width of the output device.`
			`If that fails, it defaults to 65 chars.`
Update cols manpage 2014-12-08 15:07:19 +00:00			`.Sh OPTIONS`
Finish up cols(1) 2015-01-31 23:55:22 +00:00			`.Bl -tag -width Ds`
Audit cols(1) 1) Refactor manpage. 2) De-globalize local values. 3) update usage(). 4) sort local variable declarations. 5) fix wrong argument in strtonum (3 -> 1). 6) argc-argv style, boolean style. 7) check bytes > 0 before accessing b.lines[i][bytes - 1] relying on len only makes sense but let's not push it. 7) don't break on maxlen > (chars - 1) / 2. This didn't even make sense. 8) _correctly_ calculate cols and rows in a readable way. 9) Rewrite loop over rows and cols in a readable way and using putchar in a loop instead of printf-magic or fputs where not necessary. 2015-03-08 18:33:46 +00:00			`.It Fl c Ar num`
			`Set maximum number of character columns to`
			`.Ar num ,`
			`unless input lines exceed this limit.`
Add COLUMNS support to cols(1) First attempt to see if COLUMNS is set, if that fails an ioctl() is issued to find the width of the output device. If that fails as well, we default to 65 chars per line. 2015-02-19 11:24:28 +00:00			`.El`
			`.Sh ENVIRONMENT`
Audit cols(1) 1) Refactor manpage. 2) De-globalize local values. 3) update usage(). 4) sort local variable declarations. 5) fix wrong argument in strtonum (3 -> 1). 6) argc-argv style, boolean style. 7) check bytes > 0 before accessing b.lines[i][bytes - 1] relying on len only makes sense but let's not push it. 7) don't break on maxlen > (chars - 1) / 2. This didn't even make sense. 8) _correctly_ calculate cols and rows in a readable way. 9) Rewrite loop over rows and cols in a readable way and using putchar in a loop instead of printf-magic or fputs where not necessary. 2015-03-08 18:33:46 +00:00			`.Bl -tag -width Ds`
Add COLUMNS support to cols(1) First attempt to see if COLUMNS is set, if that fails an ioctl() is issued to find the width of the output device. If that fails as well, we default to 65 chars per line. 2015-02-19 11:24:28 +00:00			`.It COLUMNS`
Audit cols(1) 1) Refactor manpage. 2) De-globalize local values. 3) update usage(). 4) sort local variable declarations. 5) fix wrong argument in strtonum (3 -> 1). 6) argc-argv style, boolean style. 7) check bytes > 0 before accessing b.lines[i][bytes - 1] relying on len only makes sense but let's not push it. 7) don't break on maxlen > (chars - 1) / 2. This didn't even make sense. 8) _correctly_ calculate cols and rows in a readable way. 9) Rewrite loop over rows and cols in a readable way and using putchar in a loop instead of printf-magic or fputs where not necessary. 2015-03-08 18:33:46 +00:00			`The width of the output device.`
Forgot .El in cols.1 2014-12-08 15:14:43 +00:00			`.El`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 13:43:27 +00:00			`.Sh HISTORY`
			`.Nm`
man pages: improve consistency 2015-02-01 19:52:28 +00:00			`is similar to`
			`.Xr mc 1`
			`in Plan 9. It was renamed to`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 13:43:27 +00:00			`.Nm`
			`to avoid the name collision with the popular file manager`
			`Midnight Commander.`
Finish up cols(1) 2015-01-31 23:55:22 +00:00			`.Sh CAVEATS`
mc: WTFM 2012-05-21 22:16:46 +00:00			`This implementation of`
Update cols manpage 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`
mc: WTFM 2012-05-21 22:16:46 +00:00			`currently mangles files which contain embedded NULs.`