[groff] 11/26: [docs]: Tighten `string{down,up}` description.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 586bc60bd4c5ef81a691f1e7ad73458d2e18494f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Dec 17 13:21:13 2022 -0600

    [docs]: Tighten `string{down,up}` description.
---
 NEWS                 |  4 ++--
 doc/groff.texi       | 11 +++++------
 man/groff_diff.7.man | 10 ++++++----
 3 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/NEWS b/NEWS
index d1cf9358f..1010976be 100644
--- a/NEWS
+++ b/NEWS
@@ -71,8 +71,8 @@ o New requests `stringdown` and `stringup` are available.  
These change
   its lowercase or uppercase version (if any), respectively.  groff
   special characters (see the groff_char(7) man page) in the string will
   often transform in the expected way due to the regular naming
-  convention of the special character escape sequences for accented
-  letters.  When they do not, use substrings and/or concatenation.
+  convention for accented letters.  When they do not, use substrings
+  and/or catenation.
 
 o The `ab` request no longer writes "User Abort." to the standard error
   stream if given no arguments.
diff --git a/doc/groff.texi b/doc/groff.texi
index 370dec978..9b9cd3c19 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -12315,12 +12315,11 @@ index@tie{}@minus{}2, and so on.
 @cindex lowercasing a string (@code{stringdown})
 @cindex up-casing a string (@code{stringup})
 @cindex down-casing a string (@code{stringdown})
-Alter the string named @var{str} by replacing each of its bytes with
-its lowercase (@code{stringdown}) or uppercase (@code{stringup}) version
-(if one exists).  GNU @code{troff} special characters (see the
-@cite{groff_char@r{(7)}} man page) can be used and the output will
-usually transform in the expected way due to the regular glyph naming
-convention for accented characters.
+Alter the string named @var{str} by replacing each of its bytes with its
+lowercase (@code{stringdown}) or uppercase (@code{stringup}) version (if
+one exists).  Special characters in the string will often transform in
+the expected way due to the regular naming convention for accented
+characters.  When they do not, use substrings and/or catenation.
 
 @Example
 .ds resume R\['e]sum\['e]
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 9f1a9dfe7..dbee7b6b2 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3269,12 +3269,14 @@ or uppercase
 version
 (if one exists).
 .
-.I groff
-special characters
+Special characters
 (see
 .MR groff_char @MAN7EXT@ )
-can be used and the output will usually transform in the expected way
-due to the regular glyph naming convention for accented characters.
+will often transform in the expected way due to the regular naming
+convention for accented characters.
+.
+When they do not,
+use substrings and/or catenation.
 .
 .IP
 .RS