GNU bug report logs - #36921
texinfo: @setfilename is not mandatory

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 36921 in the body.
You can then email your comments to 36921 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: Дилян Палаузов
 <dilyan.palauzov <at> aegee.org>
To: automake-bug <at> gnu.org
Subject: texinfo: @setfilename is not mandatory
Date: Sun, 04 Aug 2019 13:22:34 +0000

Hello,

I have a .texi file and in Makefile.am:

info_TEXINFOS = doc/z.texi

Running autoreconf -visf emits:

configure.ac:13: installing './compile'
configure.ac:7: installing './missing'
Makefile.am: installing './depcomp'
Makefile.am: error: './doc/z.texi' missing @setfilename
autoreconf: automake failed with exit status: 1

I have texinfo (or rather makeinfo) 6.6 and automake 1.16.1 (most likely installed from most recent git).

The texinfo manual says in node @setfilename:

“   When a '@setfilename' line is present, the Texinfo processors ignore
everything written before the '@setfilename' line.  This is why the very
first line of the file (the '\input' line) does not show up in the
output.

. . .
   '@setfilename' used to be required by the Texinfo processors, and
some other programs may still expect it to be present; for example,
Automake (*note (automake)Texinfo::).”

Please adjust automake to come forward, when @setfilename is missing, implying the default value.

Regards
  Dilyan

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

From: Gavin Smith <gavinsmith0123 <at> gmail.com>
To: Дилян Палаузов
 <dilyan.palauzov <at> aegee.org>
Cc: 36921 <at> debbugs.gnu.org
Subject: Re: bug#36921: texinfo: @setfilename is not mandatory
Date: Fri, 16 Aug 2019 11:09:05 +0100

On Sun, Aug 04, 2019 at 01:22:34PM +0000, Дилян Палаузов wrote:
> Hello,
> 
> I have a .texi file and in Makefile.am:
> 
> info_TEXINFOS = doc/z.texi
> 
> Running autoreconf -visf emits:
> 
> configure.ac:13: installing './compile'
> configure.ac:7: installing './missing'
> Makefile.am: installing './depcomp'
> Makefile.am: error: './doc/z.texi' missing @setfilename
> autoreconf: automake failed with exit status: 1
> 
> I have texinfo (or rather makeinfo) 6.6 and automake 1.16.1 (most likely installed from most recent git).
> 
> The texinfo manual says in node @setfilename:
> 
> “   When a '@setfilename' line is present, the Texinfo processors ignore
> everything written before the '@setfilename' line.  This is why the very
> first line of the file (the '\input' line) does not show up in the
> output.
> 
> . . .
>    '@setfilename' used to be required by the Texinfo processors, and
> some other programs may still expect it to be present; for example,
> Automake (*note (automake)Texinfo::).”
> 
> Please adjust automake to come forward, when @setfilename is missing, implying the default value.
> 

I posted a patch to fix this issue: 
https://lists.gnu.org/archive/html/bug-automake/2019-01/msg00002.html

Hopefully somebody will have time to apply it.  I am not sure how 
actively Automake is being developed at the moment.

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

From: Karl Berry <karl <at> freefriends.org>
To: gavinsmith0123 <at> gmail.com
Cc: 36921 <at> debbugs.gnu.org, dilyan.palauzov <at> aegee.org
Subject: Re: bug#36921: texinfo: @setfilename is not mandatory
Date: Mon, 19 Aug 2019 11:01:37 -0600

    I posted a patch to fix this issue: 
    https://lists.gnu.org/archive/html/bug-automake/2019-01/msg00002.html

Thanks Gavin. I hope Jim (Meyering) or I will install the patch soon,
although the timing of the next release is unknown at this point.

I'm just starting to get a grip on the development side of automake;
just trying to help since Jim doesn't have a lot of time right now and
all other am developers seem to have disappeared. (If you yourself have
any time/interest, help is greatly needed!) --best, karl.

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

From: Jim Meyering <jim <at> meyering.net>
To: automake-patches <at> gnu.org, Gavin Smith <gavinsmith0123 <at> gmail.com>, 
 Karl Berry <karl <at> freefriends.org>, 36921 <at> debbugs.gnu.org, 34201 <at> debbugs.gnu.org
Subject: [PATCH] automake: do not require @setfilename in Texinfo files
Date: Mon, 2 Sep 2019 10:27:28 -0700

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

Gavin Smith proposed a patch for this back in http://bugs.gnu.org/34201
Another reference to the problem: http://bugs.gnu.org/36921

