[groff] 09/39: [docs]: Tweak introduction to traps.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 5663a54466621371fed19a29f029b9cd996db10a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun May 29 15:20:47 2022 -0500

    [docs]: Tweak introduction to traps.
    
    * Strictly, macros are "passed" arguments rather than "containing" them.
    * Emphasize that "planting" is a transitive verb in this sense.
    * Traps are sprung when their condition is fulfilled, not when their
      macro is called, because multiple traps can call the same macro and a
      macro associated with a trap can also be called normally.
---
 doc/groff.texi  | 7 +++----
 man/groff.7.man | 7 ++++---
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 64bc6b29..67b47a7e 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -13887,14 +13887,13 @@ traps can occur at a given location on the page, at a 
given location in
 the current diversion (together, these are known as @emph{vertical
 position traps}), at a blank line, at a line with leading space
 characters, after a quantity of input lines, or at the end of input.
-Macros called by traps have no arguments.
+Macros called by traps are passed no arguments.
 @cindex planting a trap
 @cindex trap, planting
-Setting a trap is also called @dfn{planting}.
+Setting a trap is also called @dfn{planting} one.
 @cindex trap, springing
 @cindex springing a trap
-It is said that a trap is @dfn{sprung} if the associated macro is
-called.
+It is said that a trap is @dfn{sprung} if its condition is fulfilled.
 
 @menu
 * Vertical Position Traps::
diff --git a/man/groff.7.man b/man/groff.7.man
index 542bcd56..060a28ff 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5866,14 +5866,15 @@ after a certain number of input lines
 or at the end of input
 .RB ( .em ).
 .
-Macros called by traps have no arguments.
+Macros called by traps are passed no arguments.
 .
 Setting a trap is also called
-.IR planting .
+.I planting
+one.
 .
 It is said that a trap is
 .I sprung
-if the associated macro is called.
+if its condition is fulfilled.
 .
 .
 .P