gbranden pushed a commit to branch master
in repository groff.
commit 106b723565573b72deab72bbf83ff220f41b82ed
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Jan 4 11:08:54 2026 -0600
[doc,man]: Slightly revise "Traps" section.
Present the definition of the "implicit page trap" in the same sentence
we introduce the term.
Sync wording between our Texinfo manual and man page.
Also break input lines in a roff-friendly way.
---
doc/groff.texi.in | 28 ++++++++++++++++++++--------
man/groff.7.man | 7 ++++---
2 files changed, 24 insertions(+), 11 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 01771b96e..888027492 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -17684,14 +17684,26 @@ every output line your document produces, and once
the value of
something trap-like happens---the page is ejected, a new one begins, and
the value of @code{.t} becomes large once more.
-This @dfn{implicit page trap} always exists in the top-level
-diversion;@footnote{@xref{Diversions}.} it works like a trap in some
-ways but not others. Its purpose is to eject the current page and start
-the next one. It has no name, so it cannot be moved or deleted with
-@code{wh} or @code{ch} requests. You cannot hide it by placing another
-trap at its location, and can move it only by redefining the page length
-with @code{pl}. Its operation is suppressed when vertical page traps
-are disabled with GNU @code{troff}'s @code{vpt} request.
+This
+@dfn{implicit page trap}
+always exists in the top-level diversion;@footnote{@xref{Diversions}.}
+its purpose is to eject the current page and start the next one.
+It works like a trap in some ways but not others.
+It has no name,
+so it cannot be moved or deleted with
+@code{wh}
+or
+@code{ch}
+requests.
+You cannot hide it by placing another trap at its location,
+and can move it only by redefining the page length with
+@code{pl}.
+Its operation is suppressed when vertical page traps are disabled
+with
+GNU
+@code{troff}'s @c GNU
+@code{vpt}
+request.
@c END Keep (roughly) parallel with subsection "The implicit trap" of
@c groff(7).
diff --git a/man/groff.7.man b/man/groff.7.man
index a1d31c992..08bf663f8 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -8759,9 +8759,9 @@ An
.I implicit page trap
always exists in the top-level diversion
(see below);
-it works like a trap in some ways but not others.
+its purpose is to eject the current page and start the next one.
.
-Its purpose is to eject the current page and start the next one.
+It works like a trap in some ways but not others.
.
It has no name,
so it cannot be moved or deleted with
@@ -8775,7 +8775,8 @@ and can move it only by redefining the page length with
.BR pl .
.
Its operation is suppressed when vertical page traps are disabled with
-the
+GNU
+.I troff's \" GNU
.B vpt
request.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
