bug#81332: info/dir and INFO_NONMISC are not gated by DOCLANGS

Dear Eli,
Thank you for the lesson. I must admit I should have paid more attention. Isn't it however a strange way to make a dual output source document. Usually one has a single master file and passes some parameter to select what output one wants.
I attached an example source.texi, compile it with commands

  texi2pdf  -o short.pdf source.texi
  texi2pdf -t "@set FULL 1" -o long.pdf source.texi

in order to select reduced print-out or full print-out version. makeinfo also has some switch to set compile flags from the command line.

It would be easy to modify the example to force full version for all format other than PDF, just insert this below @setfilename

    @ifnottex
    @set FULL 1
    @end ifnottex

    Vincent.
________________________________
De : Eli Zaretskii <[email protected]>
Envoyé : mercredi 12 août 2026 14:03
À : Vincent Belaïche <[email protected]>
Cc : [email protected] <[email protected]>; [email protected] <[email protected]>
Objet : Re: bug#81332: info/dir and INFO_NONMISC are not gated by DOCLANGS

> From: Vincent Belaïche <[email protected]>
> CC: "[email protected]" <[email protected]>
> Date: Wed, 12 Aug 2026 04:33:36 +0000
>
> I have not reviewed the patch in details, I don't think I would have any objections, but had just one comment on
> Eli's point:
>
> > This should never happen.  These three directories are each for a
> > single manual, so any language-specific subdirectories of them can
> > only hold translations of the respective single manual.
> >
> > The other Emacs-related manuals are in doc/misc and its
> > subdirectories.
>
> This not my understanding. It is correct that lispintro and lispref contain only one manual, but here is what
>    cd doc && \
>      find emacs -iname \*.texi -print0 | \
>      xargs -0 grep -nH -F '@direntry'
> outputs:
>
> emacs/emacs-xtra.texi:35:@direntry
> emacs/emacs.texi:43:@direntry
>
> So it seems that there are two manuals in emacs sub-dir. Am I wrong ?

Yes, you are wrong.  emacs-xtra.txi is part of the single Emacs manual
(which is why you don't see info/emacs-xtra.info after you build
Emacs).  The reason for its existence is explained in the following
comment at the beginning of emacs-xtra.texi:

  @c This is a separate manual to avoid making the Emacs User manual too
  @c large in print.  In the Info format, the chapters included below
  @c are part of the Emacs User manual.

Today's lesson: it is not always enough to find some Grep hit, you
should also look around to make sure that hit indeed supports your
theory 😉.