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

From: Stefano Lattarini <[email-masked]>
Date: Sun, 16 Oct 2011 10:55:17 +0200

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: <0623bd456[email-masked]>
From: Stefano Lattarini <[email-masked]>
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  <[email-masked]>
+
+	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  <[email-masked]>
 
 	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		[email-masked]
 Didier Cassirame	[email-masked]
 Dieter Baron		[email-masked]
 Dieter Jurzitza		[email-masked]
-Dilyan Palauzov		[email-masked]
+Дилян Палаузов          [email-masked]
 Dmitry Mikhin		[email-masked]
 Dmitry V. Levin		[email-masked]
 Doug Evans		[email-masked]
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