Subject: bug#8071: Please rename automake invocation node

From: Stefano Lattarini <[email-masked]>
Date: Fri, 30 Dec 2011 18:17:07 +0100

Hi Eric.

On 12/30/2011 03:29 PM, Eric Blake wrote:
> [SNIP]
>
> So we _do_ need to make the swap.
> 
Thanks for your explanation and testing.  Here is the patch I'll push shortly
if there is no objection.

Regards,
  Stefano

-*-*-*-

>From 34feafeec134a7bdc99d1b261fd97e6c0c5ab716 Mon Sep 17 00:00:00 2001
Message-Id: <34feafeec[email-masked]>
From: Stefano Lattarini <[email-masked]>
Date: Fri, 30 Dec 2011 18:13:28 +0100
Subject: [PATCH] docs: fix a couple broken anchors

* doc/automake.texi: In previous commit v1.11-605-g5f71f2b (related
to automake bug#8071), we had renamed the chapters about aclocal
and automake invocation, and added anchors to the old names as not
to break hyperlinks to our on-line manual.  Unfortunately, these
anchors had been erroneously placed *before* the relevant `@node'
commands, instead that just after, so that they ended up pointing
to the wrong chapters.  Fix this.  Since we are at it, tweak the
wording of the comments to the anchors to better match that used
in the autoconf manual.

Report and suggestion by Eric Blake.
---
 doc/automake.texi |   12 ++++++------
 1 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/doc/automake.texi b/doc/automake.texi
index e155fd1..a690b67 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -2492,11 +2492,11 @@ with different flags.  In this instance, the names of the object files
 would be chosen by automake; they would be @file{false-true.o} and
 @file{true-true.o}. (The name of the object files rarely matters.)

-@c The anchor is required to avoid breaking existing web hyperlinks
-@c still using the old name of this node.
-@anchor{Invoking automake}
 @node automake Invocation
 @chapter Creating a @file{Makefile.in}
+@c This node used to be named "Invoking automake".  This @anchor
+@c allows old links to still work.
+@anchor{Invoking automake}

 @cindex Multiple @file{configure.ac} files
 @cindex Invoking @command{automake}
@@ -3108,11 +3108,11 @@ macros installed in a system-wide directory, @pxref{aclocal Invocation}).

 @end ftable

-@c The anchor is required to avoid breaking existing web hyperlinks
-@c still using the old name of this node.
-@anchor{Invoking aclocal}
 @node aclocal Invocation
 @section Auto-generating aclocal.m4
+@c This node used to be named "Invoking automake".  This @anchor
+@c allows old links to still work.
+@anchor{Invoking aclocal}

 @cindex Invocation of @command{aclocal}
 @cindex @command{aclocal}, Invocation
-- 
1.7.7.3