mhchem (24apr15)

git-svn-id: svn://tug.org/texlive/trunk@37037 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 67 insertions, 11 deletions

diff --git a/Master/texmf-dist/doc/latex/mhchem/README b/Master/texmf-dist/doc/latex/mhchem/README
index d68a8b1ffd4..4a258578407 100644
--- a/Master/texmf-dist/doc/latex/mhchem/README
+++ b/Master/texmf-dist/doc/latex/mhchem/README
@@ -1,7 +1,7 @@
-The mhchem Bundle 2015-04-07
+The mhchem Bundle 2015-04-23
 
 containing
-- mhchem v4.00
+- mhchem v4.01
 - hpstatement v1.01
 - rsphrase v3.11
 
diff --git a/Master/texmf-dist/doc/latex/mhchem/mhchem.pdf b/Master/texmf-dist/doc/latex/mhchem/mhchem.pdf
index a9ef2485772..5d642912e4a 100644
--- a/Master/texmf-dist/doc/latex/mhchem/mhchem.pdf
+++ b/Master/texmf-dist/doc/latex/mhchem/mhchem.pdf
diff --git a/Master/texmf-dist/doc/latex/mhchem/mhchem.tex b/Master/texmf-dist/doc/latex/mhchem/mhchem.tex
index 660487a951f..bc1e4c827f4 100644
--- a/Master/texmf-dist/doc/latex/mhchem/mhchem.tex
+++ b/Master/texmf-dist/doc/latex/mhchem/mhchem.tex
@@ -32,6 +32,7 @@
 \usepackage[utf8]{inputenc}
 \usepackage[danish,french,ngerman,spanish,italian,UKenglish]{babel}
 \usepackage{tgpagella}% URW Palladio
+\usepackage{upgreek}
 \addtokomafont{disposition}{\rmfamily}
 \linespread{1.1}
 \usepackage{mathpazo}% math font
@@ -66,7 +67,7 @@
   The mhchem Bundle\\[0.3em]
   \Large\textmd{%
     Documentation for the Packages\\
-    mhchem v4.00,\\% check
+    mhchem v4.01,\\% check
     hpstatement v1.01 and\\
     rsphrase v3.11}%
 }
@@ -75,7 +76,7 @@
   mhchem\makebox[0pt][l]{\textcolor{white}{NOSPAM}}@MartinHensel\makebox[1pt][l]{\textcolor{white}{.}}.de%
 }
 \date{%
-  2015-04-07% check
+  2015-04-23% check
 }
 \maketitle
 
@@ -187,6 +188,11 @@ For how to fine-tune the font usage, see \nameref{sec:FineTuning}.
 This will work in text mode and math mode. For text, the en-dash will be used as a minus sign.
 
 
+\section{Oxidation States}
+
+\ce{Fe^{II}Fe^{III}2O4}
+
+
 \section{Stoichiometric Numbers}
 
 \begin{SideBySideExample}[xrightmargin=2.5cm]
@@ -209,6 +215,10 @@ This will work in text mode and math mode. For text, the en-dash will be used as
   \ce{(1/2)H2O} % IUPAC Green Book
 \end{SideBySideExample}
 
+\begin{SideBySideExample}[xrightmargin=2.5cm]
+  \ce{$n$H2O}
+\end{SideBySideExample}
+
 This works in text mode and math mode. (The fraction line always comes from math mode and might appear too small when using bold text fonts.)
 
 
@@ -241,7 +251,7 @@ Just write \macro{alpha} etc.
   \ce{[Pt(\eta^2-C2H4)Cl3]-}
 \end{SideBySideExample}
 
-This works in text mode and math mode. For the time being, the math font will be used. But for the next release, an improvement is currently in the making.
+It is recommended to load a package for upright Greek letters, which will automatically be used. For more control, see the section \nameref{sec:GreekFont}. This works in text mode and math mode.
 
 
 \section{Parenthesis, Brackets, Braces}
@@ -432,7 +442,7 @@ If you want to escape parsing, for instance for a simple hyphen, use \verb|{...}
 
 \makebox[3cm][l]{\ce{A -> B}}\verb|\ce{A -> B}|\\
 \makebox[3cm][l]{\ce{A <- B}}\verb|\ce{A <- B}|\\
-\makebox[3cm][l]{\ce{A <-> B}}\verb|\ce{A <-> B}|\\
+\makebox[3cm][l]{\ce{A <-> B}}\verb|\ce{A <-> B}% should not be used according to IUPAC|\\ % Green Book p.52
 \makebox[3cm][l]{\ce{A <--> B}}\verb|\ce{A <--> B}|\\
 \makebox[3cm][l]{\ce{A <=>> B}}\verb|\ce{A <=>> B}|\\
 \makebox[3cm][l]{\ce{A <<=> B}}\verb|\ce{A <<=> B}|
