On 2026-02-11 00:10:17 +0100, Vincent Lefevre wrote:
> On 2026-02-10 10:17:21 +0100, Patrice Dumas wrote:
> > This is a feature, now no @documentlanguage means that the language is
> > unspecified. As a side note, previously, the language was already
> > unspecified for some output formats, see
> > https://lists.gnu.org/archive/html/bug-texinfo/2025-03/msg00076.html
> 
> What really matters is how this was documented. In GNU Texinfo 7.2:
> 
> 14.1 ‘@documentlanguage LL[_CC]’: Set the Document Language
> ===========================================================
> [...]
> [...] If the command is not used at all, the
> default is ‘en_US’ for US English.
> 
> So the developer could expect that no @documentlanguage was equivalent
> to "@documentlanguage en_US".

BTW, commit 10ac5a7a852e747a03a8bc3d0f9248c642202837 was incomplete.
The reference card still documents en_US as being the default. This
should be changed:

diff --git a/doc/refcard/txirefcard.tex b/doc/refcard/txirefcard.tex
index e2b5fbde28..29f7a792ee 100644
--- a/doc/refcard/txirefcard.tex
+++ b/doc/refcard/txirefcard.tex
@@ -421,7 +421,7 @@ document description.}
 \subsection{Internationalization}
 
 \txicmd{@documentencoding}{enc}{Declare the input encoding to be \var{enc}; 
use right after \code{@setfilename}.  Default is \code{UTF-8}; other 
possibilities: \code{US-ASCII}, \code{ISO-8859-1}, \code{koi8-r}, \dots}
-\txicmd{@documentlanguage}{ll\rmbrack[\code{_}cc]}{Declare the current 
language as the two-character \acro{ISO}-639 abbreviation \var{ll}, optionally 
followed by an underscore and a two-letter \acro{ISO} 3166 two-letter country 
code (\var{cc}). Default is \code{en_US}.}
+\txicmd{@documentlanguage}{ll\rmbrack[\code{_}cc]}{Declare the current 
language as the two-character \acro{ISO}-639 abbreviation \var{ll}, optionally 
followed by an underscore and a two-letter \acro{ISO} 3166 two-letter country 
code (\var{cc}).}
 \txicmd{@frenchspacing}{\code{on|off}}{Control spacing after punctuation.}
 
 \subsection{Category specifications}

-- 
Vincent Lefèvre <[email protected]> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / Pascaline project (LIP, ENS-Lyon)

Reply via email to