[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog doc/texinfo.txi
From: |
karl |
Subject: |
texinfo ChangeLog doc/texinfo.txi |
Date: |
Sun, 09 Sep 2012 19:16:49 +0000 |
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}
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/03
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/03
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/04
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/06
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/06
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/07
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/07
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/08
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/09
- texinfo ChangeLog doc/texinfo.txi,
karl <=
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/10
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/12
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/13
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/15
- texinfo ChangeLog doc/texinfo.txi, karl, 2012/09/23