[bug #60479] tmac/e.tmac-u is missing .PF macro documented in doc/meref.me

[Dave]

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

                 Summary: tmac/e.tmac-u is missing .PF macro documented in
doc/meref.me
                 Project: GNU troff
            Submitted by: barx
            Submitted on: Thu 29 Apr 2021 09:49:20 AM CDT
                Category: Macro - me
                Severity: 3 - Normal
              Item Group: Incorrect behaviour
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

The Summary section of doc/meref.me documents the following six macros for use
with three preprocessors:

  .GE   end gremlin picture
  .GF   end gremlin picture (with flyback)
  .IE   end ideal picture
  .IF   end ideal picture (with flyback)
  .PE   end pic picture
  .PF   end pic picture (with flyback)

However, tmac/e.tmac-u defines only five of these macros, all but PF.  Ending
a _pic_ block in a -me file with .PF thus results in the warning:

  troff: warning: macro 'PF' not defined

On the other hand, Section 9 (Preprocessor Support) of meref.me also omits
.PF, documenting only the other 5 of these 6 ending macros.  This suggests
that perhaps .PF was not intended to exist, and its presence in the Summary
was merely copy/paste run amok.

But _should_ there be a .PF macro?  Bug #60478 points out that the difference
between .GE and .GF is where the cursor is left, and conjectures that the
difference between .IE and .IF is the same.  It seems like it might be useful
to make the same distinction for how to end a _pic_ segment.  But I know
nothing about how _pic_ works, so can't evaluate whether this makes sense.




    _______________________________________________________

Reply to this item at:

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

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