In the attached (in Gavin's name), I've added a NEWS entry and
adjusted the ChangeLog entry. Will push in a day or so if no comment.

[automake-relax-setfilename.diff (application/octet-stream, attachment)]

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

From: Mathieu Lirzin <mthl <at> gnu.org>
To: Jim Meyering <jim <at> meyering.net>
Cc: 34201 <at> debbugs.gnu.org, Gavin Smith <gavinsmith0123 <at> gmail.com>,
 36921 <at> debbugs.gnu.org, automake-patches <at> gnu.org,
 Karl Berry <karl <at> freefriends.org>
Subject: Re: [PATCH] automake: do not require @setfilename in Texinfo files
Date: Tue, 03 Sep 2019 09:53:34 +0200

Hello Jim,

Jim Meyering <jim <at> meyering.net> writes:

> Gavin Smith proposed a patch for this back in http://bugs.gnu.org/34201
> Another reference to the problem: http://bugs.gnu.org/36921
>
> In the attached (in Gavin's name), I've added a NEWS entry and
> adjusted the ChangeLog entry. Will push in a day or so if no comment.

Thanks for taking care of this. :-)

> From 309a6c477eec80b847078699303c65ccd7787eb0 Mon Sep 17 00:00:00 2001
> From: Gavin Smith <gavinsmith0123 <at> gmail.com>
> Date: Sun, 25 Aug 2019 21:07:58 -0700
> Subject: [PATCH] automake: do not require @setfilename in Texinfo files
>
> Texinfo no longer requires a @setfilename directive in each
> .texi file, so automake now also relaxes its restriction.
> * bin/automake.in (scan_texinfo_file): Derive name of info file from
> name of input file if no @setfilename line occurs in the file.
> * t/txinfo-no-setfilename.sh: New test.
> * t/list-of-tests.mk: Add it.
> * NEWS: Mention it.
>
> Fixes automake bugs #36921 and #34201.
> ---

Not really important but HACKING <Writing a good commit message>
recommends a slightly different style.

--8<---------------cut here---------------start------------->8---
      topic: brief description (this is the "summary line")

      <reference to relevant bugs, if any>

      Here goes a more detailed explanation of why the commit is needed,
      and a general overview of what it does, and how.  This section
      should almost always be provided, possibly only with the expection
      of obvious fixes or very trivial changes.

      And if the detailed explanation is quite long or detailed, you can
      want to break it in more paragraphs.

      Then you can add references to relevant mailing list discussions
      (if any), with proper links.  But don't take this as an excuse for
      writing incomplete commit messages!  The "distilled" conclusions
      reached in such discussions should have been placed in the
      paragraphs above.

      Finally, here you can thank people that motivated or helped the
      change.  So, thanks to John Doe for bringing up the issue, and to
      J. Random Hacker for providing suggestions and testing the patch.

      <detailed list of touched files>
--8<---------------cut here---------------end--------------->8---

-- 
Mathieu Lirzin
GPG: F2A3 8D7E EB2B 6640 5761  070D 0ADE E100 9460 4D37

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

From: Gavin Smith <gavinsmith0123 <at> gmail.com>
To: Jim Meyering <jim <at> meyering.net>
Cc: 34201 <at> debbugs.gnu.org, 36921 <at> debbugs.gnu.org, automake-patches <at> gnu.org,
 Karl Berry <karl <at> freefriends.org>
Subject: Re: bug#34201: [PATCH] automake: do not require @setfilename in
 Texinfo files
Date: Sat, 14 Sep 2019 13:34:35 +0100

On Mon, Sep 2, 2019 at 6:28 PM Jim Meyering <jim <at> meyering.net> wrote:
>
> Gavin Smith proposed a patch for this back in http://bugs.gnu.org/34201
> Another reference to the problem: http://bugs.gnu.org/36921
>
> In the attached (in Gavin's name), I've added a NEWS entry and
> adjusted the ChangeLog entry. Will push in a day or so if no comment.

Thanks for taking the time to look at this.

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

From: Jim Meyering <jim <at> meyering.net>
To: Gavin Smith <gavinsmith0123 <at> gmail.com>
Cc: 34201 <at> debbugs.gnu.org, 36921 <at> debbugs.gnu.org, automake-patches <at> gnu.org,
 Karl Berry <karl <at> freefriends.org>
Subject: Re: bug#34201: [PATCH] automake: do not require @setfilename in
 Texinfo files
Date: Sun, 15 Sep 2019 09:57:03 -0700

On Sat, Sep 14, 2019 at 5:35 AM Gavin Smith <gavinsmith0123 <at> gmail.com> wrote:
> On Mon, Sep 2, 2019 at 6:28 PM Jim Meyering <jim <at> meyering.net> wrote:
> >
> > Gavin Smith proposed a patch for this back in http://bugs.gnu.org/34201
> > Another reference to the problem: http://bugs.gnu.org/36921
> >
> > In the attached (in Gavin's name), I've added a NEWS entry and
> > adjusted the ChangeLog entry. Will push in a day or so if no comment.
>
> Thanks for taking the time to look at this.

Oh! Thanks for the reminder. I've just pushed that.

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

From: Karl Berry <karl <at> freefriends.org>
To: 36921-done <at> debbugs.gnu.org
Subject: Re: bug#36921: bug#34201: [PATCH] automake: do not require
 @setfilename in Texinfo files
Date: Sat, 11 Jan 2025 14:45:53 -0700

Previous Next

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