[groff] 04/11: tmac/an-old.tmac: Plant an-footer trap at 2*\n(FT.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 58c681aa735596cc6cb1de4d5d4c42ec762a2bbb
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon May 17 12:06:00 2021 +1000

    tmac/an-old.tmac: Plant an-footer trap at 2*\n(FT.
    
    * tmac/an-old.tmac (TH): Plant the an-footer trap (where we schedule a
      break in the page text prior to spacing down to the footer) at twice
      the value of \n[FT], not a hard-coded -1i.  This way, the user can't
      make the an-p-footer trap (planted at \n[FT]) spring before the
      an-footer trap that should precede it.
    
    * tmac/groff_man.7.man.in (Options) <-rFT>: Document this.
---
 ChangeLog               | 10 ++++++++++
 tmac/an-old.tmac        |  2 +-
 tmac/groff_man.7.man.in |  3 +++
 3 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 150c9fc..e08be06 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2021-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * tmac/an-old.tmac (TH): Plant the an-footer trap (where we
+       schedule a break in the page text prior to spacing down to the
+       footer) at twice the value of \n[FT], not a hard-coded -1i.
+       This way, the user can't make the an-p-footer trap (planted at
+       \n[FT]) spring before the an-footer trap that should precede it.
+
+       * tmac/groff_man.7.man.in (Options) <-rFT>: Document this.
+
 2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK): Add new
diff --git a/tmac/an-old.tmac b/tmac/an-old.tmac
index b1e9a27..56ada26 100644
--- a/tmac/an-old.tmac
+++ b/tmac/an-old.tmac
@@ -227,7 +227,7 @@
 .
 .  if !\\n[cR] \{\
 .    wh 0 an-header
-.    wh -1i an-footer
+.    wh (2u * \\n[FT]u) an-footer
 .    wh \\n[FT]u an-p-footer
 .    \}
 .  \}
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 61e7b52..bf8fbe9 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -2984,6 +2984,9 @@ relative to the bottom of the page if negative or top if 
positive,
 to
 .IR footer-distance .
 .
+At twice this distance,
+the page text is broken before writing the footer.
+.
 Ignored if continuous rendering is enabled.
 .
 The default is \-0.5i.