[groff] 03/17: [me]: Improve docs of image-inclusion macros.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1d212a1b32e85ee12f228571a990e61bee6af16a
Author: Dave Kemper <saint.snit@gmail.com>
AuthorDate: Tue May 4 20:09:21 2021 +0000

    [me]: Improve docs of image-inclusion macros.
    
    Fixes <https://savannah.gnu.org/bugs/?60478>.
---
 ChangeLog    |  6 ++++++
 doc/meref.me | 36 +++++++++++++++++++++++++-----------
 2 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 57b60c3..02e9050 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -7,6 +7,12 @@
 
 2021-08-06  Dave Kemper <saint.snit@gmail.com>
 
+       * doc/meref.me: Improve documentation of image-inclusion macros.
+
+       Fixes <https://savannah.gnu.org/bugs/?60478>.
+
+2021-08-06  Dave Kemper <saint.snit@gmail.com>
+
        GNU pic recognizes two possible endings of a pic block: .PE or
        .PF.  This fact was documented in doc/pic.ms but not in the pic
        man page.  The minimal pic implementation provided by pic.tmac
diff --git a/doc/meref.me b/doc/meref.me
index dcc06b9..dc622b9 100644
--- a/doc/meref.me
+++ b/doc/meref.me
@@ -1492,7 +1492,17 @@ both in basic units.
 .TL
 .b .PE
 .DE
-End picture.
+End
+.i pic
+picture,
+leaving the current position at the bottom of the picture.
+.TL
+.b .PF
+.DE
+End
+.i pic
+picture,
+leaving the current position at the top of the picture.
 .TL
 .b .IS
 .DE
@@ -1504,13 +1514,15 @@ picture.
 .DE
 End
 .i ideal
-picture.
+picture,
+leaving the current position at the bottom of the picture.
 .TL
 .b .IF
 .DE
 End
 .i ideal
-picture (alternate form).
+picture,
+leaving the current position at the top of the picture.
 .TL
 .b .GS
 .i x
@@ -1532,13 +1544,15 @@ Default is centering the image.
 .DE
 End
 .i gremlin
-picture.
+picture,
+leaving the current position at the bottom of the picture.
 .TL
 .b .GF
 .DE
 End
 .i gremlin
-picture (alternate form).
+picture,
+leaving the current position at the top of the picture.
 .sh 1 "Miscellaneous"
 .TL
 .b .re
@@ -2044,14 +2058,14 @@ NAME    TYPE    DESCRIPTION
 \&.EN  M       end equation
 \&.EQ  M       begin equation
 \eL\'\fI\&d\fP\'       F\(sc   vertical line drawing function for distance 
\fI\&d\fP
-\&.GE  M\(de   end \fIgremlin\fP picture
-\&.GF  M\(de   end \fIgremlin\fP picture (with flyback)
+\&.GE  M\(de   end \fIgremlin\fP picture with position at bottom
+\&.GF  M\(de   end \fIgremlin\fP picture with position at top
 \&.GS  M\(de   start \fIgremlin\fP picture
-\&.IE  M\(de   end \fIideal\fP picture
-\&.IF  M\(de   end \fIideal\fP picture (with flyback)
+\&.IE  M\(de   end \fIideal\fP picture with position at bottom
+\&.IF  M\(de   end \fIideal\fP picture with position at top
 \&.IS  M\(de   start \fIideal\fP picture
-\&.PE  M\(de   end \fIpic\fP picture
-\&.PF  M\(de   end \fIpic\fP picture (with flyback)
+\&.PE  M\(de   end \fIpic\fP picture with position at bottom
+\&.PF  M\(de   end \fIpic\fP picture with position at top
 \&.PS  M\(de   start \fIpic\fP picture
 \&.TE  M       end table
 \&.TH  M       end header of table