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

[Jim Meyering]

Eric Blake wrote:
> On 11/16/2010 03:50 PM, Jim Meyering wrote:
>> Simon Josefsson wrote:
>>> Is this something we want to fix?
>>
>> I'd feel better about "fixing" this if there were some explanation
>> in comments for *why* avoiding @acronym{...} is a good idea.
>> Karl?
>
> Here's the discussion when the syntax-check was added:
> http://lists.gnu.org/archive/html/bug-gnulib/2010-03/msg00321.html

Thanks.  I knew that it had been discussed but
didn't have even a minute to dig it up.

I've pushed this:

>From 5d2098a3ff28107e55c41a699fe7839da93e485b Mon Sep 17 00:00:00 2001
From: Jim Meyering <address@hidden>
Date: Wed, 17 Nov 2010 07:55:25 +0100
Subject: [PATCH] maint.mk: add a URL discussing the address@hidden policy

* top/maint.mk (sc_texinfo_acronym): Add a URL in a comment.
---
 ChangeLog    |    5 +++++
 top/maint.mk |    3 ++-
 2 files changed, 7 insertions(+), 1 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0e6240c..dce80ff 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2010-11-17  Jim Meyering  <address@hidden>
+
+       maint.mk: add a URL discussing the address@hidden policy
+       * top/maint.mk (sc_texinfo_acronym): Add a URL in a comment.
+
 2010-11-15  Paul Eggert  <address@hidden>

        bootstrap: port to Solaris sed
diff --git a/top/maint.mk b/top/maint.mk
index bd5431b..315b223 100644
--- a/top/maint.mk
+++ b/top/maint.mk
@@ -741,7 +741,8 @@ sc_GFDL_version:
        halt='GFDL vN, N!=3'                                            \
          $(_sc_search_regexp)

-# Don't use Texinfo @acronym{} as it is not a good idea.
+# Don't use Texinfo's @acronym{}.
+# http://lists.gnu.org/archive/html/bug-gnulib/2010-03/msg00321.html
 texinfo_suffix_re_ ?= \.(txi|texi(nfo)?)$$
 sc_texinfo_acronym:
        @prohibit='@acronym\{'                                          \
--
1.7.3.2.4.g60aa9