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

Dear Boris & Eli,

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 ?

   V.


________________________________
De : Eli Zaretskii <[email protected]>
Envoyé : samedi 8 août 2026 11:28
À : [email protected] <[email protected]>; [email protected] <[email protected]>
Cc : [email protected] <[email protected]>
Objet : Re: bug#81332: info/dir and INFO_NONMISC are not gated by DOCLANGS

> Cc: [email protected], [email protected]
> Date: Wed, 05 Aug 2026 15:09:11 +0300
> From: Eli Zaretskii <[email protected]>
>
> > From: Vincent Belaïche <[email protected]>
> > CC: "[email protected]" <[email protected]>, "[email protected]"
> >      <[email protected]>
> > Date: Tue, 4 Aug 2026 18:41:31 +0000
> >
> > Now, just from a technical POV, we will have to be careful when we get manual translations of some manual (say
> > foo.texi) that is under one of directories emacs, lispref or lispintro, but is distinct from respectively
> > emacs-lisp-intro.texi, elisp.texi or emacs.texi.
>
> 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.
>
> > What would happen when we have the French translation emacs-fr.texi under doc/translations/fr/emacs ? Would
> > it be also mandated to build ? Do we intend that the docstrings links that you referred to in a prior email will
> > point at the user preferred language manual (so emacs.info or emacs-fr.info depending on some setting) ?
>
> No, this can be subject to DOCLANGS.  The only 3 manuals that must be
> always built are the ones I mentioned, in English.
>
> > Does mandating compiling these three manuals in the end boil down to this that we need some extra pseudo
> > language "mandatory" that would be handled exactly the same as "default" except that DOCLANGS is forced to
> > contain at least "mandatory" and that a manual cannot be both "default" and "mandatory" ?
>
> This is a matter of implementation, but I don't want us to give the
> user the freedom to exclude "mandatory" from the list and thus prevent
> these 2 manuals from building.  If Make is run in the doc directory it
> must produce these 3 manuals; the only way to avoid that is not to run
> Make in doc.

Any objections or thoughts before I install the latest patch by
Boris?