@@ -454,6 +464,27 @@ The arrow arguments use the same syntax as the \macro{ce} command.
 For how to can change the layout of the arrows, see \nameref{sec:FineTuning}.
 
 
+\section{Equation Operators}
+
+\begin{SideBySideExample}[xrightmargin=3cm]
+  \ce{A + B}
+\end{SideBySideExample}
+
+\begin{SideBySideExample}[xrightmargin=3cm]
+  \ce{A - B} % not to be confused with bonds
+\end{SideBySideExample}
+
+\begin{SideBySideExample}[xrightmargin=3cm]
+  \ce{A = B} % not to be confused with bonds
+\end{SideBySideExample}
+
+\begin{SideBySideExample}[xrightmargin=3cm]
+  \ce{A \pm B}
+\end{SideBySideExample}
+
+This works in text mode and math mode. The respective font is used, except for \macro{pm}, which always come from math font.
+
+
 \section{Precipitate and Gas}
 
 \begin{SideBySideExample}[xrightmargin=6cm]
@@ -686,7 +717,7 @@ or as options to the package
 \end{Verbatim}
 
 
-\subsection{Fonts} \label{sec:Fonts}
+\subsection{Text Font and Math Font} \label{sec:Fonts}
 
 mhchem uses the current text font (if you use \macro{ce} in text mode) or the  current math font (if you use \macro{ce} in math mode). If you want, however, you can set a font that will be used for all your formulae and equations.
 
@@ -728,6 +759,24 @@ switches back to the default, which is equivalent to
 \end{Verbatim}
 
 
+\subsection{Greek Font} \label{sec:GreekFont}
+
+If you load a package for upright Greek letters, this will automatically be used. This was possible by the very neat chemgreek package of Clemens Niederberger. If you want to have different Greek fonts for text mode and math mode, you can specify these `mappings', e.\,g. by \verb|\mhchemoptions{text-greek=upgreek,| \verb|math-greek=default}|. You can use any of 
+\begin{compactitem}[--]
+  \item default,
+  \item var-default,
+  \item textgreek,
+  \item upgreek,
+  \item newtx,
+  \item kpfonts,
+  \item mathdesign,
+  \item fourier,
+  \item textalpha,
+  \item fontspec.
+\end{compactitem}
+Of course, you have to load the appropriate packages in the preamble. Refer to the \href{http://mirrors.ctan.org/macros/latex/contrib/chemgreek/chemgreek_en.pdf}{chemgreek manual} for details (in particular its Appendix `Overviews Over the Mappings').
+
+
 \subsection{Arrows}
 
 By default, mhchem uses arrows that are composed of different math-font characters, because it uses some features of the amsmath package. This may lead to undesirable effects when displayed on a screen. Helmut Hänsel kindly provided a patch that used the pgf graphics package instead. pgf arrows are activated by
@@ -741,19 +790,19 @@ If you use this switch inside your document with \macro{mhchemoptions}, don't fo
 \medskip
 \begin{SideBySideExample}[xrightmargin=3cm]
   \mhchemoptions{arrows=font}% default
-  \ce{A <-> B}
+  \ce{A <--> B}
 \end{SideBySideExample}
 
 \medskip
 \begin{SideBySideExample}[xrightmargin=3cm]
   \mhchemoptions{arrows=pgf}
-  \ce{A <-> B}
+  \ce{A <--> B}
 \end{SideBySideExample}
 
 
 \begin{SideBySideExample}[xrightmargin=3cm]
   \mhchemoptions{arrows=pgf-filled}
-  \ce{A <-> B}
+  \ce{A <--> B}
 \end{SideBySideExample}
 
 
@@ -795,13 +844,20 @@ Meaning and usage of \macro{bond} changed.
 
 \section{Most Recent Changes}% check
 
+\minisec{2015-04-23 mhchem v4.01}
+\begin{compactitem}
+\item syntax improvements% $n$H2O, D2-3[T4O10], Fe^{III}2 
+\item recognition of states of aggregation% HCl(g), OH-(aq)
+\item text-font operators \verb|+|, \verb|-|, \verb|=|
+\end{compactitem}
+
 \minisec{2015-04-07 mhchem v4.00}
 \begin{compactitem}
 \item many syntax improvements
 \item many layout improvements
 \item stricter distinction between text font and math font, many math features are translated into their text equivalent, e.g. italic variables
 \item new options
-\item some removed commands
+\item removed deprecated commands
 \end{compactitem}
 
 \minisec{2015-03-13 mhchem v3.21}