[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 16/16: [doc,man]: Document `-U` option's effect on `cf`.
From: |
G. Branden Robinson |
Subject: |
[groff] 16/16: [doc,man]: Document `-U` option's effect on `cf`. |
Date: |
Sun, 15 Dec 2024 16:34:41 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit db49abe9ee9035f248f0893b4a1beb4ce3db8e38
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
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 ,
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 16/16: [doc,man]: Document `-U` option's effect on `cf`.,
G. Branden Robinson <=