gbranden pushed a commit to branch master
in repository groff.
commit a4219e5880679cc4e4cd49ad07a75741e834aec3
Author: G. Branden Robinson <g.branden.robin...@gmail.com>
AuthorDate: Thu Feb 27 01:11:37 2025 -0600
doc/groff.texi.in: Clarify `sy` request behavior.
---
doc/groff.texi.in | 20 +++++++++++++-------
1 file changed, 13 insertions(+), 7 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index a5e1c4658..d56b76a53 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -16744,13 +16744,19 @@ is the same as @w{@samp{.pi foo | bar}}.
@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 @var{command} and passes it to
-@cite{system@r{(3)}}. Output produced by the command(s) is not captured
-by GNU @command{troff}.
-
-GNU @command{troff} strips a leading neutral double quote from the
-argument, allowing embedded leading spaces in @var{command}.
+Execute 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).
+GNU
+@command{troff}
+strips a leading leading neutral double quote from
+@var{command},
+which it reads in copy mode
+(recall
+@pxref{Copy Mode}),
+allowing it to contain embedded leading spaces.
@cindex safer mode
@cindex mode, safer
_______________________________________________
groff-commit mailing list
groff-commit@gnu.org
https://lists.gnu.org/mailman/listinfo/groff-commit
