[groff] 07/07: [docs]: Revise discussion of environments.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f11a90efa1f21ab9dfac0981236a973d14bbcb87
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Dec 28 23:10:30 2022 -0600

    [docs]: Revise discussion of environments.
    
    Document association with .cdp, .cht, .csk, .n, .w registers.
    
    Align usage of terminology with post-1.22.4 reforms.
---
 doc/groff.texi  | 35 +++++++++++++++++++----------------
 man/groff.7.man | 41 ++++++++++++++++++++++++++---------------
 2 files changed, 45 insertions(+), 31 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index f321fe9af..cd67b742b 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -15305,35 +15305,38 @@ current at any given time.  Active environments are 
managed using a
 @dfn{stack}, a data structure supporting ``push'' and ``pop''
 operations.  The current environment is at the top of the stack.
 The same environment name can be pushed onto the stack multiple times,
-possibly interleaved with others.
-
-Popping the environment stack does not destroy the current environment;
-it remains accessible by name and can be made current again by pushing
-it at any time.  Environments cannot be renamed or deleted, and can only
-be modified when current.  To inspect the environment stack, use the
-@code{pev} request; see @ref{Debugging}.
+possibly interleaved with others.  Popping the environment stack does
+not destroy the current environment; it remains accessible by name and
+can be made current again by pushing it at any time.  Environments
+cannot be renamed or deleted, and can only be modified when current.  To
+inspect the environment stack, use the @code{pev} request; see
+@ref{Debugging}.
 
 Environments store the following information.
 
 @itemize @bullet
 @item
-typeface parameters (size, family, style, glyph height and slant,
-inter-word and inter-sentence space sizes)
+a partially collected line, if any
 
 @item
-page parameters (line length, title length, vertical spacing, line
-spacing, indentation, line numbering, centering, right-justifying,
-underlining, hyphenation data)
+data about the most recently output glyph and line (registers
+@code{.cdp}, @code{.cht}, @code{.csk}, @code{.n}, @code{.w})
 
 @item
-filling enablement, adjustment enablement and mode
+typeface parameters (size, family, style, height and slant, inter-word
+and inter-sentence space sizes)
+
+@item
+page parameters (line length, title length, vertical spacing, line
+spacing, indentation, line numbering, centering, right-alignment,
+underlining, hyphenation parameters)
 
 @item
-tab stops; tab and leader characters; escape, control, no-break control,
-hyphenation control, and margin characters
+filling enablement; adjustment enablement and mode
 
 @item
-partially collected lines
+tab stops; tab, leader, escape, control, no-break control, hyphenation,
+and margin characters
 
 @item
 input traps
diff --git a/man/groff.7.man b/man/groff.7.man
index cbb8327b1..2b9bab667 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6633,8 +6633,6 @@ The current environment is at the top of the stack.
 The same environment name can be pushed onto the stack multiple times,
 possibly interleaved with others.
 .
-.
-.P
 Popping the environment stack does not destroy the current environment;
 it remains accessible by name and can be made current again by pushing
 it at any time.
@@ -6654,11 +6652,25 @@ Environments store the following information.
 .
 .
 .IP \[bu] 2n
+a partially collected line, if any
+.
+.
+.IP \[bu]
+data about the most recently output glyph and line
+(registers
+.BR .cdp ,
+.BR .cht ,
+.BR .csk ,
+.BR .n ,
+.BR .w )
+.
+.
+.IP \[bu]
 typeface parameters
 (size,
 family,
 style,
-glyph height and slant,
+height and slant,
 inter-word and inter-sentence space sizes)
 .
 .
@@ -6667,31 +6679,30 @@ page parameters
 (line length,
 title length,
 vertical spacing,
-line
-spacing,
+line spacing,
 indentation,
 line numbering,
 centering,
-right-justifying,
+right-alignment,
 underlining,
-hyphenation data)
+hyphenation parameters)
 .
 .
 .IP \[bu]
-filling enablement,
+filling enablement;
 adjustment enablement and mode
 .
 .
 .IP \[bu]
-tab stops; tab and leader characters; escape,
+tab stops;
+tab,
+leader,
+escape,
 control,
 no-break control,
-hyphenation control,
-and margin characters
-.
-.
-.IP \[bu]
-partially collected lines
+hyphenation,
+and
+margin characters
 .
 .
 .IP \[bu]