[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 09/39: [docs]: Tweak introduction to traps.
From: |
G. Branden Robinson |
Subject: |
[groff] 09/39: [docs]: Tweak introduction to traps. |
Date: |
Tue, 31 May 2022 20:32:18 -0400 (EDT) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 09/39: [docs]: Tweak introduction to traps.,
G. Branden Robinson <=