groff-commit
[Top][All Lists]
Advanced

[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 ,



reply via email to

[Prev in Thread] Current Thread [Next in Thread]