bug#64235: closed (patch: Ensure that makeinfo ≥ 6.8 checks the @menu structure)

[GNU bug Tracking System]

Your message dated Sat, 24 Jun 2023 18:45:43 -0700
with message-id 
<CA+8g5KF-AHWiQXAfeVA8-w+QiPqRdYtqVth9nvL6nJNHFJ2kPw@mail.gmail.com>
and subject line Re: bug#64235: patch: Ensure that makeinfo ≥ 6.8 checks the 
@menu structure
has caused the debbugs.gnu.org bug report #64235,
regarding patch: Ensure that makeinfo ≥ 6.8 checks the @menu structure
to be marked as done.

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


-- 
64235: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=64235
GNU Bug Tracking System
Contact help-debbugs@gnu.org with problems

--- Begin Message --- Subject: patch: Ensure that makeinfo ≥ 6.8 checks the @menu structure Date: Fri, 23 Jun 2023 00:51:33 +0200

Makeinfo versions < 6.7 detected mistakes in the @menu structure of TeXinfo
input. Makeinfo versions ≥ 6.8 don't do this any more by default. They need
an extra option, for this validation to happen. See
<https://lists.gnu.org/archive/html/bug-texinfo/2023-06/msg00015.html>.

Since doc/grep.texi has a hand-written @menu, it should use this extra
option.

Here's a patch to that effect.

There are two possibilities for adding the extra option:
  - in the MAKEINFO variable, where it has an effect on both "makeinfo"
    and "makeinfo --html",
  - in the AM_MAKEINFOFLAGS variable, where it has an effect on "makeinfo"
    only.
Since some maintainers may check their documentation edits only by regenerating
the HTML-formatted documentation, the first choice is preferrable.

Tested by running
  touch doc/grep.texi ; (cd doc && make grep.info V=1)
and
  make sc_makefile_at_at_check

0001-build-Ensure-that-makeinfo-6.8-checks-the-menu-struc.patch
Description: Text Data

--- End Message ---

> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: bug#64235: patch: Ensure that makeinfo ≥ 6.8 checks the @menu structure
>
>
>
>
> Date: 
>
> Sat, 24 Jun 2023 18:45:43 -0700
>
>
>
>
> On Thu, Jun 22, 2023 at 4:28 PM Bruno Haible <bruno@clisp.org> wrote:
> > Makeinfo versions < 6.7 detected mistakes in the @menu structure of TeXinfo
> > input. Makeinfo versions ≥ 6.8 don't do this any more by default. They need
> > an extra option, for this validation to happen. See
> > <https://lists.gnu.org/archive/html/bug-texinfo/2023-06/msg00015.html>.
> >
> > Since doc/grep.texi has a hand-written @menu, it should use this extra
> > option.
> >
> > Here's a patch to that effect.
> >
> > There are two possibilities for adding the extra option:
> >   - in the MAKEINFO variable, where it has an effect on both "makeinfo"
> >     and "makeinfo --html",
> >   - in the AM_MAKEINFOFLAGS variable, where it has an effect on "makeinfo"
> >     only.
> > Since some maintainers may check their documentation edits only by 
> > regenerating
> > the HTML-formatted documentation, the first choice is preferrable.
> >
> > Tested by running
> >   touch doc/grep.texi ; (cd doc && make grep.info V=1)
> > and
> >   make sc_makefile_at_at_check
>
> Thank you. Pushed.
>
>
> --- End Message ---