[groff] 37/49: [docs]: Recast safer mode material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1ff6742cc0b8f4b90dee2b267c76976f7642bd6b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jun 17 06:49:39 2021 +1000

    [docs]: Recast safer mode material.
    
    * man/groff_diff.7.man (Restricted requests): Recast to focus on
      requests familiar to AT&T troff veterans.
    * doc/groff.texi (Implementation Differences): Sync with the foregoing.
---
 doc/groff.texi       |  8 ++++++++
 man/groff_diff.7.man | 14 +++++++++-----
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 8a46ad1..cfb48f4 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -15469,6 +15469,14 @@ with documents written using old versions of 
@code{troff}.  Some GNU
 extensions to @code{troff} have become supported by other
 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}).
+
 @cindex adjustment to both margins, difference from @acronym{AT&T} @code{troff}
 @cindex rivers
 When adjusting to both margins, @acronym{AT&T} @code{troff} at first
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 9d556fd..e4cd6e4 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -943,10 +943,7 @@ inter-word space when a line is adjusted.
 .
 To mitigate risks from untrusted input documents,
 the
-.BR open ,
-.BR opena ,
-.BR pi ,
-.BR pso ,
+.B pi
 and
 .B sy
 requests are disabled by default.
@@ -954,7 +951,14 @@ requests are disabled by default.
 .IR \%@g@troff (@MAN1EXT@)'s
 .B \-U
 option enables the formatter's \[lq]unsafe mode\[rq],
-restoring their function.
+restoring their function
+(and enabling additional
+.I groff
+extension requests,
+.BR open ,
+.BR opena ,
+and
+.BR pso ).
 .
 .
 .\" ====================================================================