gbranden pushed a commit to branch master
in repository groff.
commit 8c49dc3ddb37863bc85e2a843f28653b58a04ea3
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Aug 23 09:30:11 2026 -0500
doc/groff.texi.in: Revise `rd` request desc.
* Revise example.
* Break input lines in convenient places for roffing and diffing.
---
doc/groff.texi.in | 18 +++++++++++++-----
1 file changed, 13 insertions(+), 5 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index c8db1262e..1aaa951f5 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -22110,11 +22110,17 @@ Body of letter.
@cindex @code{ex} request, used with @code{nx} and @code{rd}
@noindent
-When this is run, a file containing the following lines should be
-redirected in. Requests included in this file are executed as though
-they were part of the form letter. The last block of input is the
-@code{ex} request, which tells GNU @code{troff} to stop processing. If
-this were not there, @code{troff} would not know when to stop.
+When the foregoing runs,
+redirect standard input from a file like that shown below to
+@command{troff}. @c generic
+The formatter executes any requests it contains
+as though they were part of the form letter.
+The last line of the file is an
+@code{ex}
+request,
+which tells the formatter to stop processing.
+If it were absent,
+the formatter would hang awaiting further input.
@Example
Trent A. Fisher
@@ -22149,12 +22155,14 @@ Multiple
@code{pi}
requests construct a multi-stage pipeline
in the same order as the formatter encounters the requests.
+Thus,
@Example
.pi foo
.pi bar
@endExample
+@noindent
is the same as
@w{@samp{.pi foo | bar}}.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
