Re: bug#9753: automake.texi: colon in @pxref

[Stefano Lattarini]

On Friday 14 October 2011, Дилян Палаузов wrote:
> Hello,
>
Hi Дилян.

> doc/automake.texi contains colon in @pxref, at line 879, @node VPATH Builds:
> 
> ... these builds @pxref{General Search, , @code{VPATH}: Search Path for 
> All Prerequisites, make, The GNU Make Manual}).
> 
> Please remove the colon, see the attachments for the motivation (texinfo 
> documentation shall be extended to state that colons must be avoided in 
> @pxref).
> 
> Със здраве
>    Дилян
> 
Thanks for the report, I will soon push the attached patch to fix the
problem.  Note that the patch also updates your name and e-mail adress
in the THANKS file; is that OK to you?

Regards,
  Stefano

From 0623bd45631168b3065733cb364d244f74eb96b1 Mon Sep 17 00:00:00 2001
Message-Id: <address@hidden>
From: Stefano Lattarini <address@hidden>
Date: Sun, 16 Oct 2011 10:50:47 +0200
Subject: [PATCH] docs: avoid using colon character inside arguments of @pxref
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixes automake bug#9753

* doc/automake.texi (VPATH Builds): Avoid using colon character
`:' inside arguments of @pxref, as this can cause problems in
the generated `.info' files, and such an usage will be explicitly
forbidden by future texinfo documentation.
* THANKS: Update.

Reported by Дилян Палаузов.
---
 ChangeLog         |   11 +++++++++++
 THANKS            |    2 +-
 doc/automake.texi |    2 +-
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 171139c..ac2b5cf 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2011-10-14  Stefano Lattarini  <address@hidden>
+
+       docs: avoid using colon character inside arguments of @pxref
+       Fixes automake bug#9753
+       * doc/automake.texi (VPATH Builds): Avoid using colon character
+       `:' inside arguments of @pxref, as this can cause problems in
+       the generated `.info' files, and such an usage will be explicitly
+       forbidden by future texinfo documentation.
+       * THANKS: Update.
+       Reported by Дилян Палаузов.
+
 2011-10-07  Stefano Lattarini  <address@hidden>
 
        parallel-tests: warn on conditional TEST_EXTENSIONS definition
diff --git a/THANKS b/THANKS
index 81c97fb..ad9a448 100644
--- a/THANKS
+++ b/THANKS
@@ -83,7 +83,7 @@ Diab Jerius           address@hidden
 Didier Cassirame       address@hidden
 Dieter Baron           address@hidden
 Dieter Jurzitza                address@hidden
-Dilyan Palauzov                address@hidden
+Дилян Палаузов          address@hidden
 Dmitry Mikhin          address@hidden
 Dmitry V. Levin                address@hidden
 Doug Evans             address@hidden
diff --git a/doc/automake.texi b/doc/automake.texi
index bca4566..7063329 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -894,7 +894,7 @@ about some concurrency in the way build commands are run.  
For this
 reason we refer to such setups using the name @emph{VPATH builds} in
 the following.  @emph{VPATH} is the name of the @command{make} feature
 used by the @file{Makefile}s to allow these builds (@pxref{General
-Search, , @code{VPATH}: Search Path for All Prerequisites, make, The
+Search, , @code{VPATH} Search Path for All Prerequisites, make, The
 GNU Make Manual}).
 
 @cindex multiple configurations, example
-- 
1.7.2.3