[latex3-commits] [git/LaTeX3-latex3-mathtools] master: Added note 3.6 3 about issue #40 (43ffeb3)

[daleif]

Repository : https://github.com/latex3/mathtools
On branch  : master
Link       : https://github.com/latex3/mathtools/commit/43ffeb3737e31a8594795be9a4a2fcf66105105a

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

commit 43ffeb3737e31a8594795be9a4a2fcf66105105a
Author: daleif <daleif at math.au.dk>
Date:   Tue Apr 5 13:09:57 2022 +0200

    Added note 3.6 3 about issue #40


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

43ffeb3737e31a8594795be9a4a2fcf66105105a
 ANNOUNCEMENT  | 3 ++-
 mathtools.dtx | 9 +++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/ANNOUNCEMENT b/ANNOUNCEMENT
index d2ebc37..2b8d2b7 100644
--- a/ANNOUNCEMENT
+++ b/ANNOUNCEMENT
@@ -1,8 +1,9 @@
-Announcement release 2022/02/07
+Announcement release 2022/xx/xx
 
 For mathtools.dtx v1.29
 
 * In section `Special mathtools options` clearified when `gathered` of pure amsmath might give a warning. (#38)
+* Added 3.6 note 3: about \section{foo $\norm[\big]{bar}$}.
 
 For mathtools.dtx v1.28a:
 
diff --git a/mathtools.dtx b/mathtools.dtx
index ab183b6..d10fe10 100644
--- a/mathtools.dtx
+++ b/mathtools.dtx
@@ -2210,6 +2210,15 @@ colorlinks,
 % \cs{abs[\cs{big}]}\marg{arg}, we actually use \cs{bigl} and
 % \cs{bigr}.
 %
+% \medskip\noindent\textbf{Note 3:} In the unlikely event that you
+% choose to use, say, \verb+\section{Foo $\norm[\big]{bar}$}+ you will
+% get an error because \cs{big} is getting expanded too early. Sadly,
+% due to how \cs{DeclarePairedDelimiter} is implemented one cannot use
+% \verb|[\protect\big]|. At present (until \pkg{amsmath} makes
+% \cs{big} and friends robust), the best
+% solution\footnote{\protect\url{https://tex.stackexchange.com/a/639238/3929}}
+% is to load the \pkg{etoolbox} package and add \verb|\robustify\big|
+% and similar to your preamble.
 %
 %  \subsubsection{Expert use}
 %