[Top][All Lists]

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

Re: [bug-recutils] Doc patch

From: John Darrington
Subject: Re: [bug-recutils] Doc patch
Date: Fri, 24 Aug 2012 06:53:29 +0000
User-agent: Mutt/1.5.18 (2008-05-17)

[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

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 
   style.  Maybe a @Gnu{} macro should be defined in some common header?


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.

Attachment: signature.asc
Description: Digital signature

reply via email to

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