texinfo ChangeLog doc/texinfo.txi

[karl]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     karl <karl>     12/09/09 19:16:49

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        @acronym not recommended for GNU manuals

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1410&r2=1.1411
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.474&r2=1.475

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1410
retrieving revision 1.1411
diff -u -b -r1.1410 -r1.1411
--- ChangeLog   9 Sep 2012 19:07:09 -0000       1.1410
+++ ChangeLog   9 Sep 2012 19:16:49 -0000       1.1411
@@ -1,5 +1,9 @@
 2012-09-09  Karl Berry  <address@hidden>
 
+       * doc/texinfo.txi (acronym): mention likely desirability
+       of not using it, and that is the recommendation for GNU manuals.
+       Suggestion from John Darrington, 24 Aug 2012 06:53:29.
+
        * doc/texinfo.txi (table): new commands defined with @macro
        don't usually work as the argument to @table.
 

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.474
retrieving revision 1.475
diff -u -b -r1.474 -r1.475
--- doc/texinfo.txi     9 Sep 2012 19:07:09 -0000       1.474
+++ doc/texinfo.txi     9 Sep 2012 19:16:49 -0000       1.475
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.474 2012/09/09 19:07:09 karl Exp $
address@hidden $Id: texinfo.txi,v 1.475 2012/09/09 19:16:49 karl Exp $
 @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
 @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
 
@@ -7635,11 +7635,12 @@
 
 @cindex NASA, as acronym
 @cindex Acronyms, tagging
-Use the @code{@@acronym} command for abbreviations written in all
-capital letters, such as address@hidden'.  The abbreviation is given as
-the single argument in braces, as in @samp{@@address@hidden@}}.  As
-a matter of style, or for particular acronyms, you may prefer to
-use periods, as in @samp{@@address@hidden@}}.
+You can use the @code{@@acronym} command for abbreviations written in
+all capital letters, such as address@hidden'.  The abbreviation is
+given as the single argument in braces, as in
address@hidden@@address@hidden@}}.  As a matter of style, or for particular
+acronyms, you may prefer to use periods, as in
address@hidden@@address@hidden@}}.
 
 @code{@@acronym} accepts an optional second argument, intended to be
 used for the meaning of the acronym.
@@ -7679,8 +7680,8 @@
 
 @itemize @minus
 @item
-In standard English usage, acronyms are a subset of abbreviations:
-they include pronounceable words like address@hidden', `radar', and
+In common English usage, acronyms are a subset of abbreviations: they
+include pronounceable words like address@hidden', `radar', and
 `snafu', and some sources also include syllable acronyms like
 `Usenet', hybrids like address@hidden', and unpronounceable
 initialisms like address@hidden'.
@@ -7698,7 +7699,16 @@
 acronyms.
 
 @item
-It's not essential to use either of these commands for all
+It often turns out to be quite difficult and/or time-consuming to
+consistently use @code{@@acronym} for all sequences of uppercase
+letters.  Unfortunately, it looks strange for some acronyms to be in
+the normal font size and others to be smaller.  So it may be better to
+simply not use @code{@@acronym} and typeset everything as normal text:
address@hidden, producing `GNU'.  This is in fact what we recommend for
+GNU manuals.
+
address@hidden
+In general, it's not essential to use either of these commands for all
 abbreviations; use your judgment.  Text is perfectly readable without
 them.
 
@@ -21826,7 +21836,7 @@
 or other version control systems, which expand it into a string such
 as:
 @example
-$Id: texinfo.txi,v 1.474 2012/09/09 19:07:09 karl Exp $
+$Id: texinfo.txi,v 1.475 2012/09/09 19:16:49 karl Exp $
 @end example
 (This is useful in all sources that use version control, not just manuals.)
 You may wish to include the @samp{$Id:} comment in the @code{@@copying}