[groff] 06/20: groff(7), groff(1): Relocate material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 70874ec5ae98522ec8b81106fa8b6a893ab622d9
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Nov 19 16:31:17 2022 -0600

    groff(7), groff(1): Relocate material.
    
    Move table of preprocessor tokens from groff(7), which describes the
    language of the GNU troff formatter, to groff(1), which describes the
    groff front-end command and offers a synoptic view of the system,
    notably including preprocessors.
    
    Without a preprocessor to interpret them, these tokens are simply calls
    of (likely undefined) macros.
---
 man/groff.7.man            | 57 ----------------------------------------------
 src/roff/groff/groff.1.man | 50 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+), 57 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 1ec89c1b0..ba634860c 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4135,63 +4135,6 @@ to the stream named
 .LE
 .
 .
-.\" TODO: This doesn't really belong here; these aren't part of the
-.\" (g)roff _language_.  groff(1) may be a better place.
-.br
-.ne 6v
-.\" ====================================================================
-.SH "Preprocessor tokens"
-.\" ====================================================================
-.
-Most preprocessors enclose content between a pair of characteristic
-tokens.
-.
-Such a token must occur at the beginning of an input line and use the
-dot control character.
-.
-Spaces and tabs must not follow the control character or precede the
-end of the input line.
-.
-Deviating from these rules defeats a token's recognition by the
-preprocessor.
-.
-Tokens are generally preserved in preprocessor output and interpreted as
-macro calls subsequently by
-.IR @g@troff .
-.
-The
-.I @g@ideal
-preprocessor is not yet available in
-.IR groff .
-.
-.
-.P
-.TS
-box, center, tab (^);
-c | c | c
-CfCB | CfCB | CfCB.
-preprocessor^starting token^ending token
-=
-@g@chem^.cstart^.cend
-@g@eqn^.EQ^.EN
-grap^.G1^.G2
-@g@grn^.GS^.GE
-.\" Keep the .IF line below the @g@ideal line.
-@g@ideal^.IS^.IE
-^^.IF
-.\" Keep the .PF line below the @g@pic line.
-@g@pic^.PS^.PE
-^^.PF
-^^.PY
-@g@refer^.R1^.R2
-@g@tbl^.TS^.TE
-_
-glilypond^.lilypond start^.lilypond stop
-gperl^.Perl start^.Perl stop
-gpinyin^.pinyin start^.pinyin stop
-.TE
-.
-.
 .\" ====================================================================
 .SH "Escape sequence short reference"
 .\" ====================================================================
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 87d83fe8e..47f99a6b3 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -1023,6 +1023,56 @@ When used,
 it is run before any other preprocessors.
 .
 .
+.P
+Most preprocessors enclose content between a pair of characteristic
+tokens.
+.
+Such a token must occur at the beginning of an input line and use the
+dot control character.
+.
+Spaces and tabs must not follow the control character or precede the
+end of the input line.
+.
+Deviating from these rules defeats a token's recognition by the
+preprocessor.
+.
+Tokens are generally preserved in preprocessor output and interpreted as
+macro calls subsequently by
+.IR @g@troff .
+.
+The
+.I @g@ideal
+preprocessor is not yet available in
+.IR groff .
+.
+.
+.P
+.TS
+box, center, tab (^);
+c | c | c
+CfCB | CfCB | CfCB.
+preprocessor^starting token^ending token
+=
+@g@chem^.cstart^.cend
+@g@eqn^.EQ^.EN
+grap^.G1^.G2
+@g@grn^.GS^.GE
+.\" Keep the .IF line below the @g@ideal line.
+@g@ideal^.IS^.IE
+^^.IF
+.\" Keep the .PF line below the @g@pic line.
+@g@pic^.PS^.PE
+^^.PF
+^^.PY
+@g@refer^.R1^.R2
+@g@tbl^.TS^.TE
+_
+glilypond^.lilypond start^.lilypond stop
+gperl^.Perl start^.Perl stop
+gpinyin^.pinyin start^.pinyin stop
+.TE
+.
+.
 .\" ====================================================================
 .SS "Macro packages"
 .\" ====================================================================