Input file is aplay.1 Output from "mandoc -T lint aplay.1": (shortened list) 9 input text line longer than 80 bytes -.-. Output from test-nroff -mandoc -t -ww -z aplay.1: (shortened list) 1 line(s) with a trailing space -.-. Change (or include a "FIXME" paragraph about) misused SI (metric) numeric prefixes (or names) to the binary ones, like Ki (kibi), Mi (mebi), Gi (gibi), or Ti (tebi), if indicated. If the metric prefixes are correct, add the definitions or an explanation to avoid misunderstanding. 14:automatically split before the 2GB filesize. -.-. Reduce space between words. aplay.1:187:This option has no effect if \-\-separate\-channels is -.-. Add a (no-break, "\ " or "\~") space between a number and a unit, as these are not one entity. 14:automatically split before the 2GB filesize. -.-. Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-), if it is in front of a name for an option, is a symbol for standard input, is a single character used to indicate an option, or is in the NAME section (man-pages(7)). N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen (0x2010, groff \[u2010] or \[hy]) in the output. 79:Either '-d' or '-s' option is available exclusively. 85:Either '-d' or '-s' option is available exclusively. 148:\fI-m, \-\-chmap=ch1,ch2,...\fP -.-. Add a "\&" (or a comma (Oxford comma)) after an abbreviation or use English words (man-pages(7)). Abbreviation points should be marked as such and protected against being interpreted as an end of sentence, if they are not, and that independent of the current place on the line. 211:Disables recovery attempts when errors (e.g. xrun) are encountered; the -.-. Wrong distance (not two spaces) between sentences in the input file. Separate the sentences and subordinate clauses; each begins on a new line. See man-pages(7) ("Conventions for source file layout") and "info groff" ("Input Conventions"). The best procedure is to always start a new sentence on a new line, at least, if you are typing on a computer. Remember coding: Only one command ("sentence") on each (logical) line. E-mail: Easier to quote exactly the relevant lines. Generally: Easier to edit the sentence. Patches: Less unaffected text. Search for two adjacent words is easier, when they belong to the same line, and the same phrase. The amount of space between sentences in the output can then be controlled with the ".ss" request. Mark a final abbreviation point as such by suffixing it with "\&". Some sentences (etc.) do not begin on a new line. Split (sometimes) lines after a punctuation mark; before a conjunction. Lines with only one (or two) space(s) between sentences could be split, so latter sentences begin on a new line. Use #!/usr/bin/sh sed -e '/^\./n' \ -e 's/$[[:alpha:]]$\. */\1.\n/g' $1 to split lines after a sentence period. Check result with the difference between the formatted outputs. See also the attachment "general.bugs" 12:driver. It supports several file formats and multiple soundcards with 13:multiple devices. If recording with interleaved mode samples the file is 16:\fBaplay\fP is much the same, only it plays instead of recording. For 20:If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames. 40:Quiet mode. Suppress messages (not sound :)) 71:Sampling rate in Hertz. The default rate is 8000 Hertz. 92:Open the audio device in non\-blocking mode. If the device is busy the program will exit immediately. 204:Dump hw_params of the device preconfigured status to stderr. The dump 211:Disables recovery attempts when errors (e.g. xrun) are encountered; the -.-. Split lines longer than 80 characters into two or more lines. Appropriate break points are the end of a sentence and a subordinate clause; after punctuation marks. Add "\:" to split the string for the output, "\" in the source. Line 20, length 119 If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames. Line 78, length 111 The default is zero, so if this option is omitted then the record/playback process will run until it is killed. Line 84, length 112 The default is zero, so if this options is omitted then the record/playback process will run until it is killed. Line 92, length 101 Open the audio device in non\-blocking mode. If the device is busy the program will exit immediately. Line 93, length 91 If this option is not set the program will block until the audio device is available again. Line 97, length 87 If no period time and no period size is given then a quarter of the buffer time is set. Line 101, length 114 If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set. Line 105, length 87 If no period size and no period time is given then a quarter of the buffer size is set. Line 109, length 114 If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set. Line 249, length 99 \fBarecord \-f cd \-t wav \-\-max\-file\-time 3600 \-\-use-strftime %Y/%m/%d/listen-%H-%M-%v.wav\fP Longest line is number 20 with 119 characters -.-. The name of a man page is typeset in bold and the section in roman (see man-pages(7)). 256:alsamixer(1), 257:amixer(1) -.-. Put a parenthetical sentence, phrase on a separate line, if not part of a code. See man-pages(7), item "semantic newline". aplay.1:40:Quiet mode. Suppress messages (not sound :)) aplay.1:43:File type (voc, wav, raw or au). aplay.1:64:\-f cd (16 bit little endian, 44100, stereo) [\-f S16_LE \-c2 \-r44100] aplay.1:65:\-f cdr (16 bit big endian, 44100, stereo) [\-f S16_BE \-c2 \-r44100] aplay.1:66:\-f dat (16 bit little endian, 48000, stereo) [\-f S16_LE \-c2 \-r48000] aplay.1:176:Expression for validation is: coef * (buffer_size / 2). aplay.1:211:Disables recovery attempts when errors (e.g. xrun) are encountered; the -.-. Use a no-break space between a number and a (SI) unit 101:If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set. 109:If no buffer time and no buffer size is given then the maximal allowed buffer time but not more than 500ms is set. -.-. Only one space character is after a possible end of sentence (after a punctuation, that can end a sentence). aplay.1:12:driver. It supports several file formats and multiple soundcards with aplay.1:13:multiple devices. If recording with interleaved mode samples the file is aplay.1:16:\fBaplay\fP is much the same, only it plays instead of recording. For aplay.1:20:If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames. aplay.1:40:Quiet mode. Suppress messages (not sound :)) aplay.1:71:Sampling rate in Hertz. The default rate is 8000 Hertz. aplay.1:92:Open the audio device in non\-blocking mode. If the device is busy the program will exit immediately. aplay.1:204:Dump hw_params of the device preconfigured status to stderr. The dump aplay.1:211:Disables recovery attempts when errors (e.g. xrun) are encountered; the -.-. Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=0 -ww -z ": troff::258: warning: trailing space in the line -.- Generally: Split (sometimes) lines after a punctuation mark; before a conjunction.