gbranden pushed a commit to branch master
in repository groff.
commit 1b9dd6e1d0bc79e55a89552092849af315f19daf
Author: G. Branden Robinson <[email protected]>
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}})
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
