GNU bug report logs - #32156
automake handling of texinfo files

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: automake; Reported by: Paul Hardy <unifoundry@HIDDEN>; dated Sat, 14 Jul 2018 15:13:02 UTC; Maintainer for automake is bug-automake@HIDDEN.

Message received at submit <at>

Received: (at submit) by; 14 Jul 2018 15:12:02 +0000
From debbugs-submit-bounces <at> Sat Jul 14 11:12:02 2018
Received: from localhost ([]:60197
	by with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at>>)
	id 1feMDJ-000359-JY
	for submit <at>; Sat, 14 Jul 2018 11:12:02 -0400
Received: from ([]:57883)
 by with esmtp (Exim 4.84_2)
 (envelope-from <unifoundry@HIDDEN>) id 1feMDH-00034t-CF
 for submit <at>; Sat, 14 Jul 2018 11:11:59 -0400
Received: from Debian-exim by with spam-scanned (Exim 4.71)
 (envelope-from <unifoundry@HIDDEN>) id 1feMDB-0002ik-3G
 for submit <at>; Sat, 14 Jul 2018 11:11:54 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on
X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM,
 T_DKIM_INVALID autolearn=disabled version=3.3.2
Received: from ([2001:4830:134:3::11]:36640)
 by with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <unifoundry@HIDDEN>)
 id 1feMDA-0002ie-Vj
 for submit <at>; Sat, 14 Jul 2018 11:11:53 -0400
Received: from ([2001:4830:134:3::10]:48853)
 by with esmtp (Exim 4.71)
 (envelope-from <unifoundry@HIDDEN>) id 1feMD9-0000QX-ML
 for bug-automake@HIDDEN; Sat, 14 Jul 2018 11:11:52 -0400
Received: from Debian-exim by with spam-scanned (Exim 4.71)
 (envelope-from <unifoundry@HIDDEN>) id 1feMD8-0002i9-Gu
 for bug-automake@HIDDEN; Sat, 14 Jul 2018 11:11:51 -0400
Received: from ([2607:f8b0:400c:c05::22b]:45076)
 by with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <unifoundry@HIDDEN>)
 id 1feMD8-0002hg-BT
 for bug-automake@HIDDEN; Sat, 14 Jul 2018 11:11:50 -0400
Received: by with SMTP id b78-v6so5666493vka.12
 for <bug-automake@HIDDEN>; Sat, 14 Jul 2018 08:11:50 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;; s=20161025;
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;; s=20161025;
X-Gm-Message-State: AOUpUlF58aNExSh8xG6mokiv02fr3mfYc0JpOuIBC9Nl1QBHnvMnw6kE
X-Google-Smtp-Source: AAOMgpfW7EqvI7F+3QdBS6ZiT4k0zSoGxOXbB/kylJOFX52zah3xtr5LF+GlSmPZf+X890OKsCNeJM12dLRW8uj07b4=
X-Received: by 2002:a1f:e7c6:: with SMTP id
 Sat, 14 Jul 2018 08:11:49 -0700 (PDT)
MIME-Version: 1.0
Received: by 2002:a1f:4cc6:0:0:0:0:0 with HTTP; Sat, 14 Jul 2018 08:11:49
 -0700 (PDT)
From: Paul Hardy <unifoundry@HIDDEN>
Date: Sat, 14 Jul 2018 08:11:49 -0700
Message-ID: <CAJqvfD9d5Kp4Pim0VmCMik9r4YQskhuFLMQ-DMFYA88u_9ntmA@HIDDEN>
Subject: automake handling of texinfo files
To: bug-automake@HIDDEN
Content-Type: text/plain; charset="UTF-8"
X-detected-operating-system: by Genre and OS details not
X-detected-operating-system: by GNU/Linux 2.6.x
X-Received-From: 2001:4830:134:3::11
X-Spam-Score: -4.0 (----)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at>
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <>
List-Unsubscribe: <>, 
 <mailto:debbugs-submit-request <at>>
List-Archive: <>
List-Post: <mailto:debbugs-submit <at>>
List-Help: <mailto:debbugs-submit-request <at>>
List-Subscribe: <>, 
 <mailto:debbugs-submit-request <at>>
Errors-To: debbugs-submit-bounces <at>
Sender: "Debbugs-submit" <debbugs-submit-bounces <at>>
X-Spam-Score: -5.0 (-----)


Here are three issues surrounding automake handling of Texinfo
files that I have noticed.  This is in automake versions 1.15 and


If for example a doc/ file contains a line of the form

     html_TEXINFOS = myprog.texi

then "autoreconf -i" gives the following complaint from automake:

     doc/ error: HTML generation not yet supported

Yet automake does support HTML generation of Texinfo files now.
This appears to be an automake bug.


Would it be possible to allow a entry of the form

     txt_TEXINFOS = myprog.texi

Then a Makefile could generate a plain text version of a Texinfo
document with something like

     $(MAKEINFO) --plaintext $< -o $@


I would like to make a request that there be a standard way to
leave .pdf and .html files (and .txt files, if their support is added)
that were generated from Texinfo sources to remain undeleted
by "make clean".

automake will build a .info file from Texinfo sources, and will leave
it in place with a "make clean" or "make distclean".  The reasoning
given in the Automake manual is that a user should have the .info file
available without having to install packages to build it.

It would be nice to have that capability also apply to .pdf and .html
files produced from Texinfo sources.  I was able to force that in a
way that does not comply with the API, which is why I am writing this
email in response to the section in Chapter 25 of the manual titled
"What is not in the API".  Here is how I did it:

     # Override removal of mypkg.html and mypkg.pdf
     # that happens in clean-aminfo target
     clean: clean-generic mostlyclean-am
          -test -z "mypkg.dvi" \
          rm -rf mypkg.dvi

So I redefine the "clean" target, because using a "clean-local"
definition would not override the "clean" target.

I could also have made a non-API-standard modification of the
clean-aminfo target instead.  Either way ventures outside the API.

I can think of two possible ways to generate clean-aminfo differently:

     1) If someone lists <mypkg>.html and/or <mypkg>.pdf in EXTRA_DIST
or some similar variable, then do not have the clean-aminfo target
remove them; or

     2) Allow the user to define a variable such as "AM_TEXINFO_CLEAN"
that would override the default Automake assumption of removing *.pdf,
*.html, *.dvi, and *.ps [this might be easier to implement].

Alternatively, add the target "clean-aminfo" to the API.

I know that the GNU convention is only to preserve a .info file, not
.html or .pdf.  But HTML and PDF files are removed even if a package
is declared as "foreign".

I tried this workaround using automake 1.15 and automake 1.16.1.

What are your thoughts on this?

Thank you,

Paul Hardy

Acknowledgement sent to Paul Hardy <unifoundry@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-automake@HIDDEN. Full text available.
Report forwarded to bug-automake@HIDDEN:
bug#32156; Package automake. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Mon, 25 Nov 2019 12:00:02 UTC

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