GNU bug report logs - #12320
bison 2.6.2 contains stale info files

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 12320 in the body.
You can then email your comments to 12320 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: Akim Demaille <akim <at> lrde.epita.fr>
To: Peter Breitenlohner <peb <at> mppmu.mpg.de>
Cc: Bug-gnulib <bug-gnulib <at> gnu.org>, Bison Bugs <bug-bison <at> gnu.org>,
	Karl Berry <karl <at> freefriends.org>, Automake Bugs <bug-automake <at> gnu.org>,
	Stefano Lattarini <stefano.lattarini <at> gmail.com>,
	Jim Meyering <jim <at> meyering.net>
Subject: Re: bison 2.6.2 contains stale info files
Date: Fri, 31 Aug 2012 19:03:16 +0200

(Karl and Jim, see below about gendocs, Stefano, see below
about Automake-OG).

Hi Peter, hi friends,

Le 6 août 2012 à 11:37, Peter Breitenlohner a écrit :

> Hi,
> 
> the distributed bison-2.6.2 tarball contains the two stale files
> doc/bison.info-{1,2} from 2.6.1-dirty, and their existence in the source
> tree causes them uselessly to be installed.
> 
> Please remove these two files.
> 
> Regards
> Peter Breitenlohner <peb <at> mppmu.mpg.de>

You are right: the shipped info file is self-contained,
since Bison includes

  AM_MAKEINFOFLAGS = --no-split

since 2003, but there are also trailing split files.

I am using some scripts and Makefile snippets from gnulib
that automate the generation and uploading of the various
forms of the documentation.

The gendocs.sh script does not pass --no-split to makeinfo,
and it is run in the builddir by maint.mk.  As a result,
my builddir contains the split files.

Unfortunately again, Automake does not clean the previous
files when the doc is updated (see below) so I have a
self-contained main info file, and stray split files.
And Automake ships everything blindly.

Amusingly enough the question of "why do split info files
still exist today" was recently posed, and the answer is
"mostly history, useless today".

So, Karl, Jim, and others, would you accept that gendocs.sh
stopped generating a compressed tarball of split info files,
but would rather ship a compressed --no-split file?

Stefano, I think the Texinfo -> makeinfo rules need fixing.
In Bison I have (builddir=$srcdir/_build/debug-48):

am__cwd=`pwd` && CDPATH="${ZSH_VERSION+.}:" && cd ../../../doc && \
rm -rf $backupdir && mkdir $backupdir && \
if (/bin/sh /Users/akim/src/gnu/bison-2.5/build-aux/missing --run makeinfo --version) >/dev/null 2>&1; then \
  for f in ../../../doc/bison.info ../../../doc/bison.info-[0-9] ../../../doc/bison.info-[0-9][0-9] ../../../doc/bison.i[0-9] ../../../doc/bison.i[0-9][0-9]; do \
    if test -f $f; then mv $f $backupdir; restore=mv; else :; fi; \
  done; \
else :; fi && \

i.e., we "cd ../../../doc" and then the "backup" procedure,
which should also remove previous info files, includes
the ../../../doc bits again…  So of course, the old files
are not moved away.

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

From: Jim Meyering <jim <at> meyering.net>
To: Akim Demaille <akim <at> lrde.epita.fr>
Cc: Bug-gnulib <bug-gnulib <at> gnu.org>, Bison Bugs <bug-bison <at> gnu.org>,
	Karl Berry <karl <at> freefriends.org>, Peter Breitenlohner <peb <at> mppmu.mpg.de>,
	Automake Bugs <bug-automake <at> gnu.org>,
	Stefano Lattarini <stefano.lattarini <at> gmail.com>
Subject: Re: bison 2.6.2 contains stale info files
Date: Sat, 01 Sep 2012 17:12:46 +0200

Akim Demaille wrote:
...
> So, Karl, Jim, and others, would you accept that gendocs.sh
> stopped generating a compressed tarball of split info files,
> but would rather ship a compressed --no-split file?

Sounds fine to me, but gendocs.sh is Karl's baby ;-)

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

From: karl <at> freefriends.org (Karl Berry)
To: bug-automake <at> gnu.org
Subject: Re: bison 2.6.2 contains stale info files
Date: Mon, 3 Sep 2012 01:07:53 GMT

    So, Karl, Jim, and others, would you accept that gendocs.sh
    stopped generating a compressed tarball of split info files,
    but would rather ship a compressed --no-split file?

Well, I hope meeting you halfway is ok ... I just changed gendocs.sh to
default to --no-split (can be overridden with a new --info option).

However, I kept it generating a tarball even though usually it will be a
tarball of one file, because otherwise, it would be necessary to detect
when split output was being generated, etc., etc.  Didn't seem worth the
trouble.

At least once you remove the stray split files now, they shouldn't
reappear ...

k

Message #16 received at 12320-done <at> debbugs.gnu.org (full text, mbox):

From: Stefano Lattarini <stefano.lattarini <at> gmail.com>
To: 12320-done <at> debbugs.gnu.org
Subject: closing bug 12320, "bison 2.6.2 contains stale info files"
Date: Tue, 22 Jan 2013 12:54:47 +0100

close 12320
thanks

Reference:
<http://debbugs.gnu.org/cgi/bugreport.cgi?bug=12320>

The next major version of Automake will generate recipes that will
build non-split info files *unconditionally* (see automake bug#13351
<http://debbugs.gnu.org/cgi/bugreport.cgi?bug=13351>, in particular
patch <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=13351#19>,
committed to the Automake repository as v1.13.1-60-gcdba479).  This
should avoid this kind of problems in the future.

Regards,
  Stefano

Previous Next

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