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

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Stefano Lattarini <stefano.lattarini <at> gmail.com>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#12320: closed (bison 2.6.2 contains stale info files)
Date: Tue, 22 Jan 2013 11:57:02 +0000

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

Your message dated Tue, 22 Jan 2013 12:54:47 +0100
with message-id <50FE7E07.90701 <at> gmail.com>
and subject line closing bug 12320, "bison 2.6.2 contains stale info files"
has caused the debbugs.gnu.org bug report #12320,
regarding bison 2.6.2 contains stale info files
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
12320: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=12320
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

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 part 3 (message/rfc822, inline)]

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.