[groff] 21/32: doc/meref.me.in: Fix documentation errors.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1728f9229ae408e7e1600fb8a76bb7387420aed2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Oct 5 16:47:09 2022 -0500

    doc/meref.me.in: Fix documentation errors.
    
    (Preprocessor Support) <PS>: Swap argument order (width comes first),
    note empty defaults, and (vaguely) describe their purpose.  DWB and GNU
    pic semantics evidently diverge here.
    
    (Summary) <\_>: Describe as "underrule", not "underscore".  These are
    distinct: the latter is a glyph; the former is drawn by typesetters and
    rendered with SGR attributes on terminals.
---
 ChangeLog       | 10 ++++++++++
 doc/meref.me.in | 15 ++++++++++-----
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 23229fc99..4db321a3c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2022-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       * doc/meref.me.in: Fix documentation errors.
+       (Preprocessor Support) <PS>: Swap argument order (width comes
+       first), note empty defaults, and (vaguely) describe their
+       purpose.  DWB and GNU pic semantics evidently diverge here.
+       (Summary) <\_>: Describe as "underrule", not "underscore".
+       These are distinct: the latter is a glyph; the former is drawn
+       by typesetters and rendered with SGR attributes on terminals.
+
 2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * NEWS: Advise users of changes to "name" directive handling in
diff --git a/doc/meref.me.in b/doc/meref.me.in
index 205fe4f21..be88b95d8 100644
--- a/doc/meref.me.in
+++ b/doc/meref.me.in
@@ -1331,16 +1331,21 @@ End
 table.
 .TL
 .b .PS
-.i h
 .i w
+.i h
 .DE
 Begin
 .i \%@g@pic (1)
 picture.
-.i h
-is the height and
 .i w
-is the width.
+[empty]
+and
+.i h
+[empty],
+if present,
+scale the image.
+.\" XXX: That's vague, but DWB pic and GNU pic reportedly interpret
+.\" these arguments differently and there's no room here to discuss it.
 .TL
 .b .PE
 .DE
@@ -2226,7 +2231,7 @@ and a square \(sq labels \*G extensions.
 \&.TH  M       end heading for multi-page \fI@g@tbl\fP table
 \&.TS  M       begin \fI@g@tbl\fP table
 \e\(ha F\(sc   1/12 em unbreakable hair space
-\e_    F\(sc   underscore
+\e_    F\(sc   underrule
 \e\(ga F\(sc   grave accent
 \&.ad  M\(sc   set text adjustment mode
 \&.af  M\(sc   assign register format