gbranden pushed a commit to branch master
in repository groff.
commit b99ddc2bbd4dd477010bacffa9ec25bb7491f31e
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Aug 23 09:59:25 2026 -0500
doc/groff.texi.in: Revise `sy` request desc.
* When presenting multiple requests or requests stacked with other
syntax items, more scrupulously name the item we're discussing first.
* Tighten wording.
---
doc/groff.texi.in | 17 +++++++++++------
1 file changed, 11 insertions(+), 6 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 1aaa951f5..7ceaceb1f 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -22217,11 +22217,13 @@ for maintaining the validity of the input to the
output driver.
@cindex running system commands
@DefreqList {sy, [@code{"}]@Var{command}}
@DefregListEndx {systat}
-Execute the specified shell command(s).
-The formatter reads the remainder of the input line into a buffer
+The
+@code{sy}
+request executes the specified shell command(s).
+The formatter reads the remainder of the input line into a buffer,
and passes it to
-@cite{system@r{(3)}}.
-The formatter does not capture the output produced by the command(s).
+@cite{system@r{(3)}}
+without capturing the output produced by the command(s).
@cindex safer mode
@cindex mode, safer
@@ -22249,12 +22251,15 @@ are esoteric;
the request interpolates
neither the standard output nor the standard error streams of
@var{command}
-into the document---worse,
+into the document.
+Worse,
@acronym{AT&T}
@command{troff} @c AT&T
afforded no means of verifying that
@var{command}
-operated as expected.
+operated as expected---thus the
+GNU
+@code{systat} register extension.
We therefore offer a silly example of its use,
making a document refuse to format if the system user name
running the formatter is
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
