summaryrefslogtreecommitdiff
path: root/tmac
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2020-11-06 20:41:24 +1100
committerG. Branden Robinson <g.branden.robinson@gmail.com>2020-11-10 00:37:09 +1100
commita69b5d07f04007e4bb76ec6b4af2bd84372dc783 (patch)
tree70c107dc12bcb65bd8083081c3db0233025783bb /tmac
parente19a31ae299c5990d4296d6c44d9d025b07c5185 (diff)
downloadgroff-git-a69b5d07f04007e4bb76ec6b4af2bd84372dc783.tar.gz
[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...
Diffstat (limited to 'tmac')
-rw-r--r--tmac/groff_man.7.man.in20
-rw-r--r--tmac/groff_me.7.man16
-rw-r--r--tmac/groff_ms.7.man12
-rw-r--r--tmac/groff_trace.7.man7
-rw-r--r--tmac/groff_www.7.man2
5 files changed, 28 insertions, 29 deletions
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 8b45f7cf1..8a7b10d65 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1857,7 +1857,7 @@ check,
or which is developed in the future.
.
The table preprocessor
-.IR @g@tbl (@MAN1EXT@)
+.IR \%@g@tbl (@MAN1EXT@)
can likely meet your needs.
_endif()dnl
.
@@ -2006,9 +2006,9 @@ _endif()dnl
.\" ====================================================================
.
When a preprocessor like
-.I @g@tbl
+.I \%@g@tbl
or
-.I @g@eqn
+.I \%@g@eqn
is needed,
a hint can be given to the man page formatter by making the first line
of a man page look like this:
@@ -2031,12 +2031,12 @@ The
.I word
consists of one letter for each needed preprocessor:
\(lqe\(rq for
-.IR @g@eqn ,
+.IR \%@g@eqn ,
\(lqr\(rq for
-.IR @g@refer ,
+.IR \%@g@refer ,
and
\(lqt\(rq for
-.IR @g@tbl .
+.IR \%@g@tbl .
.
Modern implementations of the
.I man
@@ -2684,7 +2684,7 @@ to express are likely to be lost.
.
If you feel tempted to use it,
you should probably be composing a table using
-.IR @g@tbl (@MAN1EXT@)
+.IR \%@g@tbl (@MAN1EXT@)
markup instead.
.
.
@@ -3464,10 +3464,10 @@ You can browse it interactively with \(lqinfo groff\(rq.
.
.
.PP
-.IR @g@tbl (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@),
+.IR \%@g@tbl (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@),
and
-.IR @g@refer (@MAN1EXT@)
+.IR \%@g@refer (@MAN1EXT@)
are preprocessors used with man pages.
.
.
diff --git a/tmac/groff_me.7.man b/tmac/groff_me.7.man
index 0634147c7..940bcf5c9 100644
--- a/tmac/groff_me.7.man
+++ b/tmac/groff_me.7.man
@@ -483,11 +483,9 @@ documenting it while an undergraduate at the University of California.
.SH "See Also"
.\" ====================================================================
.
-.BR groff (@MAN1EXT@),
-.BR troff (@MAN1EXT@)
+.IR groff (@MAN1EXT@),
+.IR troff (@MAN1EXT@)
.
-.
-.PP
Two manuals are available in source and rendered form.
.
On your system,
@@ -516,12 +514,12 @@ by Eric P.\& Allman and James Clark.
For preprocessors supported by
.IR me ,
see
-.BR eqn (@MAN1EXT@),
-.BR grn (@MAN1EXT@),
-.BR pic (@MAN1EXT@),
-.BR refer (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@),
+.IR \%@g@grn (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@),
+.IR \%@g@refer (@MAN1EXT@),
and
-.BR tbl (@MAN1EXT@).
+.IR \%@g@tbl (@MAN1EXT@).
.
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 294d14951..8e7856d1c 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1120,7 +1120,7 @@ Denote a reference to be processed by the
preprocessor.
.
The GNU
-.IR @g@refer (@MAN1EXT@)
+.IR \%@g@refer (@MAN1EXT@)
manual page provides a comprehensive reference
to the preprocessor and the format of the
bibliographic database.
@@ -1831,11 +1831,11 @@ by Trent A.\& Fisher and Werner Lemberg
.
.PP
.IR groff (@MAN1EXT@),
-.IR @g@troff (@MAN1EXT@),
-.IR @g@tbl (@MAN1EXT@),
-.IR @g@pic (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@),
-.IR @g@refer (@MAN1EXT@)
+.IR \%@g@troff (@MAN1EXT@),
+.IR \%@g@tbl (@MAN1EXT@),
+.IR \%@g@pic (@MAN1EXT@),
+.IR \%@g@eqn (@MAN1EXT@),
+.IR \%@g@refer (@MAN1EXT@)
.
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
diff --git a/tmac/groff_trace.7.man b/tmac/groff_trace.7.man
index 7eb601901..3882c3ba1 100644
--- a/tmac/groff_trace.7.man
+++ b/tmac/groff_trace.7.man
@@ -45,8 +45,9 @@ groff_trace \- GNU roff macros for debugging groff documents
The
.I trace
macro package of
-.BR groff (@MAN1EXT@)
-can be a valuable tool for debugging documents written in the roff
+.IR groff (@MAN1EXT@)
+can be a valuable tool for debugging documents written in the
+.I roff
formatting language.
.
A call stack trace is protocolled on standard error, this is, a
@@ -258,7 +259,7 @@ macros are kept in the file
located in the
.IR "tmac directory" ;
see
-.BR groff_tmac (@MAN5EXT@)
+.IR groff_tmac (@MAN5EXT@)
for details.
.
.
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index 6ebe764a1..3ac5be51f 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -739,7 +739,7 @@ Bernd Warken
.\" ====================================================================
.
.IR groff (@MAN1EXT@),
-.IR @g@troff (@MAN1EXT@),
+.IR \%@g@troff (@MAN1EXT@),
.IR \%grohtml (@MAN1EXT@),
.IR netpbm (1)
.