[bug #64575] doc/pic.ms: document .PY

[Dave]

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

                 Summary: doc/pic.ms: document .PY
                   Group: GNU roff
               Submitter: barx
               Submitted: Sun 20 Aug 2023 10:48:31 AM CDT
                Category: Preprocessor pic
                Severity: 2 - Minor
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Sun 20 Aug 2023 10:48:31 AM CDT By: Dave <barx>
Bug #62901 introduced a pic .PY macro, and documented it in pic(1).

A year later, [http://git.savannah.gnu.org/cgit/groff.git/commit/?id=a953791a
commit a953791a] also documented it in pic2graph(1) -- which made me realize
it was never documented in the GNU pic manual, doc/pic.ms.  The attached patch
remedies that (stealing some wording from pic(1)).

Additionally, it:
* removes a "(1)" suffix that implied "ms" is a shell command.
* fixes a wordo: s/macro pages/macro packages/
* Changes the .PY definition in tmac/pic.tmac to call to .PF rather than
duplicating its (three bytes of) code.  This is almost too trivial to DRY,
but
        * the new form is a cue to the human reader that .PY is meant to be an 
alias
of .PF; and
        * .PE was already defined as a variant of .PF with an explicit call to 
it, so
this makes the .PY definition conform to that precedent.






    _______________________________________________________
File Attachments:


-------------------------------------------------------
Date: Sun 20 Aug 2023 10:48:31 AM CDT  Name: 64575.patch  Size: 3KiB   By:
barx

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

    _______________________________________________________

Reply to this item at:

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

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