Tune the installed manual pages.
authorGeorge Koehler <xkernigh@netscape.net>
Thu, 19 Jan 2017 04:02:30 +0000 (23:02 -0500)
committerGeorge Koehler <xkernigh@netscape.net>
Thu, 19 Jan 2017 04:02:30 +0000 (23:02 -0500)
commitf91bc2804d46b43b6d6aea876c95d6e05664fbe7
tree41b2ee46abf942956cfef67902e8f035b8222321
parentd7df1267304a1b31050f657b415b358e2c098995
Tune the installed manual pages.

This commit slightly improves the formatting of the manuals.  My
OpenBSD machine uses mandoc(1) to format manuals.  I check the manuals
with `mandoc -T lint` and fix most of the warnings.  I also make
other changes where mandoc didn't warn me.

roff(7) says, "Each sentence should terminate at the end of an input
line," but we often forgot this rule.  I insert some newlines after
sentences that had ended mid-line.

roff(7) also says that blank lines "are only permitted within literal
contexts."  I delete blank lines.  This removes some extra blank lines
from mandoc's output.  If I do want a blank line in the output, I call
".sp 1" to make it in man(7).  If I want a blank line in the source,
but not the output, I put a plain dot "." so roff ignores it.

Hyphens used for command-line options, like \-a, should be escaped by
a backslash.  I insert a few missing backslashes.

mandoc warns if the date in .TH doesn't look like a date.  Our manuals
had a missing date or the RCS keyword "$Revision$".  Git doesn't
expand RCS keywords.  I put in today's date, 2017-01-18.

Some manuals used tab characters in filled mode.  That doesn't work.
I use .nf to turn off filled mode, or I use .IP in man(7) to make the
indentation without a tab character.

ack(1) defined a macro .SB but never used it, so I delete the
definition.  I also remove a call to the missing macro .RF.

mandoc warns about empty paragraphs.  I deleted them.  mandoc also
warned about these macro pairs in anm(1):

    .SM
    .B text

The .SM did nothing because the .B text is on a different line.  I
changed each pair to .SB for small bold text.

I make a few other small changes.
17 files changed:
lang/b/compiler/em_b.6
lang/m2/comp/em_m2.6
lang/pc/comp/em_pc.6
util/ack/ack.1.X
util/amisc/abmodules.1
util/amisc/aelflod.1
util/amisc/anm.1
util/amisc/ashow.1
util/amisc/asize.1
util/amisc/aslod.1
util/amisc/astrip.1
util/arch/aal.1
util/led/ack.out.5
util/led/led.6
util/misc/em_decode.6
util/misc/esize.1
util/opt/em_opt.6