[man pages]: Update man page cross-references.

* contrib/chem/chem.1.man:
* contrib/eqn2graph/eqn2graph.1.man:
* contrib/gdiffmk/gdiffmk.1.man:
* contrib/glilypond/glilypond.1.man:
* contrib/gperl/gperl.1.man:
* contrib/grap2graph/grap2graph.1.man:
* contrib/hdtbl/groff_hdtbl.7.man:
* contrib/mm/groff_mm.7.man:
* contrib/mm/groff_mmse.7.man:
* contrib/mm/mmroff.1.man:
* contrib/pic2graph/pic2graph.1.man:
* man/ditroff.7.man:
* man/groff.7.man:
* man/groff_char.7.man:
* man/groff_diff.7.man:
* man/groff_font.5.man:
* src/devices/grohtml/grohtml.1.man:
* src/devices/grolj4/grolj4.1.man:
* src/devices/gropdf/gropdf.1.man:
* src/devices/grops/grops.1.man:
* src/devices/grotty/grotty.1.man:
* src/devices/xditview/gxditview.1.man:
* src/preproc/eqn/eqn.1.man:
* src/preproc/eqn/neqn.1.man:
* src/preproc/grn/grn.1.man:
* src/preproc/pic/pic.1.man:
* src/preproc/refer/refer.1.man:
* src/preproc/soelim/soelim.1.man:
* src/preproc/tbl/tbl.1.man:
* src/roff/groff/groff.1.man:
* src/roff/grog/grog.1.man:
* src/roff/nroff/nroff.1.man:
* src/roff/troff/troff.1.man:
* src/utils/afmtodit/afmtodit.1.man:
* src/utils/hpftodit/hpftodit.1.man:
* src/utils/indxbib/indxbib.1.man:
* src/utils/lkbib/lkbib.1.man:
* src/utils/lookbib/lookbib.1.man:
* src/utils/pfbtops/pfbtops.1.man:
* tmac/groff_man.7.man.in:
* tmac/groff_me.7.man:
* tmac/groff_ms.7.man:
* tmac/groff_trace.7.man:
* tmac/groff_www.7.man:
  + Set page topics in italics, not bold.
  + Add section number to first occurrence in page of non-groff man
    page cross-references.
  + Where they are command-prefixed at build time, lead them with a
    hyphenation suppression escape since we cannot know whether the
    user's choice for the prefix will cause a hyphenation event.  Also
    suppress hyphenation if the page topic could otherwise experience
    it, and stop suppressing hyphenation if it couldn't.  Going ahead
    and implementing .MR is looking better and better...

11 files changed, 109 insertions, 106 deletions

diff --git a/contrib/chem/chem.1.man b/contrib/chem/chem.1.man
index 5755a1288..cdcbe42e6 100644
--- a/contrib/chem/chem.1.man
+++ b/contrib/chem/chem.1.man
@@ -62,13 +62,13 @@ produces chemical structure diagrams.
 Today's version is best suited for organic chemistry (bonds, rings).
 .
 The
-.B @g@chem
+.I \%@g@chem
 program is a
-.B groff
+.I groff
 preprocessor like
-.BR @g@eqn ,
-.BR @g@pic ,
-.BR @g@tbl ,
+.IR \%@g@eqn ,
+.IR \%@g@pic ,
+.IR \%@g@tbl ,
 etc.
 .
 It generates
@@ -86,7 +86,7 @@ or if
 .I file
 is
 .RB \[lq] \- \[rq],
-.I @g@chem
+.I \%@g@chem
 reads the standard input stream.
 .
 .B \-h
@@ -103,12 +103,12 @@ all exit.
 .
 .P
 The program
-.B @g@chem
+.I \%@g@chem
 originates from the Perl source file
 .IR chem.pl .
 .
 It tells
-.B @g@pic
+.I \%@g@pic
 to include a copy of the macro file
 .IR chem.pic .
 .
@@ -149,7 +149,7 @@ Lines containing the keywords
 and
 .B .cend
 start and end the input for
-.BR @g@chem ,
+.IR \%@g@chem ,
 respectively.
 .
 In
@@ -193,17 +193,17 @@ groups with a bond between them.
 .
 .P
 If you want to create just
-.B groff
+.I groff
 output, you must run
-.B @g@chem
+.I \%@g@chem
 followed by
-.B groff
+.I groff
 with the option
 .B \-p
 for the activation of
-.BR @g@pic :
+.IR \%@g@pic :
 .IP
-.B @g@chem
+.I \%@g@chem
 .RI [ file \~.\|.\|.\&]
 .BR "| groff \-p\~" .\|.\|.
 .
