[groff] 01/04: doc/groff.texi (Strings): Relocate material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit f1b67b7201464beab4ee8c25b311c3ff5d545a6a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jul 31 19:54:46 2020 +1000

    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.
---
 doc/groff.texi | 38 +++++++++++++++++++-------------------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 55369e6..58bea59 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})