[groff] 04/19: doc/groff.texi: Relocate material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1b9dd6e1d0bc79e55a89552092849af315f19daf
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Nov 7 20:59:57 2021 +1100

    doc/groff.texi: Relocate material.
    
    I don't think it is a good idea to discuss and present examples of the
    '|' positioning operating operator in the midst of the discussion of
    line continuiation, which is challenging enough.  Coalesce.
    
    The discussion of '+' and '-' as prefix operators was similarly split by
    the introduction of '|'.  Coalesce.
---
 doc/groff.texi | 86 +++++++++++++++++++++++++++++-----------------------------
 1 file changed, 43 insertions(+), 43 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index c81474c..2ef51e1 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5703,14 +5703,6 @@ For many requests that cause a motion on the page, the 
unary operators
 then indicate a motion relative to the current position (down or up,
 respectively).
 
-@cindex @code{|}, and page motion
-@cindex absolute position operator (@code{|})
-@cindex position, absolute, operator (@code{|})
-Similarly, a leading @samp{|} operator indicates an absolute position.
-For vertical movements, it specifies the distance from the top of the
-page; for horizontal movements, it gives the distance from the beginning
-of the @emph{input} line.
-
 @cindex @code{bp} request, using @code{+} and@tie{}@code{-} with
 @cindex @code{in} request, using @code{+} and@tie{}@code{-} with
 @cindex @code{ll} request, using @code{+} and@tie{}@code{-} with
@@ -5735,6 +5727,49 @@ Here, leading plus and minus signs indicate increments 
and decrements.
 
 @xref{Setting Registers}, for some examples.
 
+@cindex @code{|}, and page motion
+@cindex absolute position operator (@code{|})
+@cindex position, absolute, operator (@code{|})
+Similarly, a leading @samp{|} operator indicates an absolute position.
+For vertical movements, it specifies the distance from the top of the
+page; for horizontal movements, it gives the distance from the beginning
+of the @emph{input} line.
+
+Many escapes use positioning relative to the input line.  For example,
+this
+
+@Example
+This is a \h'|1.2i'test.
+
+This is a
+\h'|1.2i'test.
+@endExample
+
+@noindent
+produces
+
+@Example
+This is a   test.
+
+This is a             test.
+@endExample
+
+The main usage of this feature is to define macros that act exactly at
+the place where called.
+
+@Example
+.\" A simple macro to underline a word
+.de underline
+.  nop \\$1\l'|0\[ul]'
+..
+@endExample
+
+@noindent
+In the above example, @samp{|0} specifies a negative distance from the
+current position (at the end of the just emitted argument @code{\$1})
+back to the beginning of the input line.  Thus, the @samp{\l} escape
+draws a line from right to left.
+
 @Defesc {\\B, @code{'}, anything, @code{'}}
 @cindex numeric expression, valid
 @cindex valid numeric expression
@@ -8985,41 +9020,6 @@ collected line still uses the old line length value.
 It is important to understand how @code{gtroff} handles input and output
 lines.
 
-Many escapes use positioning relative to the input line.  For example,
-this
-
-@Example
-This is a \h'|1.2i'test.
-
-This is a
-\h'|1.2i'test.
-@endExample
-
-@noindent
-produces
-
-@Example
-This is a   test.
-
-This is a             test.
-@endExample
-
-The main usage of this feature is to define macros that act exactly at
-the place where called.
-
-@Example
-.\" A simple macro to underline a word
-.de underline
-.  nop \\$1\l'|0\[ul]'
-..
-@endExample
-
-@noindent
-In the above example, @samp{|0} specifies a negative distance from the
-current position (at the end of the just emitted argument @code{\$1})
-back to the beginning of the input line.  Thus, the @samp{\l} escape
-draws a line from right to left.
-
 @cindex input line continuation (@code{\@key{RET}})
 @cindex line, input, continuation (@code{\@key{RET}})
 @cindex continuation, input line (@code{\@key{RET}})