GNU bug report logs - #9753
automake.texi: colon in @pxref

Previous Next

Full log

View this message in rfc822 format

From: Stefano Lattarini <stefano.lattarini <at> gmail.com>
To: 9753 <at> debbugs.gnu.org
Cc: Дилян, automake-patches <at> gnu.org, dilyan.palauzov <at> aegee.org
Subject: bug#9753: automake.texi: colon in @pxref
Date: Sun, 16 Oct 2011 10:55:17 +0200

[Message part 1 (text/plain, inline)]

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

[0001-docs-avoid-using-colon-character-inside-arguments-of.patch (text/x-patch, inline)]

From 0623bd45631168b3065733cb364d244f74eb96b1 Mon Sep 17 00:00:00 2001
Message-Id: <0623bd45631168b3065733cb364d244f74eb96b1.1318755300.git.stefano.lattarini <at> gmail.com>
From: Stefano Lattarini <stefano.lattarini <at> gmail.com>
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  <stefano.lattarini <at> gmail.com>
+
+	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  <stefano.lattarini <at> gmail.com>
 
 	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		djerius <at> cfa.harvard.edu
 Didier Cassirame	faded <at> free.fr
 Dieter Baron		dillo <at> stieltjes.smc.univie.ac.at
 Dieter Jurzitza		DJurzitza <at> harmanbecker.com
-Dilyan Palauzov		Dilyan.Palauzov <at> aegee.org
+Дилян Палаузов          dilyan.palauzov <at> aegee.org
 Dmitry Mikhin		dmitrym <at> acres.com.au
 Dmitry V. Levin		ldv <at> altlinux.org
 Doug Evans		devans <at> cygnus.com
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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.