[groff] 60/72: doc/meref.me.in: Clarify several points.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 51b155c24c6d3810973d101b726a3d99b66a49da
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Oct 23 15:34:25 2022 -0500

    doc/meref.me.in: Clarify several points.
    
    - User identifiers must contain at least one uppercase letter.  This
      avoids collisions with eqn's '10' string and some punctuation-only
      identifiers used internally by me(7).
    - Describe "vertical spacing" as "text baseline spacing"; "spacing"
      suggests a repeated process better than "distance" does.
    - Characterize the tag T argument to `ip` as optional.  This was already
      implied, but it seems important to assure the reader that (tagless)
      indented paragraphs are easily obtained.
    - Tighten wording.
    - Explicitly identify default values of \n(bs and \n(qs instead of by
      reference to \n(ps, so that the reader doesn't infer that aliasing is
      ocurring, and that `bs` and `qs` will change if `ps` is altered.
---
 doc/meref.me.in | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/doc/meref.me.in b/doc/meref.me.in
index b12d8bdb0..a9e88a054 100644
--- a/doc/meref.me.in
+++ b/doc/meref.me.in
@@ -214,8 +214,8 @@ any user-defined register,
 string,
 or macro
 names should be single numerals or uppercase letters,
-or any longer sequence of numerals and/or
-letters as long as at least one letter is uppercase.\**
+or any longer character sequence
+including at least one uppercase letter.\**
 .(f
 \**
 For portability between BSD and \*G \*(ME,
@@ -244,7 +244,7 @@ to
 .NR (pp
 [10p],
 and vertical spacing
-(text baseline distance)
+(text baseline spacing)
 to
 .NR (tv
 [120]%
@@ -287,7 +287,7 @@ to the first output line.
 Like
 .b .lp ,
 but set the paragraph
-with a hanging tag
+with an optional hanging tag
 .i T
 [empty]
 and the remainder indented by
@@ -306,10 +306,11 @@ Any spaces in
 must be unbreakable.
 If
 .i T
-will not fit in the space
+does not fit in the space
 .i i,
 .b .ip
-puts the text after the tag on a new line.
+breaks the line after
+.i T .
 .TL
 .b .np
 .DE
@@ -698,8 +699,7 @@ and long quotations
 are preceded and followed
 by an extra
 .NR (bs
-[same as
-.NR (ps ]
+[0.35v]
 of vertical space
 and use a vertical spacing of
 .NR (dv
@@ -766,8 +766,7 @@ by
 preceded and followed
 by
 .NR (qs
-[same as
-.NR (bs ]
+[0.35v]
 space,
 and set at type size
 .NR (qp