[groff] 25/31: [mm]: Add new `PY` macro for pic flyback support.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9101cecb3b2a7b08f5469497faffc0e2ba5001eb
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Aug 15 00:00:02 2022 -0500

    [mm]: Add new `PY` macro for pic flyback support.
    
    * contrib/mm/m.tmac (PY): Add new macro.
    
      (PE): Replace `init@reset` call with `PY` (and then space by half a
      vee as before).
    
    * contrib/mm/groff_mm.7.man (PY): Document it.
    
    Fixes <https://savannah.gnu.org/bugs/?62900>.
---
 NEWS                      |  3 +++
 contrib/mm/ChangeLog      | 10 ++++++++++
 contrib/mm/groff_mm.7.man | 12 ++++++++++++
 contrib/mm/m.tmac         |  5 ++++-
 4 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/NEWS b/NEWS
index 1ddf66b6f..c3b710950 100644
--- a/NEWS
+++ b/NEWS
@@ -334,6 +334,9 @@ o The m (mm) and s (ms) macro packages no longer manipulate 
the set of
 o The m (mm) and s (ms) macro packages' `R` macros now work analogously
   to their `B` and `I` macros instead of ignoring their arguments.
 
+o The m (mm) package now offers a `PY` macro, which serves the function
+  of `PF` (end pic(1) picture with flyback) from other macro packages.
+
 o The "ptx.tmac" macro file, a counterpart to the GNU coreutils ptx(1)
   command for generating permuted indexes, is now installed.  It has
   long been part of the source distribution.
diff --git a/contrib/mm/ChangeLog b/contrib/mm/ChangeLog
index 9c996bc5d..5e59c6a17 100644
--- a/contrib/mm/ChangeLog
+++ b/contrib/mm/ChangeLog
@@ -1,3 +1,13 @@
+2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * m.tmac (PY): Add new macro.
+       (PE): Replace `init@reset` call with `PY` (and then space by
+       half a vee as before).
+
+       * groff_mm.7.man (PY): Document it.
+
+       Fixes <https://savannah.gnu.org/bugs/?62900>.
+
 2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * m.tmac (@warning, @error): Stop pointlessly using no-break
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 7696bf46d..f085028cb 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -2903,6 +2903,18 @@ mode.
 .
 .
 .TP
+.B PY
+Picture end with flyback.
+.
+Ends a
+.MR @g@pic @MAN1EXT@
+picture,
+returning the vertical position to where it was prior to the picture.
+.
+This is a GNU extension.
+.
+.
+.TP
 .BR R \~\c \" space in roman because we must use 2-font macro with \c
 .RI [ roman-text\~\c
 .RI [ previous-font-text ]]\~.\|.\|.
diff --git a/contrib/mm/m.tmac b/contrib/mm/m.tmac
index b024e22e4..f616292a1 100644
--- a/contrib/mm/m.tmac
+++ b/contrib/mm/m.tmac
@@ -2405,8 +2405,11 @@ in=\\n[.i] fi=\\n[.u] .d=\\n[.d] nl=\\n[nl] pg=\\n[%]
 .      if r ds*format .if !\\n[ds*lvl] .ne (u;\\$1)+1v
 .\}
 ..
-.de PE
+.de PY
 .init@reset
+..
+.de PE
+.PY
 .SP .5
 ..
 .\" ####### module eq #######################################