@@ -700,9 +700,9 @@ code, which is copied through with a label.
 .
 .P
 Since
-.B @g@chem
+.I \%@g@chem
 is a
-.B @g@pic
+.I \%@g@pic
 preprocessor, it is possible to include
 .I pic
 statements in the middle of a diagram to draw things not provided for
@@ -830,7 +830,7 @@ A squiggle bond is needed.
 A collection of
 .I pic
 macros needed by
-.BR @g@chem .
+.IR \%@g@chem .
 .
 .TP
 .I @MACRODIR@/pic.tmac
@@ -889,8 +889,8 @@ AT&T Bell Laboratories Computing Science Techical Report No.\& 122
 .
 .
 .P
-.BR groff (@MAN1EXT@),
-.BR @g@pic (@MAN1EXT@)
+.IR groff (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@)
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/contrib/eqn2graph/eqn2graph.1.man b/contrib/eqn2graph/eqn2graph.1.man
index 0959b3e00..8ba00e452 100644
--- a/contrib/eqn2graph/eqn2graph.1.man
+++ b/contrib/eqn2graph/eqn2graph.1.man
@@ -44,7 +44,7 @@ eqn2graph \- convert an eqn equation into a cropped image
 .
 .I eqn2graph
 reads a one-line
-.IR @g@eqn (@MAN1EXT@)
+.IR \%@g@eqn (@MAN1EXT@)
 equation from the standard input and writes an image file,
 by default in Portable Network Graphics (PNG) format,
 to the standard output.
@@ -155,7 +155,7 @@ by W.\& Richard Stevens.
 .
 .IR pic2graph (@MAN1EXT@),
 .IR grap2graph (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@),
 .IR groff (@MAN1EXT@),
 .IR \%convert (1)
 .
diff --git a/contrib/gdiffmk/gdiffmk.1.man b/contrib/gdiffmk/gdiffmk.1.man
index 4203d1b86..3dc48db50 100644
--- a/contrib/gdiffmk/gdiffmk.1.man
+++ b/contrib/gdiffmk/gdiffmk.1.man
@@ -254,11 +254,11 @@ Mike Bianchi
 .SH "See Also"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR nroff (@MAN1EXT@),
-.BR gtroff (@MAN1EXT@),
-.BR roff (@MAN7EXT@),
-.BR diff (@MAN1EXT@)
+.IR groff (@MAN1EXT@),
+.IR nroff (@MAN1EXT@),
+.IR gtroff (@MAN1EXT@),
+.IR roff (@MAN7EXT@),
+.IR diff (@MAN1EXT@)
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/contrib/glilypond/glilypond.1.man b/contrib/glilypond/glilypond.1.man
index c094f718e..9d83d39fb 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -95,15 +95,15 @@ glilypond \- embed LilyPond musical notation in groff documents
 .SH Description
 .\" ====================================================================
 .
-.B glilypond
+.I glilypond
 transforms sheet music written in the
 .I lilypond
 language into the
-.BR groff (@MAN7EXT@)
+.IR groff (@MAN7EXT@)
 language using the
 .B .PSPIC
 request, such that
-.BR groff (@MAN1EXT@)
+.IR groff (@MAN1EXT@)
 can transform it into a format that can be displayed directly.
 .
 .B .PDFPIC
@@ -133,7 +133,7 @@ even if their names start with a dash.
 .
 Together with
 .BR .PSPIC ,
-.B glilypond can work only for
+.I glilypond can work only for
 .I troff
 devices without
 .I PDF
@@ -144,7 +144,7 @@ devices.
 .
 .P
 I.e., the following
-.B groff
+.I groff
 devices work,
 .BR \-Tps ,
 .BR \-Tdvi ,
@@ -163,7 +163,7 @@ devices.
 .
 .P
 Unfortunately, the
-.B groff
+.I groff
 option
 .B \-Tpdf
 does not work.
@@ -194,7 +194,7 @@ Display copyright license information and exit.
 .TP
 .OP \-\-ly2eps
 Here the
-.B lilypond
+.I lilypond
 program creates
 .I eps
 files directly.
@@ -205,18 +205,18 @@ This is the default.
 .TP
 .OP \-\-pdf2eps
 The program
-.B glilypond
+.I glilypond
 generates a
 .I PDF
 file using
-.BR lilypond .
+.IR lilypond .
 .
 Then the
 .I eps
 file is generated by
-.B pdf2ps
+.I pdf2ps
 and
-.BR ps2eps R .
+.IR ps2eps R .
 .
 .
 .\" ====================================================================
@@ -254,7 +254,7 @@ Normally all temporary files without the
 files are deleted.
 .
 With this option, all generated files either by the
