From c0e66330261a0098e8041d4cc1428666ef598c30 Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Thu, 30 Sep 2021 03:01:06 +0000
Subject: CTAN sync 202109300301

---
 macros/latex/contrib/siunitx/siunitx.tex | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

(limited to 'macros/latex/contrib/siunitx/siunitx.tex')

diff --git a/macros/latex/contrib/siunitx/siunitx.tex b/macros/latex/contrib/siunitx/siunitx.tex
index d6d300c399..3ef382d722 100644
--- a/macros/latex/contrib/siunitx/siunitx.tex
+++ b/macros/latex/contrib/siunitx/siunitx.tex
@@ -3063,6 +3063,22 @@ When the \pkg{units} package is loaded before \pkg{siunitx}, the command
 
 \section{Hints for using \pkg{siunitx}}
 
+\subsection{Problematic font encodings%
+  \label{sec:hint:encoding}}
+
+The standard settings in \pkg{siunitx} assume that \enquote{sensible} input and
+font encoding values prevail. The input encoding is assumed to be \acro{UTF-8}
+in all cases. With pdf\LaTeX{}, the font encoding should be \texttt{T1},
+whereas for Xe\LaTeX{} and Lua\LaTeX{}, \texttt{TU} (Unicode font encoding) is
+expected.
+
+Some packages, for example \pkg{newtxtext} or \pkg{stix2}, either force
+\texttt{T1} or do not anticipate \texttt{TU} correctly with Xe\LaTeX{} and
+Lua\LaTeX{}. In these cases, the symbols used by \pkg{siunitx} may be
+incorrect. If correcting the font encoding is not possible, you will need to
+re-declare the relevant units using symbol definitions which account for this
+non-standard setup.
+
 \subsection{Adjusting \cs{litre} and \cs{liter}%
   \label{sec:hint:litre}}
 
-- 
cgit v1.2.3

