bug-gnulib
[Top][All Lists]
Advanced

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

Re: syntax-check warns on parse-datetime.texi


From: Paul Eggert
Subject: Re: syntax-check warns on parse-datetime.texi
Date: Tue, 16 Nov 2010 20:36:25 -0800
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.2.12) Gecko/20101027 Thunderbird/3.1.6

On 11/16/2010 02:53 PM, Eric Blake wrote:
> Here's the discussion when the syntax-check was added:
> http://lists.gnu.org/archive/html/bug-gnulib/2010-03/msg00321.html

My kneejerk reaction is that we shouldn't police GNU manuals
to remove instances of the acronym markup.  As the Texinfo manual
says (about acronym and abbr):

  "It's not essential to use either of these commands for all
   abbreviations; use your judgment."

and it's fine to let documentation writers exercise their judgment
here.  I agree with Karl about the "deep waters" one gets into
with this markup, but that's not a strong enough argument to
prohibit the practice entirely.



reply via email to

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