bug#11422: automake 1.12 info doc installation problem

[Bruno Haible]

Hi,

I have installed automake-1.12 a couple of days ago. In particular
the info format documentation was installed as well:

$ ls -lrt /arch/x86-linux/gnu/share/info/
...
-rw-r--r-- 1 bin bin  227199 25. Apr 11:16 standards.info
-rw-r--r-- 1 bin bin 1142045 25. Apr 11:16 autoconf.info
-rw-r--r-- 1 bin bin   27543 29. Apr 01:09 dir
-rw-r--r-- 1 bin bin   74585 29. Apr 01:09 automake.info-3
-rw-r--r-- 1 bin bin  232045 29. Apr 01:09 automake.info-2
-rw-r--r-- 1 bin bin  296172 29. Apr 01:09 automake.info-1
-rw-r--r-- 1 bin bin    7620 29. Apr 01:09 automake.info
-rw-r--r-- 1 bin bin   78461 29. Apr 01:09 automake-history.info

The 'info' program finds the documentation of 'standards', 'autoconf',
'automake-history', but not the documentation of 'automake':

$ export INFOPATH=/arch/x86-linux/gnu/share/info
$ info --version
info (GNU texinfo) 4.13
...
$ info standards
(OK)
$ info autoconf
(OK)
$ info automake-history
(OK)
$ info automake
File: *manpages*,  Node: automake,  Up: (dir)

AUTOMAKE(1)                      User Commands                     AUTOMAKE(1)



NAME
       automake - manual page for automake 1.11.1

SYNOPSIS
       automake [OPTION] ... [Makefile]...

DESCRIPTION
       Generate Makefile.in for configure from Makefile.am.
...

The automake.info file is not broken or undisplayable:
$ info -f /arch/x86-linux/gnu/share/info/automake.info
(OK)

Also, I can do
$ info automake-invocation
and press 'u', to get to the Automake's Top node.

It's not that the automake.info file is too old:
$ sudo touch /arch/x86-linux/gnu/share/info/automake.info*
$ info automake
File: *manpages*,  Node: automake,  Up: (dir)
...

The problem lies in the 'dir' file. It contains the sections

--------------------------------------------------------------------------
Individual utilities
* aclocal: (automake)Invoking aclocal.          Generating aclocal.m4.
* aclocal-invocation: (automake)aclocal Invocation.
                                                Generating aclocal.m4.
* automake: (automake)Invoking Automake.        Generating Makefile.in.
* automake-invocation: (automake)automake Invocation.
                                                Generating Makefile.in.
--------------------------------------------------------------------------
Software development
* Automake: (automake).         Making GNU standards-compliant Makefiles.
--------------------------------------------------------------------------

Trying different things:
- When I remove the 6 lines from the "Individual utilities" section,
  'info automake' works.
- When I remove the line from the "Software development" section,
  'info automake' does not work.
- When I join the two broken lines in the "Individual utilities" section,
  'info automake' does not work.
- When I remove the 4 lines for aclocal-invocation, automake-invocation
  from the "Individual utilities" section, 'info automake' does not work.
- When I remove the 2 lines for aclocal, automake from the
  "Individual utilities" section, 'info automake' works.
- When I remove just the line
    * automake: (automake)Invoking Automake.        Generating Makefile.in.
  'info automake' works.
- When I change the line
    * automake: (automake)Invoking Automake.        Generating Makefile.in.
  to
    * automake: (automake).        Generating Makefile.in.
  'info automake' works.

So the problem is the reference to the node 'Invoking Automake'. This node
does not exist. But a node 'automake Invocation' exists.

In summary, the lines
  * aclocal: (automake)Invoking aclocal.          Generating aclocal.m4.
  * automake: (automake)Invoking Automake.        Generating Makefile.in.
(that were added by prior versions: 1.10 to 1.11.2) should better never
have been added to 'dir'.

But now that they have been added, the "make install" of Automake 1.12
should take care to remove these lines.

This is on openSUSE Linux. 'install-info' is from Texinfo 4.13, compiled
from source:
$ type install-info 
install-info ist /arch/x86-linux/gnu/bin/install-info
$ install-info --version
install-info (GNU texinfo) 4.13

Bruno