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.