summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-04-17 20:01:29 +0000
committerKarl Berry <karl@freefriends.org>2023-04-17 20:01:29 +0000
commit19f4615e78bc698d8c209e560c189e629994ef7d (patch)
tree9c6903c0d1515fbe865a88e0ec8fdea6747dd77d /Master/texmf-dist/doc/latex
parent458ed8974faf8518dee709e8cf8d336a27127799 (diff)
polyglossia (17apr23)
git-svn-id: svn://tug.org/texlive/trunk@66873 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/README.md2
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdfbin72157 -> 72218 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-arabic.tex3
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdfbin42177 -> 42430 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdfbin22822 -> 22804 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-korean.pdfbin20168 -> 20389 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/example-thai.pdfbin13459 -> 13632 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/examples.pdfbin147816 -> 148027 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdfbin352828 -> 356479 bytes
-rw-r--r--Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex59
10 files changed, 57 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/latex/polyglossia/README.md b/Master/texmf-dist/doc/latex/polyglossia/README.md
index 534cd4d8f39..a5e7361dddc 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/README.md
+++ b/Master/texmf-dist/doc/latex/polyglossia/README.md
@@ -1,4 +1,4 @@
-# THE POLYGLOSSIA PACKAGE v1.60
+# THE POLYGLOSSIA PACKAGE v1.61
## Multilingual typesetting with XeLaTeX and LuaLaTeX
This package provides an alternative to Babel for users of XeLaTeX and LuaLaTeX.
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdf
index 7fd8e041f73..e597382ed8a 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-arabic.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-arabic.tex b/Master/texmf-dist/doc/latex/polyglossia/example-arabic.tex
index 19c5b8ccd62..939f20665da 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-arabic.tex
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-arabic.tex
@@ -1,9 +1,10 @@
+% !TeX TS-program = xelatex
\documentclass[a4paper]{book}%
\usepackage[no-math]{fontspec}
\usepackage{xltxtra,url,amsmath}
\setmainfont{Linux Libertine O}
\defaultfontfeatures{Scale=MatchLowercase}
-\newfontfamily\arabicfont[Script=Arabic]{Amiri}%
+\newfontfamily\arabicfont[Script=Arabic]{Amiri}
\newfontfamily\arabicfonttt[Script=Arabic,Scale=.75]{DejaVu Sans Mono}
\newfontfamily\farsifont[Script=Arabic,Scale=1.1,WordSpace=2]{IranNastaliq}
\let\XeTeX\undefined
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdf
index 7e7d7300d81..0df82080971 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-chinese.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdf
index 6b167e112b5..b2c5d9fd8a8 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-japanese.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-korean.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-korean.pdf
index 169e69a5161..d2977dd2e5f 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-korean.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-korean.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/example-thai.pdf b/Master/texmf-dist/doc/latex/polyglossia/example-thai.pdf
index 152c66170af..48cafa64002 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/example-thai.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/example-thai.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/examples.pdf b/Master/texmf-dist/doc/latex/polyglossia/examples.pdf
index 4ca70c773a2..09eaabf1b6a 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/examples.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/examples.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdf b/Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdf
index 2e6601d75a6..d4f2e5f7044 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdf
+++ b/Master/texmf-dist/doc/latex/polyglossia/polyglossia.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex b/Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex
index 387e2ee919a..ada5bf5534a 100644
--- a/Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex
+++ b/Master/texmf-dist/doc/latex/polyglossia/polyglossia.tex
@@ -2323,8 +2323,8 @@ The following macros are provided:
with ¦numerals=cyrillic-trad¦ ¦\mongoliannumeral{19}¦ results in \textrussian[numerals=cyrillic-trad]{\russiannumeral{19}},\\
with ¦numerals=cyrillic-alph¦ ¦\mongoliannumeral{19}¦ results in \textrussian[numerals=cyrillic-alph]{\russiannumeral{19}}.
- \item \Cmd\punjabinumeral produces Punjabi numbering, depending on the ¦numerals¦ option in the Punjabi language selection, this
- is either Gurmukhi or Arabic (Western).
+ \item \Cmd\punjabinumeral produces Punjabi numbering, depending on the setting of the ¦numerals¦ option in the Punjabi language
+ selection, this is either Gurmukhi or Arabic (Western).
\item \Cmd\russiannumeral produces Russian numbering, with uppercased variant (for alphanumerical variant) via \Cmd\Russiannumeral.
Depending on the ¦numerals¦ option in the Russian language selection, this is either Arabic digit or Cyrillic
@@ -2447,10 +2447,42 @@ Example: ¦\charifavailable{1E9E}{SS}¦ prints the capital version of the German
(\ie \charifavailable{1E9E}{SS}), else it prints the substitution digraph SS.
-\section{Accessing language information}
+\section{Accessing language information}\label{sec:langinfo}
-The following is specifically relevant to package authors who need information about the languages in use.
-In order to get such information, \pkg{polyglossia} provides the following macros:
+The following is specifically relevant to package authors who need information about the languages in use
+and the details of the respective locale.
+In order to get such information, the recommended way is to use the \Cmd{\BCPdata\marg{type}}\new{1.61}
+command to get (parts of) the BCP-47 language tag. This command is used by the \LaTeX\ kernel as of 6/2023,
+and the syntax is standardized at least between \pkg{babel} and \pkg{polyglossia}.
+
+\cmd\BCPdata\ supports the following \marg{type} arguments:
+\begin{itemize}
+ \item \xpgoption{language} The language subtag (\eg \texttt{de})
+ \item \xpgoption{region} The region subtag (\eg \texttt{AT})
+ \item \xpgoption{script} The script subtag (\eg \texttt{Latn})
+ \item \xpgoption{variant} The variant subtag (\eg \texttt{1901} for German old spelling)
+ \item \xpgoption{extension.t} The subtag indicating transformation between languages or scripts
+ (\eg \texttt{ja} as in \texttt{en-t-ja}: English transformed to Japanese)
+ \item \xpgoption{extension.u} The subtag indicating additional locale information (\eg \texttt{nu-latn} as in \texttt{ar-u-nu-latn}:
+ Arabic with Latin Numbering)
+ \item \xpgoption{extension.x} The private usespace subtag (\eg \texttt{classic} as in \texttt{la-x-classic} for classic Latin)
+ \item \xpgoption{casing} is a special semantic value which returns whatever is considered suitable
+ for casing commands such as \cmd\MakeUppercase. In many cases, this is identical to \texttt{language} but
+ it could also be something more specific such as \texttt{el-x-iota} or \texttt{ckb-Latn} if this is
+ needed for proper casing. Note that this information is retrieved by the \LaTeX\ kernel for casing as
+ of 06/2023.
+ \item \xpgoption{tag} returns the registered full tag (identical to \cmd\languageid\ below). This however omits
+ certain subtags if these are considered obvious (\eg for German, only \texttt{de-DE} is returned, although
+ script [\texttt{Latn}] and variant [\texttt{1996}] are defined as well).
+\end{itemize}
+If a subtag is not defined for a given language, an empty string is returned.
+
+The values above return information for the language currently in use. If you need to access information for the
+main language of the document, prepend \xpgoption{main.} to the respective argument (\eg \xpgoption{main.language}). This works
+for all supported arguments.
+
+Next to \cmd\BCPdata, \pkg{polyglossia} provides the following legacy macros which are partly unique to \pkg{polyglossia},
+partly re-implementations of legacy \pkg{babel} commands:
\begin{itemize}
\item \Cmd\languagename\ stores the currently active (polyglossia) language name.
@@ -2498,6 +2530,23 @@ where \meta{type} is a supported language id type (such as ¦bcp-47¦) and \meta
\section{Revision history}
\bgroup\footnotesize
+\subsection*{1.61 (2023/04/16)}
+
+\subsubsection*{Bug fixes}
+\begin{itemize}
+ \item Properly reset fonts on change to Latin-script other language (\TXI{580})
+ \item Turn ¦^¦ shorthand off in aux file for Latin (\TXI{582})
+ \item Fix stacking of nested languages and resulting bug in TOC language assignment (\TXI{585})
+ \item Fix ¦\greeknumeral{6}¦ (\TXI{587})
+ \item Fix (re)setting of scripts in inline language commands.
+\end{itemize}
+
+\subsubsection*{New features}
+\begin{itemize}
+ \item Introduce \cmd\BCPdata, a standardized way to gather localization information
+ (see sec.~\ref{sec:langinfo}).
+\end{itemize}
+
\subsection*{1.60 (2023/02/11)}
\subsubsection*{Bug fixes}