[groff] [PATCH] man page patches for 1.22.4.rc5/final

[G. Branden Robinson]

It's starting to sound like (1) either there's going to be an rc5 or
we're about to close in on final; (2) there have been some other
documentation fixes committed since the beginning of the month; (3) I
don't want my local tree to get badly desynced from Savannah again and
(4) mom NEVER lets me commit any documentation fixes ( ;-) ), I figured
I'd summarize and attach my pending changes for opinions and review.

[1/9]    NEWS, man pages: Fix typos.
[2/9]    *.man: Regularize (sub)section cross references.
[3/9]    man pages: Set filespecs in italics, not bold.
[4/9]    groff_me(7): Prefix .TH release info with "groff".
[5/9]    man pages: Escape hyphens in filenames.
[6/9]    man pages: Hyphenate phrasal adjectives.
[7/9]    groff(1): DESC files describe devices, not fonts.
[8/9]    groff(1): Update "Availability" section.
[9/9]    troff(1): Fix bad grammar.

Most of these (all but #2 and #3) are very small.  You can find their
diffstats below.

#1 fixes a typo in a highly visible place.

#2 has the weakest case for a commit before release and I'm not
passionate about it.

#3 is a continuation of 1eb479103854518db2cc4254c1f2601c30be7380, from
28 November, when I checkpointed and halted work because of the release
freeze.

#4 would make the page's footer consistent with the other 60 pages.

#5, #6, and #9 are low-impact but don't scream with urgency.

#7 and #8 correct false (or misleading) information.  #8 in particular
corrects outdated information about our mailing lists.

Does anyone feel that any of these are important to get into the final
release?

Diffstats
---------

1.diff:
 NEWS                 |    2 +-
 tmac/groff_man.7.man |    4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

2.diff:
 contrib/gdiffmk/gdiffmk.1.man   |    4 +---
 contrib/groffer/groffer.1.man   |   14 ++++++--------
 contrib/mm/groff_mm.7.man       |    6 ++----
 contrib/pdfmark/pdfroff.1.man   |    8 +++-----
 man/groff.7.man                 |   11 ++++++-----
 man/groff_char.7.man            |    2 +-
 man/groff_diff.7.man            |    8 ++------
 man/groff_out.5.man             |   22 ++++++++++------------
 man/groff_tmac.5.man            |    5 +++--
 man/roff.7.man                  |    7 +++----
 src/devices/grolbp/grolbp.1.man |    4 ++--
 src/devices/gropdf/gropdf.1.man |   11 ++++-------
 src/devices/grops/grops.1.man   |   11 ++++-------
 src/preproc/eqn/eqn.1.man       |    8 ++------
 src/preproc/refer/refer.1.man   |   15 ++++++---------
 src/roff/troff/troff.1.man      |    4 +---
 tmac/groff_man.7.man            |   18 +++++++-----------
 tmac/groff_ms.7.man             |    4 +---
 18 files changed, 64 insertions(+), 98 deletions(-)

3.diff:
 contrib/pdfmark/pdfroff.1.man        |   40 ++++++--------
 man/groff.7.man                      |    2 
 man/groff_diff.7.man                 |    4 -
 man/groff_font.5.man                 |   32 ++++++-----
 man/groff_out.5.man                  |    6 +-
 man/groff_tmac.5.man                 |   99 +++++++++++++++++------------------
 src/devices/grodvi/grodvi.1.man      |   24 ++++----
 src/devices/grohtml/grohtml.1.man    |    4 -
 src/devices/grolbp/grolbp.1.man      |   28 ++++-----
 src/devices/grolj4/grolj4.1.man      |   10 +--
 src/devices/gropdf/gropdf.1.man      |   53 ++++++++++--------
 src/devices/grops/grops.1.man        |   72 ++++++++++++++-----------
 src/devices/grotty/grotty.1.man      |   44 +++++++--------
 src/devices/xditview/gxditview.1.man |   18 +++---
 src/preproc/eqn/eqn.1.man            |   20 +++----
 src/preproc/grn/grn.1.man            |   18 +++---
 src/preproc/pic/pic.1.man            |    8 +-
 src/preproc/refer/refer.1.man        |    4 -
 src/roff/groff/groff.1.man           |   62 +++++++++++----------
 src/roff/troff/troff.1.man           |   49 +++++++++--------
 src/utils/indxbib/indxbib.1.man      |   16 ++---
 src/utils/tfmtodit/tfmtodit.1.man    |   12 ++--
 tmac/groff_ms.7.man                  |    9 +--
 tmac/groff_www.7.man                 |    5 +
 24 files changed, 336 insertions(+), 303 deletions(-)

4.diff:
 groff_me.7.man |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

5.diff:
 man/groff_tmac.5.man       |    2 +-
 src/roff/troff/troff.1.man |    2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

6.diff:
 man/groff.7.man            |    2 +-
 src/roff/troff/troff.1.man |    2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

7.diff:
 groff.1.man |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

8.diff:
 groff.1.man |   41 ++++++++++++++++++++++++++---------------
 1 file changed, 26 insertions(+), 15 deletions(-)

9.diff:
 troff.1.man |    5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

Regards,
Branden

1.diff
Description: Text Data

2.diff
Description: Text Data

3.diff
Description: Text Data

4.diff
Description: Text Data

5.diff
Description: Text Data

6.diff
Description: Text Data

7.diff
Description: Text Data

8.diff
Description: Text Data

9.diff
Description: Text Data

signature.asc
Description: PGP signature