-.B lilypond
+.I lilypond
 program or other format transposers are kept.
 .
 .
@@ -678,7 +678,7 @@ files into a
 file.
 .
 This is done by the
-.BR pdf2ps (1)
+.IR pdf2ps (1)
 program using
 .RS
 .EX
@@ -697,7 +697,7 @@ file from the
 file.
 .
 This is done by the
-.BR ps2eps (1)
+.IR ps2eps (1)
 program using
 .RS
 .EX
@@ -736,10 +736,10 @@ command
 In earlier time, this mode was the default.
 .
 But now it does not work any more, so accept the new default
-.BR pdf2eps .
+.IR pdf2eps .
 .
 For testing, this mode can also be chosen by the
-.B glilypond
+.I glilypond
 option
 .BR \-\-ly2eps .
 .
@@ -748,7 +748,7 @@ option
 In this mode, the
 .B .ly
 files are transformed by the
-.B lilypond
+.I lilypond
 program into many files of different formats, including
 .I eps
 files, using
@@ -806,15 +806,15 @@ commands
 .\" ====================================================================
 .
 The new
-.BR groff (@MAN7EXT@)
+.IR groff (@MAN7EXT@)
 structure generated by
-.B glilypond
+.I glilypond
 is either
 .
 .TP
 1)
 sent to standard output and can there be saved into a file or piped into
-.BR groff (@MAN1EXT@)
+.IR groff (@MAN1EXT@)
 or
 .
 .TP
@@ -840,7 +840,7 @@ Bernd Warken
 .\" ====================================================================
 .
 .TP
-.BR groff (@MAN1EXT@)
+.IR groff (@MAN1EXT@)
 describes the usage of the
 .I groff
 command and contains pointers to further documentation of the
@@ -849,21 +849,21 @@ system.
 .
 .
 .TP
-.BR groff_tmac (@MAN5EXT@)
+.IR groff_tmac (@MAN5EXT@)
 describes the
 .B .PSPIC
 request.
 .
 .
 .TP
-.BR lilypond (1)
+.IR lilypond (1)
 briefly describes the
-.B lilypond
+.I lilypond
 command and contains pointers to further documentation.
 .
 .
 .TP
-.BR pdf2ps (1)
+.IR pdf2ps (1)
 transforms a
 .I PDF
 file into a
@@ -872,7 +872,7 @@ format.
 .
 .
 .TP
-.BR ps2eps (1)
+.IR ps2eps (1)
 transforms a
 .I PS
 file into an
diff --git a/contrib/gperl/gperl.1.man b/contrib/gperl/gperl.1.man
index 27fc48b22..391190f02 100644
--- a/contrib/gperl/gperl.1.man
+++ b/contrib/gperl/gperl.1.man
@@ -55,12 +55,12 @@ gperl \- execute Perl commands in groff documents
 .\" ====================================================================
 .
 This is a preprocessor for
-.BR \%groff (@MAN1EXT@).
+.IR groff (@MAN1EXT@).
 .
 It allows the use of
-.BR perl (7)
+.IR perl (7)
 code in
-.BR groff (@MAN7EXT@)
+.IR groff (@MAN7EXT@)
 files.
 .
 The result of a
