sbase/fold.1

.Dd 2015-10-08
.Dt FOLD 1
.Os sbase
.Sh NAME
.Nm fold
.Nd wrap lines to width
.Sh SYNOPSIS
.Nm
.Op Fl bs
.Op Fl w Ar num | Fl Ns Ar num
.Op Ar file ...
.Sh DESCRIPTION
.Nm
reads each
.Ar file
and prints its lines wrapped such that no line
exceeds a certain width.
If no file is given,
.Nm
reads from stdin.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl b
Count bytes rather than characters.
.It Fl s
If a line contains spaces, break
at the last space within width.
.It Fl w Ar num | Fl Ns Ar num
Break at
.Ar num
characters. The default is 80.
.El
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The
.Op Fl Ns Ar num
syntax is an extension to that specification.
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 11:15:08 -04:00			`.Dd 2015-10-08`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 08:20:02 -05:00			`.Dt FOLD 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 14:37:03 -05:00			`.Os sbase`
Add mandoc-manpage for fold(1) and refactor code and mark it as finished in the README. In the code, use size_t rather than long. 2015-01-25 15:22:17 -05:00			`.Sh NAME`
			`.Nm fold`
			`.Nd wrap lines to width`
			`.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 15:17:58 -05:00			`.Nm`
Add mandoc-manpage for fold(1) and refactor code and mark it as finished in the README. In the code, use size_t rather than long. 2015-01-25 15:22:17 -05:00			`.Op Fl bs`
Audit fold(1) 1) Use num-wording in the manpage, remove offensive remark against the beloved -num-syntax <3. 2) Style changes. 3) Report errors of getline. 4) argv-argc-centric argument loop. 5) Rename r to ret for consistency. 2015-03-13 18:47:41 -04:00			`.Op Fl w Ar num \| Fl Ns Ar num`
Add mandoc-manpage for fold(1) and refactor code and mark it as finished in the README. In the code, use size_t rather than long. 2015-01-25 15:22:17 -05:00			`.Op Ar file ...`
			`.Sh DESCRIPTION`
			`.Nm`
			`reads each`
			`.Ar file`
			`and prints its lines wrapped such that no line`
			`exceeds a certain width.`
			`If no file is given,`
			`.Nm`
			`reads from stdin.`
			`.Sh OPTIONS`
			`.Bl -tag -width Ds`
			`.It Fl b`
			`Count bytes rather than characters.`
			`.It Fl s`
			`If a line contains spaces, break`
Audit fold(1) 1) Use num-wording in the manpage, remove offensive remark against the beloved -num-syntax <3. 2) Style changes. 3) Report errors of getline. 4) argv-argc-centric argument loop. 5) Rename r to ret for consistency. 2015-03-13 18:47:41 -04:00			`at the last space within width.`
			`.It Fl w Ar num \| Fl Ns Ar num`
Add mandoc-manpage for fold(1) and refactor code and mark it as finished in the README. In the code, use size_t rather than long. 2015-01-25 15:22:17 -05:00			`Break at`
Audit fold(1) 1) Use num-wording in the manpage, remove offensive remark against the beloved -num-syntax <3. 2) Style changes. 3) Report errors of getline. 4) argv-argc-centric argument loop. 5) Rename r to ret for consistency. 2015-03-13 18:47:41 -04:00			`.Ar num`
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 12:22:48 -04:00			`characters. The default is 80.`
Add mandoc-manpage for fold(1) and refactor code and mark it as finished in the README. In the code, use size_t rather than long. 2015-01-25 15:22:17 -05:00			`.El`
			`.Sh STANDARDS`
			`The`
			`.Nm`
			`utility is compliant with the`
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 12:22:48 -04:00			`.St -p1003.1-2013`
Add mandoc-manpage for fold(1) and refactor code and mark it as finished in the README. In the code, use size_t rather than long. 2015-01-25 15:22:17 -05:00			`specification.`
			`.Pp`
Audit fold(1) 1) Use num-wording in the manpage, remove offensive remark against the beloved -num-syntax <3. 2) Style changes. 3) Report errors of getline. 4) argv-argc-centric argument loop. 5) Rename r to ret for consistency. 2015-03-13 18:47:41 -04:00			`The`
			`.Op Fl Ns Ar num`
fold: Fix usage and manpage for -width 2015-03-05 03:15:23 -05:00			`syntax is an extension to that specification.`