[groff] 01/01: Divert would-be diversion users to groff_tmac(5).

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit fd5e01280330c0965b8f2fa8f6a58adbfd85089e
Author: G. Branden Robinson <address@hidden>
Date:   Sun Oct 22 02:55:05 2017 -0400

    Divert would-be diversion users to groff_tmac(5).
    
    An explanation how to write a diversion that works is lacking in the
    manual pages, except in groff_tmac(5).
    
    Signed-off-by: Bjarni Ingi Gislason <address@hidden>
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 man/groff.7.man | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/man/groff.7.man b/man/groff.7.man
index 2e9c581..96f8978 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -539,6 +539,9 @@ Moreover, there are some advanced roff elements.
 A
 .B diversion
 stores (formatted) information into a macro for later usage.
+See
+.BR groff_tmac (@MAN5EXT@)
+for more details.
 .
 A
 .B trap
@@ -1530,6 +1533,9 @@ End current diversion.
 .REQ .di "macro"
 Divert to
 .IR macro .
+See
+.BR groff_tmac (@MAN5EXT@)
+for more details.
 .
 .TPx
 .REQ .do "name"
@@ -4569,6 +4575,12 @@ the predefined groff special characters (glyphs).
 the specification of fonts and the DESC file.
 .
 .TP
+.BR groff_tmac (@MAN5EXT@)
+contains an overview of available groff macro packages, instructions on
+how to interface them with a document, guidance on writing macro
+packages and using diversions, and historical information on macro
+package naming conventions.
+.TP
 .BR roff (@MAN7EXT@)
 the history of roff, the common parts shared by all roff systems, and
 pointers to further documentation.