[latex3-commits] [git/LaTeX3-latex3-pdfresources] testxmp: document pdftitle change (5a44e86)

[Ulrike Fischer]

Repository : https://github.com/latex3/pdfresources
On branch  : testxmp
Link       : https://github.com/latex3/pdfresources/commit/5a44e8619904e66c45ea079e9eeacf7ab9d4ecfc

>---------------------------------------------------------------

commit 5a44e8619904e66c45ea079e9eeacf7ab9d4ecfc
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Thu Sep 8 15:22:42 2022 +0200

    document pdftitle change


>---------------------------------------------------------------

5a44e8619904e66c45ea079e9eeacf7ab9d4ecfc
 CHANGELOG.md         |  3 ++-
 hyperref-generic.dtx | 12 ++++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7c4eb01..92df912 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,7 +8,8 @@ this project uses date-based 'snapshot' version identifiers.
 ## [Unreleased]
 
 ### Changed
- - XMP-Metadata are uncompress (if supported by the engines).
+ - XMP-Metadata are uncompressed (if supported by the engines).
+ - pdftitle allows to set the titles in various languages.
 
 ## [2022-08-24]
 
diff --git a/hyperref-generic.dtx b/hyperref-generic.dtx
index 922cb07..347ca77 100644
--- a/hyperref-generic.dtx
+++ b/hyperref-generic.dtx
@@ -200,6 +200,18 @@
 %  \begin{verbatim}
 %  pdfauthor = {Bär, Peter Anteater, {Riley, the sloth}}
 %  \end{verbatim}
+%
+%  \item It is possible to store titles in more than one language. If the value begins with
+%  an \enquote{optional argument} which represents a language tag, the value is taken
+%  as a comma list and splitted. The first value is used for the Info dictionary,
+%  the others are used in the XMP-metadata. Commas in a title must then be
+%  protected with braces:
+%
+%  \begin{verbatim}
+%  pdftitle = {[en]English Title,[de] Deutscher Titel,[fr]{titre français, avec comma}}
+%  \end{verbatim}
+%
+%
 %  \item All values of relevant keys (including keys from the hyperxmp package)
 %  will be stored in a Metadata container, and can be retrieved with
 %  \cs{GetDocumentProperties}.