[latex3-commits] [git/LaTeX3-latex3-mathtools] master: clearification (5d82074)

[daleif]

Repository : https://github.com/latex3/mathtools
On branch  : master
Link       : https://github.com/latex3/mathtools/commit/5d820745811b10c83b9d89240bafffa366cc4ecb

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

commit 5d820745811b10c83b9d89240bafffa366cc4ecb
Author: daleif <daleif at math.au.dk>
Date:   Fri Aug 12 09:35:53 2022 +0200

    clearification


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

5d820745811b10c83b9d89240bafffa366cc4ecb
 ANNOUNCEMENT  |  9 +++++++++
 mathtools.dtx | 29 +++++++++++++++--------------
 2 files changed, 24 insertions(+), 14 deletions(-)

diff --git a/ANNOUNCEMENT b/ANNOUNCEMENT
index 3cda5dd..f7b4b23 100644
--- a/ANNOUNCEMENT
+++ b/ANNOUNCEMENT
@@ -1,3 +1,12 @@
+Announcement release 202x/xx/xx
+
+For mathtools.dtx v1.30
+
+* Added a caveat about \xmapsto when ever unicode-math is loaded. The
+  macro does not work as the symbol marking the bar at the start is
+  not available under unicode-math.
+
+
 Announcement release 2022/06/29
 
 For mathtools.dtx v1.29
diff --git a/mathtools.dtx b/mathtools.dtx
index 8f2a448..291fa7d 100644
--- a/mathtools.dtx
+++ b/mathtools.dtx
@@ -1118,20 +1118,21 @@ colorlinks,
 %    \[
 %      A \xLeftarrow[under]{over} B
 %    \]
-%    \textbf{Caveat for \cs{xmapsto}:} Whenever \textsf{lualatex} and
-%    \pkg{unicode-math} is used, the macro \cs{xmapsto} will not work
-%    correctly (a random 7 appears). This is due to how we define
-%    \cs{xmapsto}: the symbol »\,$\mapstochar{}$\,« (via \cs{mapstochar}, setup in the \LaTeX{}
-%    kernel) and and extensible \cs{rightarrow}. The symbol behind
-%    \cs{mapstochar} is not defined in unicode, and thus is not available
-%    in the unicode math fonts.\footnote{The symbol $\mapsto$
-%    \emph{is} in unicode and \pkg{unicode-math} maps \cs{mapsto} onto
-%    this symbol in the unicode math font. Whereas without
-%    \pkg{unicode-math}, \cs{mapsto} is a symbol constructed by
-%    combining \cs{mapstochar} and \cs{rightarrow}.  On the other hand
-%    \textsf{lualatex} \emph{does} have some special macros to create
-%    extensible arrows, but \emph{none} of them can write above
-%    \emph{and} below at the same time. So for now we leave this unresolved.}
+%    \textbf{Caveat for \cs{xmapsto}:} Whenever \pkg{unicode-math} is
+%    used, the macro \cs{xmapsto} will not work correctly (a random 7
+%    appears). This is due to how we define \cs{xmapsto}: the symbol
+%    »\,$\mapstochar{}$\,« (via \cs{mapstochar}, setup in the \LaTeX{}
+%    kernel) and extensible \cs{rightarrow}. The symbol behind
+%    \cs{mapstochar} is not defined in unicode, and thus is not
+%    available in the unicode math fonts.\footnote{The symbol
+%    $\mapsto$ \emph{is} in unicode and \pkg{unicode-math} maps
+%    \cs{mapsto} onto this symbol in the unicode math font. Whereas
+%    without \pkg{unicode-math}, \cs{mapsto} is a symbol constructed
+%    by combining \cs{mapstochar} and \cs{rightarrow}.  On the other
+%    hand \textsf{lualatex} \emph{does} have some special macros to
+%    create extensible arrows, but \emph{none} of these can write above
+%    \emph{and} below at the same time. So for now we leave this
+%    unresolved.}
 %  \begin{codesyntax}
 %    \SpecialUsageIndex{\xrightharpoondown}
 %    \cs{xrightharpoondown}\oarg{sub}\marg{sup}\texttt{~~~~}