[latex3-commits] [git/LaTeX3-latex3-latex2e] mathcolor: Fix documentation (f063d79e)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : mathcolor
Link       : https://github.com/latex3/latex2e/commit/f063d79e6ee6e7f16ae9bdacaf9e79096fb4a941

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

commit f063d79e6ee6e7f16ae9bdacaf9e79096fb4a941
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Thu Jan 6 19:02:43 2022 +0100

    Fix documentation


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

f063d79e6ee6e7f16ae9bdacaf9e79096fb4a941
 required/graphics/color.dtx    |  2 +-
 required/graphics/grfguide.tex | 17 ++++++++++++++++-
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/required/graphics/color.dtx b/required/graphics/color.dtx
index 6c184812..2a4b1e98 100644
--- a/required/graphics/color.dtx
+++ b/required/graphics/color.dtx
@@ -826,7 +826,7 @@
 %    \end{macrocode}
 %  \end{macro}
 %
-% \subsection{Providing \cs{mathcolor}
+% \subsection{Providing \cs{mathcolor}}
 %
 % This is shared coded between different packages, so external.
 %
diff --git a/required/graphics/grfguide.tex b/required/graphics/grfguide.tex
index 3b679ea3..585e87ad 100644
--- a/required/graphics/grfguide.tex
+++ b/required/graphics/grfguide.tex
@@ -243,12 +243,27 @@ to the font commands such as |\textbf|:
 So the above is essentially equivalent to
 |{\color|\arg{name}\emph{text}|}|.
 
+\subsection{Using Colours in math formulas}
+
+While |\color| and to some extent |\textcolor| can be used in
+formulas, this is cumbersome, may lead to bad spacing, and in some
+situations is simply not possible. For this reason we also introduce
+|\mathcolor| which will help in this respect. The basic syntax is:
+
+\begin{decl}
+|\mathcolor|\arg{name}\arg{math}
+\end{decl}
+
+See \texttt{mathcolor.pdf} for details on this command.
+
+
 \subsubsection{Using colour specifications directly}
 
 
 \begin{decl}
 |\color|\oarg{model}\arg{specification}\\
-|\textcolor|\oarg{model}\arg{specification}\arg{text}
+|\textcolor|\oarg{model}\arg{specification}\arg{text}\\
+|\mathcolor|\oarg{model}\arg{specification}\arg{math}
 \end{decl}
 
 Normally one would predeclare all the colours used in a package, or in