gbranden pushed a commit to branch master
in repository groff.
commit b1e220b93cff606f86dc0d0ed3100de495293297
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 10 19:50:59 2026 -0600
[doc,man]: Edit intro to "Environments".
* Speak of "the formatter" when discussing portable *roff features.
* Kick forward reference into a footnote.
* Break input lines in a roff-friendly way.
---
doc/groff.texi.in | 37 +++++++++++++++++++++++--------------
man/groff.7.man | 9 ++++-----
2 files changed, 27 insertions(+), 19 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index f55ed67f3..fea243bb3 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -18854,23 +18854,32 @@ This is \*[xxx].
@section Environments
@cindex environments
-As discussed in @ref{Deferring Output}, environments store most of the
-parameters that determine the appearance of text. A default environment
-named @samp{0} exists when GNU @code{troff} starts up; it is modified by
-formatting-related requests and escape sequences.
+As discussed in @ref{Deferring Output},
+environments store most of the parameters
+that determine the appearance of text.
+A default environment named
+@samp{0}
+exists when the formatter starts up;
+formatting-related requests and escape sequences modify its properties.
@cindex stack
-You can create new environments and switch among them. Only one is
-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.
+You can create new environments and switch among them.
+Only one is 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.@footnote{@xref{Debugging}.}
Environments store the following information.
diff --git a/man/groff.7.man b/man/groff.7.man
index b11d2dd3f..24dd428cd 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -9049,9 +9049,8 @@ Environments store most of the parameters that control
text processing.
A default environment named
.RB \[lq] 0 \[rq]
exists when
-.I @g@troff
-starts up;
-it is modified by formatting-related requests and escape sequences.
+exists when the formatter starts up;
+formatting-related requests and escape sequences modify its properties.
.
.
.P
@@ -9069,8 +9068,8 @@ 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.
+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.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
