[groff] 03/12: groff(7): Revise syntax reference substituends.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit ab7beedb1ee27b962d2eaa7aaa5f4f926be45cb6
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Nov 10 02:42:19 2023 -0600

    groff(7): Revise syntax reference substituends.
---
 man/groff.7.man | 73 +++++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 61 insertions(+), 12 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 8c0d3949a..9828bd2a4 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2241,16 +2241,11 @@ A few denotations may require introduction.
 .RS
 .
 .TPx
-.I c
-denotes a single input character.
-.
-.TPx
-.I font
-a font either specified as a font name or a numeric mounting position.
-.
-.TPx
 .I anything
-all characters up to the end of the line,
+includes all characters up to the end of the input line
+(which may be continued with
+.BI \[rs] newline\c
+),
 to the ending delimiter for the escape sequence,
 or within
 .esc {
@@ -2258,9 +2253,43 @@ and
 .esc } .
 .
 Escape sequences may generally be used freely in
-.IR anything ,
+.I anything,
 except when it is read in copy mode.
 .
+Comments are ignored;
+trailing whitespace generally is not.
+.
+.TPx
+.I c
+denotes a single input character,
+ordinary or special.
+.
+.TPx
+.I div
+is a diversion.
+.
+.TPx
+.I env
+is an environment.
+.
+.TPx
+.I font
+is a typeface specified as a font name,
+an abstract style,
+or a mounting position.
+.
+.TPx
+.I ident
+is a valid
+.I groff
+identifier;
+its use often indicates that the operation creates an object of a type
+subsequently referred to as
+.I mac,
+.I reg,
+.I str,
+and so forth.
+.
 .TPx
 .I message
 is a character sequence to be emitted on the standard error stream.
@@ -2274,6 +2303,18 @@ interpreted.
 is a numeric expression that evaluates to a non-negative integer.
 .
 .TPx
+.I \[+-]N
+is a numeric expression with a meaning dependent on its sign;
+see below.
+.
+.TPx
+.I name
+is a macro,
+string,
+request,
+or diversion.
+.
+.TPx
 .I npl
 is a numeric expression constituting a count of subsequent
 .I productive
@@ -2291,8 +2332,16 @@ Macro calls are not themselves productive,
 but their interpolated contents can be.
 .
 .TPx
-.I \[+-]N
-is a numeric expression with a meaning dependent on its sign.
+.I reg
+is a register.
+.
+.TPx
+.I str
+is a string.
+.
+.TPx
+.I stream
+is an output stream.
 .RE
 .LE
 .