@@ -168,7 +168,7 @@ string variable name for storage \(em see next section.
 .\" ====================================================================
 .
 A useful feature of
-.B gperl
+.I gperl
 is to store one or more results from the
 .IR "Perl mode" .
 .
@@ -196,7 +196,7 @@ with a single line for each array member.
 .
 .P
 This Perl array output can be stored by
-.B gperl
+.I gperl
 in either
 .TP
 .I groff strings
@@ -233,7 +233,7 @@ is not really needed before the first
 command.
 .
 That suits to
-.BR \%groff (@MAN7EXT@),
+.IR groff (@MAN7EXT@),
 because every output can be saved as
 .I groff
 string, but the number registers can be very restrictive.
@@ -242,7 +242,7 @@ string, but the number registers can be very restrictive.
 .P
 In
 .IR "string mode" ,
-.B gperl
+.I gperl
 generates a
 .I groff string
 storage line
@@ -331,7 +331,7 @@ and
 .BI ".Perl .nr" " var_name1 varname2"
 stores both variables as number register variables.
 .
-.B gperl
+.I gperl
 generates
 .RS
 .EX
@@ -404,9 +404,9 @@ such that the following line is printed:
 .EE
 .RE
 by
-.B gperl
+.I gperl
 as food for the coming
-.B groff
+.I groff
 run.
 .
 .
@@ -460,18 +460,18 @@ Bernd Warken
 Man pages related to
 .I groff
 are
-.BR groff (@MAN1EXT@),
-.BR groff (@MAN7EXT@),
+.IR groff (@MAN1EXT@),
+.IR groff (@MAN7EXT@),
 and
-.BR grog (@MAN1EXT@).
+.IR grog (@MAN1EXT@).
 .
 .
 .P
 Documents related to
 .I Perl
 are
-.BR perl (1),
-.BR perl (7).
+.IR perl (1),
+.IR perl (7).
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/contrib/grap2graph/grap2graph.1.man b/contrib/grap2graph/grap2graph.1.man
index 6a20f5647..ace7c3d52 100644
--- a/contrib/grap2graph/grap2graph.1.man
+++ b/contrib/grap2graph/grap2graph.1.man
@@ -172,7 +172,7 @@ by W.\& Richard Stevens.
 .IR pic2graph (@MAN1EXT@),
 .IR eqn2graph (@MAN1EXT@),
 .IR grap (1),
-.IR @g@pic (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@),
 .IR groff (@MAN1EXT@),
 .IR \%convert (1)
 .
diff --git a/contrib/hdtbl/groff_hdtbl.7.man b/contrib/hdtbl/groff_hdtbl.7.man
index 3a13aa393..ea9c64733 100644
--- a/contrib/hdtbl/groff_hdtbl.7.man
+++ b/contrib/hdtbl/groff_hdtbl.7.man
@@ -181,7 +181,7 @@ An advantage of
 .I hdtbl
 is that the tables are constructed without calling a preprocessor;
 this means that
-.IR groff 's
+.IR groff (@MAN7EXT@)'s
 full macro capabilities are available.
 .
 On the other hand,
@@ -538,7 +538,7 @@ and not already enclosed in double quotes.
 Argument values specified below as\~\c
 .CI c
 are colors predefined by
-.B groff
+.I groff
 or colors defined by the user with the
 .CR .defcolor
 request.
@@ -554,7 +554,7 @@ are natural numbers.
 Argument values\~\c
 .CI n
 are numerical values with the usual
-.B groff
+.I groff
 scaling indicators.
 .
 Some of the arguments are specific to one or two macros, but most of
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 280d875a8..f90acd68b 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -53,8 +53,10 @@ groff_mm \- memorandum macros for GNU roff
 .SH Description
 .\" ====================================================================
 .
-The groff mm macros are intended to be compatible with the DWB mm macros
-with the following limitations:
+The
+.IR groff (@MAN7EXT@)
+mm macros are intended to be compatible with the DWB mm macros with the
+following limitations.
 .
 .TP
 .B \(bu
@@ -66,7 +68,8 @@ The macros OK and PM are not implemented.
 .
 .TP
 .B \(bu
-groff mm does not support cut marks.
+.I groff
+mm does not support cut marks.
 .
 .
 .LP
@@ -935,7 +938,7 @@ Equation start.
 .
 .BR EQ / EN
 are the delimiters for equations written for
-.BR @g@eqn (@MAN1EXT@).
+.IR \%@g@eqn (@MAN1EXT@).
 .
 .BR EQ / EN
 must be inside of a
@@ -943,7 +946,7 @@ must be inside of a
 pair, except if
 .B EQ
 is used to set options for
-.B @g@eqn
+.I \%@g@eqn
 only.
 .
 The
@@ -1707,10 +1710,10 @@ redirected into file
 .
 Requires two passes with groff;
 this is handled by a separate program called
-.BR mmroff (@MAN1EXT@).
+.IR mmroff (@MAN1EXT@).
 .
 This program exists because
-.BR groff (@MAN1EXT@)
+.IR groff (@MAN1EXT@)
 by default deactivates the unsafe operations that are required by
 .BR INITR .
 .
@@ -2399,7 +2402,7 @@ on the first page.
 Include a PostScript file in the document.
 .
 The macro depends on
-.BR mmroff (@MAN1EXT@)
+.IR mmroff (@MAN1EXT@)
 and
 .BR INITR .
 .
@@ -2428,7 +2431,7 @@ can also be given to resize the picture.
 Picture end.
 .
 Ends a picture for
-.BR @g@pic (@MAN1EXT@).
+.IR \%@g@pic (@MAN1EXT@).
 .
 .TP
 .BI PF\  \fR[\fParg\fR]\fP
@@ -2488,7 +2491,7 @@ This macro defines string
 Picture start (from pic).
 .
 Begins a picture for
-.BR @g@pic (@MAN1EXT@).
+.IR \%@g@pic (@MAN1EXT@).
 .
 .TP
 .B PX
@@ -2955,7 +2958,7 @@ TPoh@argument of \fBOH\fP
 Table start.
 .
 This is the start of a table specification to
-.BR @g@tbl (@MAN1EXT@).
+.IR \%@g@tbl (@MAN1EXT@).
 .
 .B TS
 ends with
@@ -3025,7 +3028,7 @@ This adds four digit-sized spaces in the beginning of each line.
 Finer control is available with the string variable
 .BR Verbnm .
 It contains all arguments to the
-.BR troff (@MAN1EXT@)
+.IR \%@g@troff (@MAN1EXT@)
 command
 .BR .nm ,
 normally \[oq]1\[cq].
@@ -3996,13 +3999,13 @@ of Lund, Sweden.
 .SH "See Also"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR @g@tbl (@MAN1EXT@),
-.BR @g@pic (@MAN1EXT@),
-.BR @g@eqn (@MAN1EXT@)
+.IR groff (@MAN1EXT@),
+.IR \%@g@troff (@MAN1EXT@),
+.IR \%@g@tbl (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@)
 .br
-.BR groff_mmse (@MAN7EXT@)
+.IR groff_mmse (@MAN7EXT@)
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/contrib/mm/groff_mmse.7.man b/contrib/mm/groff_mmse.7.man
index ac13a25c1..0ed18e534 100644
--- a/contrib/mm/groff_mmse.7.man
+++ b/contrib/mm/groff_mmse.7.man
@@ -71,7 +71,7 @@ kan använda
 som argument.
 Detta ger ett svenskt försättsblad.
 Se
-.BR groff_mm (@MAN7EXT@)
+.IR groff_mm (@MAN7EXT@)
 för övriga detaljer.
 .
 .
@@ -156,12 +156,12 @@ Jörgen Hägg, Lund, Sweden <Jorgen.Hagg@axis.se>
 .SH "SE OCKSÅ"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR @g@tbl (@MAN1EXT@),
-.BR @g@pic (@MAN1EXT@),
-.BR @g@eqn (@MAN1EXT@),
-.BR groff_mm (@MAN7EXT@)
+.IR groff (@MAN1EXT@),
+.IR \%@g@troff (@MAN1EXT@),
+.IR \%@g@tbl (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@),
+.IR groff_mm (@MAN7EXT@)
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/contrib/mm/mmroff.1.man b/contrib/mm/mmroff.1.man
index a06e9968b..12a3832a5 100644
--- a/contrib/mm/mmroff.1.man
+++ b/contrib/mm/mmroff.1.man
@@ -97,10 +97,10 @@ Sweden.
 .IR groff_mm (@MAN7EXT@),
 .IR groff_mmse (@MAN7EXT@),
 .IR groff (@MAN1EXT@),
-.IR @g@troff (@MAN1EXT@),
-.IR @g@tbl (@MAN1EXT@),
-.IR @g@pic (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@)
+.IR \%@g@troff (@MAN1EXT@),
+.IR \%@g@tbl (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@)
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/contrib/pic2graph/pic2graph.1.man b/contrib/pic2graph/pic2graph.1.man
index 1f3e37c10..49ad42689 100644
--- a/contrib/pic2graph/pic2graph.1.man
+++ b/contrib/pic2graph/pic2graph.1.man
@@ -46,13 +46,13 @@ pic2graph \- convert a PIC diagram into a cropped image
 .
 .I pic2graph
 reads a
-.IR @g@pic (@MAN1EXT@)
+.IR \%@g@pic (@MAN1EXT@)
 program from the standard input and writes an image file,
 by default in Portable Network Graphics (PNG) format,
 to the standard output.
 .
 It furthermore translates
-.IR @g@eqn (@MAN1EXT@)
+.IR \%@g@eqn (@MAN1EXT@)
 constructs, so it can be used for generating images of mathematical
 formulae.
 .
@@ -107,7 +107,7 @@ Use
 .I delimiters
 as the opening and closing
 characters that delimit
-.I @g@eqn
+.I \%@g@eqn
 directives;
 the default is \(lq$$\(rq.
 .
@@ -115,7 +115,7 @@ The option argument
 .I delimiters
 should be a two-character string,
 but an empty string (\(dq\(dq) is accepted as a directive to disable
-.I @g@eqn
+.I \%@g@eqn
 processing.
 .
 .
@@ -200,8 +200,8 @@ W.\& Richard Stevens,
 .PP
 .IR eqn2graph (@MAN1EXT@),
 .IR grap2graph (@MAN1EXT@),
-.IR @g@pic (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@),
 .IR groff (@MAN1EXT@),
 .IR \%convert (1)
 .