[groff] 08/12: [doc,man]: Clarify and parallelize "Strings" secs.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 2c037586cd6df32e3d72a110a756ca04dcd21eca
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Dec 19 13:00:20 2024 -0600

    [doc,man]: Clarify and parallelize "Strings" secs.
    
    The `ds` request handler is no longer even close to unique in the way it
    parses the remainder of the input line.
---
 doc/groff.texi.in | 16 +++++++++++-----
 man/groff.7.man   |  4 +---
 2 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index ff7176bea..3fd9b3cfd 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12665,11 +12665,17 @@ Gray codes are explored in \*[cite Morgan 1998].
 @cindex trailing spaces in string definitions and appendments
 @cindex comments, with @code{ds}
 @cindex @code{ds} request, and comments
-@strong{Caution:@:} The @code{ds} request, unlike others, treats the
-remainder of the input line as its second argument, including trailing
-spaces.  This means that comments on a line with such a request can
-introduce unwanted space into a string when they are set off from the
-material they annotate, as is conventional.
+@strong{Caution:@:}
+The
+@code{ds}
+request treats the remainder of the input line as its second argument,
+including trailing spaces.
+Ending string definitions
+(and appendments)
+with a comment,
+even an empty one,
+prevents unwanted space from creeping into them during source document
+maintenance.
 
 @Example
 .ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O \" water
diff --git a/man/groff.7.man b/man/groff.7.man
index fdcb7d97a..cdadb8081 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6177,9 +6177,7 @@ string is later interpolated.
 .I Caution:
 The
 .B ds
-request,
-unlike others,
-treats the remainder of the input line as its second argument,
+request treats the remainder of the input line as its second argument,
 including trailing spaces.
 .
 Ending string definitions