Re: [bug-recutils] Doc patch

[John Darrington]

[Cross posting to address@hidden, address@hidden and address@hidden

On Fri, Aug 24, 2012 at 07:52:01AM +0200, Jose E. Marchesi wrote:
     
     Hi John.
     
         I suggest this patch. 
     
     We are following the advise of Karl Berry and not using @acronym{} in
     the the documentation.  See
     http://lists.gnu.org/archive/html/bug-gnulib/2010-03/msg00321.html

Hi Jose,

In that case:

1. We should REMOVE the existing @acronym{GNU} instances in 
parse-datetime.texi.  It doesn't
   make sense to have some files using it and others not.

2. Since since that file comes from gnulib, we should recommend they do the 
same upstream.

3. The existing Texinfo manual (at least the one on www.gnu.org) says:

   "Use the @acronym command for abbreviations written in all capital letters 
..."
   (and even goes on to present an example using @acronym{GNU,} ).

   If this is supposed to merely illustrate an example of possible use rather 
   than state a recommendation, then this text should be taken out of the 
imperitive mood.

4. The GNU Coding standards should have a section this and general matters of 
typographical
   style.  Maybe a @Gnu{} macro should be defined in some common header?


J'

-- 
PGP Public key ID: 1024D/2DE827B3 
fingerprint = 8797 A26D 0854 2EAB 0285  A290 8A67 719C 2DE8 27B3
See http://keys.gnupg.net or any PGP keyserver for public key.

signature.asc
Description: Digital signature