Received: (at submit) by debbugs.gnu.org; 14 Jul 2018 15:12:02 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jul 14 11:12:02 2018 Received: from localhost ([127.0.0.1]:60197 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1feMDJ-000359-JY for submit <at> debbugs.gnu.org; Sat, 14 Jul 2018 11:12:02 -0400 Received: from eggs.gnu.org ([22.214.171.124]:57883) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <unifoundry@HIDDEN>) id 1feMDH-00034t-CF for submit <at> debbugs.gnu.org; Sat, 14 Jul 2018 11:11:59 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from <unifoundry@HIDDEN>) id 1feMDB-0002ik-3G for submit <at> debbugs.gnu.org; Sat, 14 Jul 2018 11:11:54 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: 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 lists.gnu.org ([2001:4830:134:3::11]:36640) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from <unifoundry@HIDDEN>) id 1feMDA-0002ie-Vj for submit <at> debbugs.gnu.org; Sat, 14 Jul 2018 11:11:53 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:48853) by lists.gnu.org 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 eggs.gnu.org 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 mail-vk0-x22b.google.com ([2607:f8b0:400c:c05::22b]:45076) by eggs.gnu.org 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 mail-vk0-x22b.google.com 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; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=YBQxsjrKYNpEIW31EYxH5s0BQsB/7lc68Djew8DMfFQ=; b=tyhtQfK1e4ZTI6yWyfQAm4wrISiTQ8mzr3eJar2kNAQi+73YQYcb7dAQCQEDD8bgdC 6I7riHgeGb4+doaJiiKUVz8d070MlsQtaxhjrqsvQWtJyNoGiBOqDJg0g6Pa4bJnW2Ax nA6YhrvwBJGONrpO+Ta2faEveYssaqOoDe/yu/iT3/w6AgzPw8CTuMWfAZNWOH2I9Vee gHqCTNawkmNk11lfXanaGpPIuzk685ZDsYcMIot2VNM7GLVJfJ+jhFVAzwqjVzH5EJWW 6qQOPhJ424sNdG7nadAvTHyO++m/7ZbdbxBWRlRXxPmQJpfJAXfO1LNyiV3jTvG4aL5a gKjw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=YBQxsjrKYNpEIW31EYxH5s0BQsB/7lc68Djew8DMfFQ=; b=DSfwS4szg1XpgUlb4v0ucTZ2/FligU8nyZtShVuh53EA6AqTiZJR5QEeENgvoVBX8U a1A8Jqcw9era4Iee5bgBLZ+Japw1Bqsm/ufuBQ/7VgSXEdeKfG7ARWLNilxdqL3H4TPz Milv4hvRIY6I95Yf9WlBPULaJB9VATUoOtUZjWQOmyAfnTDqufypWQnhnxsoovljcFhJ Q790DqJvXT8qlPA1ks8ovdJDYpm1w6IDlG/FVfj3MGPyYb0cwu7qe04blC1XiyJWQrX6 yNAQoeN1k7uSSo8d8MEjGRfw3uZ8ilADrGZq6AMSsetbhn/VdNwOeB2tBQCO4PUYr3Gy VNTw== X-Gm-Message-State: AOUpUlF58aNExSh8xG6mokiv02fr3mfYc0JpOuIBC9Nl1QBHnvMnw6kE 9cfkJ0NnZtoclDygM3NSJRbaWEl62Zs2SeAb5ZHoHA== X-Google-Smtp-Source: AAOMgpfW7EqvI7F+3QdBS6ZiT4k0zSoGxOXbB/kylJOFX52zah3xtr5LF+GlSmPZf+X890OKsCNeJM12dLRW8uj07b4= X-Received: by 2002:a1f:e7c6:: with SMTP id e189-v6mr6143593vkh.119.1531581109602; 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 eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: 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> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -5.0 (-----) Greetings, Here are three issues surrounding automake handling of Texinfo files that I have noticed. This is in automake versions 1.15 and 1.16.1. FIRST ISSUE: If for example a doc/Makefile.am file contains a line of the form html_TEXINFOS = myprog.texi then "autoreconf -i" gives the following complaint from automake: doc/Makefile.am:6: error: HTML generation not yet supported Yet automake does support HTML generation of Texinfo files now. This appears to be an automake bug. SECOND ISSUE: Would it be possible to allow a Makefile.am 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 $@ THIRD ISSUE: 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 mypkg.ps" \ rm -rf mypkg.dvi mypkg.ps 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
Paul Hardy <unifoundry@HIDDEN>:
bug-automake@HIDDEN. Full text available.
automake. Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.