suckless
/
sbase
mirror of git://git.suckless.org/sbase
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
sbase/cols.1

57 lines
1.0 KiB
Groff
Raw Normal View History

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
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.