groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

groff_mm(7)'s use of periods before macro names is inconsistent.


From: T. Kurt Bond
Subject: groff_mm(7)'s use of periods before macro names is inconsistent.
Date: Sat, 17 Jul 2021 17:43:15 -0400

In the list of macros in groff_mm(7) the macro names in the headings of
paragraphs in the "Macros" section are never specified with a leading
period.  In similar cases in groff_ms(7) and groff_man(7)  the periods are
always used.  Also, in the text of paragraphs groff_mm(7)'s use of periods
before macro names is inconsistent: sometimes it uses them, and sometimes
it does not.  You can see this in the paragraph for GETST, where in the
body refers to ".SETR" with the period, and to "GETST" and "INITR" without
the period.

This has a practical consequence: it is much harder to find all mentions of
a macro name when the leading period is omitted.  For instance, you can
easily find the one occurrence of the "P" macro in groff_mm(7) where it is
specified with a leading period, but finding all the other occurrences of
the "P" macro are hard, because searching finds the "P"s in the middle of
other macro names and in the body text.

So, does anybody think this warrants changing the man page to match the
other macro package man pages?  If no-one else has plans for changing the
mm man page I could produce a diff...

-- 
T. Kurt Bond, tkurtbond@gmail.com, https://tkurtbond.github.io


reply via email to

[Prev in Thread] Current Thread [Next in Thread]