[bug #63159] [ms] bracketing a section heading with a keep can record wrong page # for TOC

[G. Branden Robinson]

URL:
  <https://savannah.gnu.org/bugs/?63159>

                 Summary: [ms] bracketing a section heading with a keep can
record wrong page # for TOC
                 Project: GNU troff
               Submitter: gbranden
               Submitted: Wed 05 Oct 2022 06:47:20 AM UTC
                Category: Macro ms
                Severity: 3 - Normal
              Item Group: Incorrect behaviour
                  Status: Postponed
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Wed 05 Oct 2022 06:47:20 AM UTC By: G. Branden Robinson <gbranden>
I don't have a minimal reproducer yet, but encountered this issue while
working on _doc/ms.ms_.

I'm attaching the current version the file from my working copy.  Here is the
relevant portion.


Documents that need to determine whether they are being formatted with
.I "groff ms"
or another implementation should test this register.
.
.
.\" XXX: We can't use a keep here because the wrong page number will be
.\" recorded in the table of contents.
.KS
.NH 2
Unix Version\~7
.BI ms
macros not implemented by
.BI "groff ms"
.XS
        Unix Version 7
.I ms
macros not implemented by
.I "groff ms"
.XE
.LP
Several macros described in the Unix Version\~7
.I ms
documentation are unimplemented by
.I "groff ms"
because they are specific to the requirements of documents produced
internally by Bell Laboratories,
some of which also require a glyph for the Bell System logo that
.I groff
does not support.
...
For informal purposes,
a simple definition of
.CW UX
should maintain the readability of the document's substance.
.
.
.TS
box center;
lf(CR).
\&.rm UX
\&.ds UX Unix\[rs]"
.TE
.KE


Thanks to the keep, the section doesn't start until page 24, but the TOC
records it as occurring on page 23.

Also affects groff 1.22.4.  Likely quite old.

Punting past 1.23.






    _______________________________________________________
File Attachments:


-------------------------------------------------------
Date: Wed 05 Oct 2022 06:47:20 AM UTC  Name: ms.ms  Size: 70KiB   By: gbranden

<http://savannah.gnu.org/bugs/download.php?file_id=53794>

    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?63159>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/