GNU bug report logs - #11422
automake 1.12 info doc installation problem

Previous Next

To reply to this bug, email your comments to 11422 AT debbugs.gnu.org.

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

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

From: Bruno Haible <bruno <at> clisp.org>
To: bug-automake <at> gnu.org
Subject: automake 1.12 info doc installation problem
Date: Sun, 06 May 2012 18:13:35 +0200

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

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

From: Stefano Lattarini <stefano.lattarini <at> gmail.com>
To: Bruno Haible <bruno <at> clisp.org>
Cc: 11422 <at> debbugs.gnu.org
Subject: Re: bug#11422: automake 1.12 info doc installation problem
Date: Mon, 07 May 2012 22:45:19 +0200

severity 11422 minor
tags 11422 + moreinfo
thanks

On 05/06/2012 06:13 PM, Bruno Haible wrote:
> Hi,
>
Hi Bruno, sorry for the delay.

> I have installed automake-1.12 a couple of days ago. In particular
> the info format documentation was installed as well:
>
> [SNIP]
> 
> The 'info' program finds the documentation of 'standards', 'autoconf',
> 'automake-history', but not the documentation of 'automake':
>
> The problem lies in the 'dir' file.
>
> [SNIP]
>
> 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
> 

Am I misunderstanding something, or this is actually an issue with the
format of the 'dir' files created by GNU install-info?  In fact, I see
this report from you on the bug-texinfo list:

  <http://lists.gnu.org/archive/html/bug-texinfo/2012-05/msg00000.html>

Regards,
  Stefano

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

From: Bruno Haible <bruno <at> clisp.org>
To: Stefano Lattarini <stefano.lattarini <at> gmail.com>
Cc: 11422 <at> debbugs.gnu.org
Subject: Re: bug#11422: automake 1.12 info doc installation problem
Date: Tue, 08 May 2012 01:19:20 +0200

Hi Stefano,

> I see this report from you on the bug-texinfo list:
> 
>   <http://lists.gnu.org/archive/html/bug-texinfo/2012-05/msg00000.html>

It is a different issue. (But I happened to stumble across both bugs
at the same time.) The issue on bug-texinfo is a problem with an INFOPATH
that contains at least two directories.

This issue here is about stale entries that refer to nonexistent nodes, when
installing a new Automake release using the same --prefix as an older one.

How to reproduce:
1. $ mkdir /tmp/inst
2. Install automake-1.11.2:
   $ tar xvfz .../automake-1.11.2.tar.gz
   $ (cd automake-1.11.2 && ./configure --prefix=/tmp/inst && make && make install)
3. $ INFOPATH=/tmp/inst/share/info info automake
   works
4. Install automake-1.12 with the same --prefix:
   $ tar xvfz .../automake-1.12.tar.gz
   $ (cd automake-1.12 && ./configure --prefix=/tmp/inst && make && make install)
5. $ INFOPATH=/tmp/inst/share/info info automake
   fails, it produces the manpage fallback.

Bruno

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

From: Roumen Petrov <bugtrack <at> roumenpetrov.info>
To: Stefano Lattarini <stefano.lattarini <at> gmail.com>
Cc: 11422 <at> debbugs.gnu.org, Bruno Haible <bruno <at> clisp.org>
Subject: Re: bug#11422: automake 1.12 info doc installation problem
Date: Sun, 13 May 2012 20:21:11 +0300

Hi Stefano ,

What is final solution to use texinfo pages for GNU autotools 
(autoconf,automake,libtool) ?


Bruno Haible wrote:
> Hi Stefano,
[SNIP]
> How to reproduce:
[SNIP]
> 4. Install automake-1.12 with the same --prefix:
>     $ tar xvfz .../automake-1.12.tar.gz
>     $ (cd automake-1.12&&  ./configure --prefix=/tmp/inst&&  make&&  make install)
> 5. $ INFOPATH=/tmp/inst/share/info info automake
>     fails, it produces the manpage fallback.
info automake-invocation is new stile if remember some discussion about 
implementation of xxxx-invocation and Xxxx


> Bruno

Roumen

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

From: Stefano Lattarini <stefano.lattarini <at> gmail.com>
To: Roumen Petrov <bugtrack <at> roumenpetrov.info>
Cc: 11422 <at> debbugs.gnu.org, Bruno Haible <bruno <at> clisp.org>
Subject: Re: bug#11422: automake 1.12 info doc installation problem
Date: Sun, 13 May 2012 21:30:09 +0200

On 05/13/2012 07:21 PM, Roumen Petrov wrote:
> Hi Stefano ,
> 
> What is final solution to use texinfo pages for GNU autotools (autoconf,automake,libtool) ?
>
For what concerns the automake issue: I haven't looked into it yet, and likely
I won't anytime soon; it is very very low priority for me.  Just fix the broken
'dir' file manually for the moment.  Better again, use the HTML documentation
instead of the info one.

Sorry,
  Stefano

Previous Next

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