[groff] 01/01: Note that .rt can only return to a same-page .mk.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4326318427c95e4f00d974df4aa78fca7b5eaa92
Author: G. Branden Robinson <address@hidden>
Date:   Sun Nov 4 05:36:31 2018 -0500

    Note that .rt can only return to a same-page .mk.
    
        * doc/groff.texi: Note that a page break after a .mk renders .rt
        nilpotent.  Thanks to Dave Kemper for the patch!
    
        man/groff.7.man: Document the fact here as well.
    
        Fixes <https://savannah.gnu.org/bugs/index.php?54915>.
    
        * man/groff.7.man: Also:
        + Mark .mk argument as optional.
        + Make .mk and .rt refer to each other.
        + Split argumentless and argumentful .rt into separate entries.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 doc/groff.texi  |  3 +++
 man/groff.7.man | 18 +++++++++++++++---
 2 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 6bbd687..9677e34 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -11836,6 +11836,9 @@ position which distance from the top of the page is 
@var{dist} (no
 previous call to @code{mk} is necessary in this case).  Default scaling
 indicator is @samp{v}.
 
+If a page break occurs between a @code{mk} request and its
+matching @code{rt} request, the @code{rt} is silently ignored.
+
 Here a primitive solution for a two-column macro.
 
 @Example
diff --git a/man/groff.7.man b/man/groff.7.man
index c48637d..6fd5969 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1990,9 +1990,12 @@ from right margin (default scaling indicator\~\c
 .scaleindicator m ).
 .
 .TPx
-.REQ .mk "register"
+.REQ .mk "\fR[\fPregister\fR]\fP"
 Mark current vertical position in
-.IR register .
+.IR register ,
+or in an internal register used by
+.BR .rt
+if no argument.
 .
 .TPx
 .REQ .mso "file"
@@ -2274,10 +2277,19 @@ Remove
 Restore spacing; turn no-space mode off.
 .
 .TPx
+.REQ .rt
+Return
+.I (upward only)
+to vertical position marked by
+.B .mk
+on the current page.
+.
+.TPx
 .REQ .rt "\[+-]N"
 Return
 .I (upward only)
-to marked vertical place (default scaling indicator\~\c
+to specified distance from the top of the page (default scaling
+indicator\~\c
 .scaleindicator v ).
 .
 .TPx