[groff] 02/04: man/groff.7.man: Improve preprocessor discussion.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit bc256347015f3793f929fdb218ecc07f1052bedd
Author: G. Branden Robinson <address@hidden>
Date:   Sun Nov 19 18:34:39 2017 -0500

    man/groff.7.man: Improve preprocessor discussion.
    
    * Use more idiomatic English.
    * Fix command names to use @g@ command prefix for preprocessors that
      (might) use them.
    * Repair ordering problem involving the "ideal" .IF macro's placement in
      the table, and add a comment in an effort to prevent the mistake from
      recurring.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 man/groff.7.man | 37 +++++++++++++++++++------------------
 1 file changed, 19 insertions(+), 18 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index c9d3f44..643972f 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2615,37 +2615,38 @@ for an overview) or from a preprocessor.
 .
 .
 .P
-Preprocessor macros are easy to be recognized.
+Preprocessor macros are to recognize.
 .
-They enclose their code into a pair of characteristic macros.
+They enclose their code between a pair of characteristic macros.
 .
 .
 .P
 .TS
-box, center, tab (@);
+box, center, tab (^);
 c | c | c
 CfCB | CfCB | CfCB.
address@hidden macro@ end macro
+preprocessor^start macro^ end macro
 =
address@hidden@.cend
address@hidden@.EN
address@hidden@.IE
address@hidden@.G2
address@hidden@.GE
-@@.IF
address@hidden@.PE
address@hidden@.R2
address@hidden@\f[I]none
address@hidden@.TE
address@hidden@chem^.cstart^.cend
address@hidden@eqn^.EQ^.EN
+grap^.G1^.G2
address@hidden@grn^.GS^.GE
+.\" Keep the .IF line below the @address@hidden line.
address@hidden@ideal^.IS^.IE
+^^.IF
address@hidden@pic^.PS^.PE
address@hidden@refer^.R1^.R2
address@hidden@soelim^\f[I]none^\f[I]none
address@hidden@tbl^.TS^.TE
 _
address@hidden address@hidden stop
address@hidden address@hidden stop
address@hidden address@hidden stop
+glilypond^.lilypond start^.lilypond stop
+gperl^.Perl start^.Perl stop
+gpinyin^.pinyin start^.pinyin stop
 .TE
 .
 .
 .P
-Note that the \[oq]ideal\[cq] preprocessor is not available in groff
+Note that the address@hidden@ideal\[cq] preprocessor is not available in groff
 yet.
 .
 .