* doc/groff.texinfo: Added section about man macro package

(I've basically taken groff_man.man).  Introducing no indices `ma'
for macros/strings and `gl' for glyph names.  Other minor fixes.

* tmac/groff_man.man: Fixed some typos.

1 files changed, 17 insertions, 11 deletions

diff --git a/tmac/groff_man.man b/tmac/groff_man.man
index 4834f56d..b1cf0fee 100644
--- a/tmac/groff_man.man
+++ b/tmac/groff_man.man
@@ -246,7 +246,7 @@ and
 The macros
 .B RS
 and
-.B RS
+.B RE
 also cause a break but no insertion of vertical space.
 .
 .SH "MACROS TO SET FONTS"
@@ -294,19 +294,25 @@ Causes text on the same line to appear alternately in roman and bold face.
 The text must be on the same line as the macro call.
 .TP
 .BI ".R [" text ]
-Causes text to appear in roman font.
+Causes
+.I text
+to appear in roman font.
 If no text is present on the line where the macro is called, then the text
 of the next line appears in roman.
 This is the default font to which text is returned at the end of processing
 of the other macros.
 .TP
 .BI ".B [" text ]
-Causes text to appear in bold face.
+Causes
+.I text
+to appear in bold face.
 If no text is present on the line where the macro is called, then the text
 of the next line appears in bold face.
 .TP
 .BI ".I [" text ]
-Causes text to appear in italic.
+Causes
+.I text
+to appear in italic.
 If no text is present on the line where the macro is called, then the text
 of the next line appears in italic.
 .
@@ -326,8 +332,8 @@ changed.
 .BI ".PD [" nnn ]
 Adjusts the empty space before a new paragraph (resp. section).
 The optional argument gives the amount of space (default units are `v');
-without parameter, the value is reset to its default value (1 line for tty
-devices, 0.4v otherwise).
+without parameter, the value is reset to its default value (1\ line for tty
+devices, 0.4v\ otherwise).
 This affects the macros
 .BR SH ,
 .BR SS ,
@@ -359,9 +365,9 @@ Left and right quote.
 This is equal to `\e(lq' and `\e(rq', respectively.
 .PP
 If a preprocessor like
-.B tbl
+.B @g@tbl
 or
-.B eqn
+.B @g@eqn
 is needed, it has become usage to make the first line of the man page look
 like this:
 .PP
@@ -372,11 +378,11 @@ like this:
 Note the single space character after the double quote.
 .I word
 consists of letters for the needed preprocessors: `e' for
-.BR eqn ,
+.BR @g@eqn ,
 `r' for
-.BR refer ,
+.BR @g@refer ,
 and `t' for
-.BR table .
+.BR @g@tbl .
 Modern implementations of the
 .B man
 program read this first line and automatically call the right