Input file is alsa-info.8

Output from "mandoc -T lint  alsa-info.8": (shortened list)


-.-.

Output from "test-groff -mandoc -t -ww -z alsa-info.8": (shortened list)

      1 trailing space in the line

Remove trailing space with: sed -e 's/  *$//'

-.-.

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.

31:Includes output from \fIaplay -l\fP.

-.-.

Wrong distance 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 are split,
so latter sentences begin on a new line.

10:about the ALSA subsystem. It is used mostly for debugging purposes.

-.-.

The name of a man page is typeset in bold and the section in roman
(see man-pages(7)).

56:aplay(1)
57:amixer(1)
58:alsactl(1)

-.-.

Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".

alsa-info.8:15:Upload contents to the server (www.alsa-project.org or pastebin.ca).

-.-.

Output from "test-groff  -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z ":

an.tmac:<stdin>:1: style: .TH missing fourth argument; consider package/project name and version (e.g., "groff 1.23.0")
troff:<stdin>:59: warning: trailing space in the line

-.-

Additionally:

Move a period (end of sentence) to the last string in the sentence.

-.-

Generally:

Split (sometimes) lines after a punctuation mark; before a conjunction.