bug-coreutils
[Top][All Lists]
Advanced

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

bug#13371: removing @acronym from manual


From: Karl Berry
Subject: bug#13371: removing @acronym from manual
Date: Sun, 6 Jan 2013 23:09:53 GMT

    the latest Texinfo documentation (from the 4.13.93 pretest) says
    nothing about that

On the contrary, I added (brief) text to both the acronym and Smallcaps
nodes giving caveats about using @acronym and @sc quite a while ago.
It's been in all the pretests.  I've retweaked that text again just now,
though, so I'm glad you mentioned it.

Anyway, avoiding them is not official requirement, not at all.  Not even
an official recommendation.  I just came to the conclusion when people
asked my advice some years ago -- I observed that whenever a manual
tries to use @acronym or @sc for normal all-caps abbreviations, such as
"GNU", in practice the commands are not used consistently (as we have
just seen in the coreutils case).

Since there's no special benefit to using @acronym{GNU} or @sc{gnu} over
just plain "GNU", it's merely about typographic preferences, my
suggestion was that it was better to avoid the whole issue, simplify the
source, and go with "GNU".

Nevertheless, if a GNU manual wants to use them, that is fine by me.

k





reply via email to

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