[groff] 36/49: [docs]: Clarify "transparent" in one of its uses.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 45c275e0acd486bbff61fb83896a77313079d923
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jun 17 06:42:24 2021 +1000

    [docs]: Clarify "transparent" in one of its uses.
    
    As with "special", groff documentation loads a lot of freight onto this
    word, and sends the cars to multiple destinations.  Give the reader a
    fighting chance to understand which sense is meant.
---
 doc/groff.texi       | 7 ++++---
 man/groff_diff.7.man | 4 ++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 8f9eea7..8a46ad1 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -15631,9 +15631,10 @@ arguments, but not in compatibility mode.
 @cindex @code{\s}, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{\S}, incompatibilities with @acronym{AT&T} @code{troff}
 Furthermore, the escapes @code{\f}, @code{\H}, @code{\m}, @code{\M},
-@code{\R}, @code{\s}, and @code{\S} are transparent for recognizing the
-beginning of a line only in compatibility mode.  For example, this code
-produces bold output in both cases, but the text differs.
+@code{\R}, @code{\s}, and @code{\S} are transparent for the purpose of
+recognizing a control character at the beginning of a line only in
+compatibility mode.  For example, this code produces bold output in both
+cases, but the text differs.
 
 @Example
 .de xx
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 96633f4..9d556fd 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4912,8 +4912,8 @@ the escapes
 .BR \[rs]s ,
 and
 .B \[rs]S
-are transparent for recognizing the beginning of a line only in
-compatibility mode.
+are transparent for the purpose of recognizing a control character at
+the beginning of a line only in compatibility mode.
 .
 For example,
 this code produces bold output in both cases,