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`
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 17:37:31 -05: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.`