mathtools
mathtools copied to clipboard
latex3
xelatex + unicode-math breaks over/underbrackets
When using mathools v1.25 (2021/03/18) with xelatex (TeX Live 2021) and unicode-math, underbrackets and overbrackets fail to render correctly if thickness/height arguments are provided:
\documentclass{article}
\usepackage{mathtools}
\usepackage{unicode-math}
\begin{document}
Default options:
$$
\underbracket{A}_{\text{Some text}} = \overbracket{\pi r^2}^{\text{More text}}
$$
Custom options:
$$
\underbracket[0.25pt][1pt]{A}_{\text{Some text}} = \overbracket[1pt][3pt]{\pi r^2}^{\text{More text}}
$$
\end{document}
Everything works fine if unicode-math is omitted:
\documentclass{article}
\usepackage{mathtools}
\begin{document}
Default options:
$$
\underbracket{A}_{\text{Some text}} = \overbracket{\pi r^2}^{\text{More text}}
$$
Custom options:
$$
\underbracket[0.25pt][1pt]{A}_{\text{Some text}} = \overbracket[1pt][3pt]{\pi r^2}^{\text{More text}}
$$
\end{document}
It seems like unicode-math might be providing its own underbracket and overbracket that are overriding mathtools' brackets?
It seems like unicode-math might be providing its own underbracket and overbracket that are overriding mathtools' brackets?
It's not unicode-math itself, but the font. Unicode math fonts contain instructions for drawing e.g. underbrackets/overbrackets and many similar things, so they don't have to be emulated with TeX code. unicode-math uses these. I would assume that this is by design.
According to this, there might be a way to redefine over/underbracket macros so there's compatibility (since unicode-math does have its own argument-free over/underbracket) https://github.com/wspr/unicode-math/issues/544 - and once upon a time it seems to have worked by preserving and redefining mathtools' brackets: https://github.com/wspr/unicode-math/commit/872775eed44857706c0041bae798a04d8971125a
In the meantime, here's a solution that works (via this)! Store mathtools' brackets as separate commands, then restore them after \begin{document}. They have to be restored after the document begins because unicode-math apparently executes its Unicode table after the document starts—including \let\underbracket=\normalunderbracket in the preamble thus doesn't work
\documentclass{article}
\usepackage{mathtools}
% Save mathtools' brackets
\let\normalunderbracket=\underbracket
\let\normaloverbracket=\overbracket
\usepackage{unicode-math}
\begin{document}
% Restore mathtools' brackets *after* \begin{document}
\let\underbracket=\normalunderbracket
\let\overbracket=\normaloverbracket
Default options:
$$
\underbracket[0.25pt][1pt]{A}_{\text{Some text}} = \overbracket[1pt][3pt]{\pi r^2}^{\text{More text}}
$$
Custom options:
$$
\underbracket[0.25pt][10pt]{A}_{\text{Some text}} = \overbracket[1pt][8pt]{\pi r^2}^{\text{More text}}
$$
\end{document}
mathtools also breaks over/underbrace of unicode-math (see https://tex.stackexchange.com/q/521394/82731). I suggest checking if unicode-math is loaded.
\@ifpackageloaded{unicode-math}{
\let\underbrace\LaTeXunderbrace
\let\overbrace\LaTeXoverbrace
}{}
@zepinglee doesn't unicode-math fix that by it self? The problem with the linked example is that mathtools is loaded after unicode-math which is not recommended.
