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

Eli Zaretskii <[email protected]> Wed, 05 Aug 2026 15:09:11 +0300
Newsgroups gmane.emacs.bugs
Message-ID <[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.