Hi
On 04/10/2026 17:17, Ihor Radchenko wrote:
Hi,
I see that you applied the patch.
Just marking it applied for our tracker:
Applied, onto main.
https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=10814296c
"Pedro A. Aranda" <[email protected]> writes:
+(defcustom org-export-other-languages nil
+ "A list of strings with the Org language codes for other languages
+used in the document.
+
+ox-latex inserts this list as \"other-languages = {<list>}\" in
+the document metadata (along with the export language defined in the
+#+LANGUAGE: keyword as \"language = {<lang>}\"), when the shorthand
+DOC_LANGS is included in `org-latex-doc-metadata'."
I think we should not provide all these details about ox-latex inside a
docstring in ox.el. I suggest describing these details in
`org-latex-doc-metadata' docstring. In ox.el, we can simply refer to
that variable then. WDYT?
Done. The longer description now resides in `org-latex-doc-metadata'
(slightly adapted to the context).
Note that org-latex-doc-metadata docstring has no references to
DOC_LANGS at all on main:
(defcustom org-latex-doc-metadata nil
"A string with the document metadata.
These metadata add accesibility information to the PDF
to make it usable by screen readers and similar applications.
They will be inserted as \"\\DocumentMetadata{<metadata>}\"
at the beginning of the generated LaTeX preamble."
You are right. Would the attached patch be enough?
I am not sure if we can simply move it.
Neither was I and the stress was on TOWARDS... And the Rationale in the
commit message, just to show my thoughts.
Unfortunately, it was not fully clear to me that your intention is just
discussing the patch. I interpreted it as the first patch that will
follow by new different patches related to multi-language export to
LaTeX.
Fine, maybe as [DRAFT]? I don't know if the 'automated "burocrazy"' ;-)
would allow this tag.
Draft would work. Or explicit statement in the email itself...
It is not about "burocrazy". It is about me understanding the intention
of the patch. By default, I assume that submitted patches are intended
to be applied.
> Also, our bug tracker has no notion of drafts at all.
By 'burocrazy' I meant the BUG tracker & affiliated SW infrastructure... OK
I am complaining
as a human being who was confused :)
;) OK, got it. How do you need me to mark future draft patches I want to
use as part of a discussion?
--
Pedro A. Aranda
ox-latex & ox-beamer maintainer
Sagen's Paradeiser! (ORF: Als Radiohören gefährlich war) => write BE!
IA: onomatopeya del rebuzno
2nd year of the New Koprocracy
From c02c6bcefda2ea32e2bc2178907ad0e652314d9a Mon Sep 17 00:00:00 2001
From: "Pedro A. Aranda" <[email protected]>
Date: Sun, 4 Oct 2026 19:19:22 +0200
Subject: [PATCH 22/22] ox-latex: Document DOC_LANGS in
'org-latex-doc-metadata'
* lisp/ox-latex.el (org-latex-doc-metadata): Add a paragraph relating
the shorthand DOC_LANGS with 'org-export-language' and
'org-export-other-languages'.
---
lisp/ox-latex.el | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/lisp/ox-latex.el b/lisp/ox-latex.el
index 3430e18fc..2cf7237fd 100644
--- a/lisp/ox-latex.el
+++ b/lisp/ox-latex.el
@@ -667,7 +667,13 @@ (defcustom org-latex-doc-metadata nil
These metadata add accesibility information to the PDF
to make it usable by screen readers and similar applications.
They will be inserted as \"\\DocumentMetadata{<metadata>}\"
-at the beginning of the generated LaTeX preamble."
+at the beginning of the generated LaTeX preamble.
+
+When included, replace the shorthand DOC_LANGS with the document's
+language information: `org-export-language' is inserted as
+\"language = {<lang>},\", and `org-export-other-languages'
+as \"other-languages = {<list of langs>},\"."
+
:package-version '(Org . "10")
:type '(choice (const :tag "No metadata" nil)
--
2.53.0
