[bug #58682] [me] length of footnote separator is not as documented

[G. Branden Robinson]

Follow-up Comment #4, bug #58682 (project groff):

[comment #3 comment #3:]
> I'm undecided about the wisdom of altering the title.  The new title is more
precise.  But the document remains at heart the same one that's been around
for 40-some years, time enough to acquire citations in related literature
under its decades-old title.

I've tried to decide this with web searches.  I get hits, but they rapidly
become irrelevant, probably because "me" with "reference manual" just isn't
distinctive enough.

I may well back this out, though, except I'm pretty firmly decided on losing
the leading hyphen (which will stymie most inexpert web searches anyway) and
setting the package name in italics (or bold italics if the surrounding weight
is already bold).

> Within the groff tree, the title (and author list, which has also changed,
but that I consider uncontroversial) will need to be updated at least in
groff_me(7) and (the English and French) "Writing Papers with GROFF using
-me."

Acknowledged.  I thought of that but didn't actually put it on a checklist,
creating a significant oversight hazard.  ;-)
 
> In the content itself, I have only two nits:
> 
> * It's perhaps overkill to explicitly point out that 8/72,000 of an inch is
"almost imperceptible."
> * "upper or lowercase" should be "upper- or lowercase"

I agree with both of these.  The latter I have wholly recast, since it looks
like Allman was depositing regex syntax into his explanation without warning
(to be fair, this language was not originally in the introduction, but in the
documentation of the `lo` macro which GNU me(7) does not support), and on top
of that, groff me(7) users are far less restricted with respect to naming
their macros, thanks to the removed length limit.


 follow a rigid naming convention.
-The user may define registers,
-strings,
-and macros,
-provided that s/he
-uses single-character uppercase names
-or double-character names
-consisting of letters and digits,
+To avoid conflict,
+any user-defined register,
+string,
+or macro
+names should be single numerals or uppercase letters,
+or any longer sequence of letters and numerals
 with at least one uppercase letter.
-In no case should special characters
-be used in user-defined names.
-Locally defined macros
-should all be of the form
-.b .* \c
-.i X ,
-where
-.i X
-is any letter
-(upper or lowercase)
-or digit.
 .sh 1 "Paragraphing"


    _______________________________________________________

Reply to this item at:

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

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