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

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 9753 in the body.
You can then email your comments to 9753 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Дилян Палаузов
	<dilyan.palauzov <at> aegee.org>
To: bug-automake <at> gnu.org
Subject: automake.texi: colon in @pxref
Date: Fri, 14 Oct 2011 10:27:37 +0200

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

Hello,

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).

Със здраве
  Дилян

[Attached Message (message/rfc822, attachment)]

[Attached Message (message/rfc822, attachment)]

[dilyan_palauzov.vcf (text/x-vcard, attachment)]

Message #8 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Stefano Lattarini <stefano.lattarini <at> gmail.com>
To: bug-automake <at> gnu.org
Cc: Дилян, automake-patches <at> gnu.org,
	 Палаузов
	<dilyan.palauzov <at> aegee.org>, 9753 <at> debbugs.gnu.org
Subject: Re: 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

Message #18 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Stefano Lattarini <stefano.lattarini <at> gmail.com>
To: bug-automake <at> gnu.org
Cc: Дилян, automake-patches <at> gnu.org,
	 Палаузов
	<dilyan.palauzov <at> aegee.org>, 9753 <at> debbugs.gnu.org
Subject: Re: bug#9753: automake.texi: colon in @pxref
Date: Mon, 17 Oct 2011 11:09:24 +0200

On Sunday 16 October 2011, Stefano Lattarini wrote:
> On Friday 14 October 2011, Дилян Палаузов wrote:
>
> > 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?
> 
Дилян ACK'ed off-list the update to the THANKS file, so I've pushed the
patch to maint and closed the report.

Thanks,
  Stefano

Previous Next

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