gbranden pushed a commit to branch master
in repository groff.
commit db49abe9ee9035f248f0893b4a1beb4ce3db8e38
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Dec 15 11:31:42 2024 -0600
[doc,man]: Document `-U` option's effect on `cf`.
Continues commit f0ef2a7074, 8 December.
Also I mildly prefer to say "the formatter" when describing something
that applies fairly generally to *roff implementations, and "GNU troff"
for our extensions and other less universal behavior.
---
doc/groff.texi.in | 26 +++++++++++++++++++++-----
src/roff/troff/troff.1.man | 1 +
2 files changed, 22 insertions(+), 5 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 34f1660be..c1b703091 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -1310,6 +1310,7 @@ and Font Description Files}.) This selection can be
overridden with the
Operate in
@dfn{unsafe mode},
enabling the
+@code{cf},
@code{open},
@code{opena},
@code{pi},
@@ -17684,11 +17685,26 @@ implementations.
@cindex @code{pi} request, disabled by default
@cindex @code{sy} request, disabled by default
-The formatter operates in ``safer'' mode by default; to mitigate risks
-from untrusted input documents, the @code{pi} and @code{sy} requests are
-disabled. GNU @code{troff}'s @option{-U} option enables ``unsafe
-mode'', restoring their function and enabling additional @code{groff}
-extension requests, @code{open}, @code{opena}, and @code{pso}.
+GNU
+@command{troff}
+operates in ``safer'' mode by default;
+to mitigate risks from untrusted input documents,
+the
+@code{cf},
+@code{pi},
+and
+@code{sy}
+requests are disabled.
+GNU
+@command{troff}'s
+@option{-U}
+option enables ``unsafe mode'',
+restoring their function and enabling additional
+@code{groff}
+extension requests,
+@code{open},
+@code{opena},
+and @code{pso}.
@xref{I/O}.
@c ---------------------------------------------------------------------
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 3cb4177ad..227284761 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -477,6 +477,7 @@ see
Operate in
.I unsafe mode,
enabling the
+.BR cf ,
.BR open ,
.BR opena ,
.BR pi ,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
