doc/groff.texi (Strings): Relocate material.

Defining .ds1 in the middle of a large volume of text about features of
strings in general interrupts the flow of the narrative in a bad way.
Push .ds1 to the end of the .ds/.ds1/\* definition material; it is
relatively brief and none of the foregoing discussion is inapplicable.

1 files changed, 19 insertions, 19 deletions

diff --git a/doc/groff.texi b/doc/groff.texi
index 55369e69c..58bea5940 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -10509,25 +10509,6 @@ It is not possible to embed ``real'' newlines in a string.  How breaking
 occurs depends on fill mode as usual, and also upon whether the string
 is interpolated as a string or a macro (see below).
 
-The @code{ds1} request turns off compatibility mode while interpreting a
-string.  To be more precise, a @dfn{compatibility save} input token is
-inserted at the beginning of the string, and a @dfn{compatibility
-restore} input token at the end.
-
-@Example
-.nr xxx 12345
-.ds aa The value of xxx is \\n[xxx].
-.ds1 bb The value of xxx is \\n[xxx].
-.
-.cp 1
-.
-\*(aa
-    @error{} warning: number register '[' not defined
-    @result{} The value of xxx is 0xxx].
-\*(bb
-    @result{} The value of xxx is 12345.
-@endExample
-
 @cindex name space, common, of macros, diversions, and strings
 @cindex common name space of macros, diversions, and strings
 @cindex macros, shared name space with strings and diversions
@@ -10666,6 +10647,25 @@ This is \*[xxx].
 @xref{Gtroff Internals}, for more information.
 @endDefreq
 
+The @code{ds1} request turns off compatibility mode while interpreting a
+string.  To be more precise, a @dfn{compatibility save} input token is
+inserted at the beginning of the string, and a @dfn{compatibility
+restore} input token at the end.
+
+@Example
+.nr xxx 12345
+.ds aa The value of xxx is \\n[xxx].
+.ds1 bb The value of xxx is \\n[xxx].
+.
+.cp 1
+.
+\*(aa
+    @error{} warning: number register '[' not defined
+    @result{} The value of xxx is 0xxx].
+\*(bb
+    @result{} The value of xxx is 12345.
+@endExample
+
 @DefreqList {as, name [@Var{string}]}
 @DefreqListEndx {as1, name [@Var{string}]}
 @cindex appending to a string (@code{as})