summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/mhchem
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-11-30 23:01:17 +0000
committerKarl Berry <karl@freefriends.org>2015-11-30 23:01:17 +0000
commit92a3670e2756790a48c372626853cb511e8dcc40 (patch)
tree4ed0daa7cd4bb6999af9d86e6ae58c3be1d70827 /Master/texmf-dist/doc/latex/mhchem
parent507d332bb4ae197fe5580c92b1280e132c5fe981 (diff)
mhchem (30nov15)
git-svn-id: svn://tug.org/texlive/trunk@38982 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/mhchem')
-rw-r--r--Master/texmf-dist/doc/latex/mhchem/README4
-rw-r--r--Master/texmf-dist/doc/latex/mhchem/mhchem.pdfbin386711 -> 391695 bytes
-rw-r--r--Master/texmf-dist/doc/latex/mhchem/mhchem.tex127
3 files changed, 82 insertions, 49 deletions
diff --git a/Master/texmf-dist/doc/latex/mhchem/README b/Master/texmf-dist/doc/latex/mhchem/README
index c1b53441e32..e42689586dc 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-07-23
+The mhchem Bundle 2015-11-29
containing
-- mhchem v4.02
+- mhchem v4.03
- 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 db4fea48dd1..e1c3f804191 100644
--- a/Master/texmf-dist/doc/latex/mhchem/mhchem.pdf
+++ b/Master/texmf-dist/doc/latex/mhchem/mhchem.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/mhchem/mhchem.tex b/Master/texmf-dist/doc/latex/mhchem/mhchem.tex
index 03fea5234d3..ecb0197521c 100644
--- a/Master/texmf-dist/doc/latex/mhchem/mhchem.tex
+++ b/Master/texmf-dist/doc/latex/mhchem/mhchem.tex
@@ -49,7 +49,7 @@
\usepackage{hpstatement}
\usepackage{rsphrase}
\usepackage{tikz}
-
+\usepgflibrary{arrows.meta}
\setcounter{secnumdepth}{-1}
\newcommand\macro[1]{{\ttfamily\textbackslash#1}}
@@ -67,7 +67,7 @@
The mhchem Bundle\\[0.3em]
\Large\textmd{%
Documentation for the Packages\\
- mhchem v4.02,\\% check
+ mhchem v4.03,\\% check
hpstatement v1.01 and\\
rsphrase v3.11}%
}
@@ -76,7 +76,7 @@
mhchem\makebox[0pt][l]{\textcolor{white}{NOSPAM}}@MartinHensel\makebox[1pt][l]{\textcolor{white}{.}}.de%
}
\date{%
- 2015-07-23% check
+ 2015-11-29% check
}
\maketitle
@@ -372,9 +372,9 @@ Math mode: Bonds are based on the math-font minus sign. All bonds are verticall
If you switch to another font, the sidebearing of the minus sign may vary, which would cause the dashed bonds to align badly. In that case, adjust the alignment by using the following command with slightly changed values. Use \verb|\mhchemoptions{minus-text-sidebearing-left=0.10em,| \verb|minus-text-sidebearing-right=0.16em}| for text font adjustment and \verb|\mhchemoptions{minus-math-sidebearing-left=0.06em,| \verb|minus-math-sidebearing-right=0.11em}| for math font.
-\section{Using Math, Variables}
+\section{Using Math}
-You can `half-escape' to math by using \verb|$...$|. Remember, that the math font might not always match with the text font (e.\,g. in headings).
+By using \verb|$...$|, you can esacpe to `font-corrected math mode'.
\begin{SideBySideExample}[xrightmargin=4cm]
$\ce{NaOH(aq,$\infty$)}$\\
@@ -388,31 +388,19 @@ You can `half-escape' to math by using \verb|$...$|. Remember, that the math fon
\ce{Fe(CN)_{$\frac{6}{2}$}}
\end{SideBySideExample}
-When `half-escaped', mhchem tries to recognize common patterns and still use the correct font.
+In font-corrected math mode, mhchem regonizes some common patterns and prints them font-corrected (e.\,g. for use in headings). Otherwise, it will fall back to `full math mode'.
+It is a full math mode.
\begin{SideBySideExample}[xrightmargin=4cm]
- $\ce{Fe^$n$+}$ \sffamily\bfseries \ce{Fe^$n$+}
+ $\ce{NO_$x$}$ \sffamily\bfseries \ce{NO_$x$}
\end{SideBySideExample}
-You can prevent this recognition by `fully escaping' to math with \verb|${...}$|.
+You can force `full math mode' to math with \verb|${...}$|.
\begin{SideBySideExample}[xrightmargin=4cm]
- $\ce{Fe^${n}$+}$ \sffamily\bfseries \ce{Fe^${n}$+}
+ $\ce{NO_${x}$}$ \sffamily\bfseries \ce{NO_${x}$}
\end{SideBySideExample}
-The same common patterns are also recognized at many places when used without \verb|$...$|.
-
-\begin{SideBySideExample}[xrightmargin=4cm]
- $\ce{Fe^n+}$ \sffamily\bfseries \ce{Fe^$n$+}
-\end{SideBySideExample}
-
-\begin{SideBySideExample}[xrightmargin=4cm]
- $\ce{NO_$x$}$ \sffamily\bfseries \ce{NO_$x$}
-\end{SideBySideExample}
-
-$\ce{x Na(NH4)HPO4 ->[\Delta] (NaPO3)_x + x NH3 ^ + x H2O}$\par
-{\raggedleft\verb|$\ce{x Na(NH4)HPO4 ->[\Delta] (NaPO3)_x + x NH3 ^ + x H2O}$|\par}
-
\section{Italic Text}
@@ -426,7 +414,23 @@ With the same mechanism, you can switch to italic font.
Spaces will be ignored. Use a \verb|~| when you need to typeset a space.
-This works for the text mode as long as you use latin characters. It also works for math font. Remember, however, that italic math is normally reserved for variables and $cis$ mostly means `product of $c$, $i$, and $s$'.
+This works for the text mode as long as you use latin characters. It also works for the math font.
+
+
+\section {Variables like x, n, 2n+1}
+
+mhchem tries to recognize common patterns and use the correct font. It does that for superscripts, subscripts and in `font-corrected math mode'.
+
+\begin{SideBySideExample}[xrightmargin=4cm]
+ $\ce{NO_x}$ \sffamily\bfseries \ce{NO_x}
+\end{SideBySideExample}
+
+\begin{SideBySideExample}[xrightmargin=4cm]
+ $\ce{Fe^n+}$ \sffamily\bfseries \ce{Fe^n+}
+\end{SideBySideExample}
+
+$\ce{x Na(NH4)HPO4 ->[\Delta] (NaPO3)_x + x NH3 ^ + x H2O}$\par
+{\raggedleft\verb|$\ce{x Na(NH4)HPO4 ->[\Delta] (NaPO3)_x + x NH3 ^ + x H2O}$|\par}
\section{Escape Parsing, Upright Text}
@@ -434,6 +438,8 @@ This works for the text mode as long as you use latin characters. It also works
If you want to escape parsing, for instance for a simple hyphen, use \verb|{...}|.
\begin{SideBySideExample}[xrightmargin=4cm]
+ \ce{{(+)}_589{-}[Co(en)3]Cl3}\\
+ \sffamily\bfseries
\ce{{(+)}_589{-}[Co(en)3]Cl3}
\end{SideBySideExample}
@@ -450,18 +456,30 @@ If you want to escape parsing, for instance for a simple hyphen, use \verb|{...}
The arrow arguments use the same syntax as the \macro{ce} command.
\begin{SideBySideExample}[xrightmargin=3cm]
+ \ce{A ->[H2O] B}\\% chemistry
+ \sffamily\bfseries
\ce{A ->[H2O] B}
\end{SideBySideExample}
\begin{SideBySideExample}[xrightmargin=3cm]
+ \ce{A ->[{text above}][{text below}] B}\\% text
+ \sffamily\bfseries
\ce{A ->[{text above}][{text below}] B}
\end{SideBySideExample}
\begin{SideBySideExample}[xrightmargin=3cm]
- \ce{A ->[$x_i$] B}
+ \ce{A ->[$x$][$x_i$] B}\\% font-corrected math
+ \sffamily\bfseries
+ \ce{A ->[$x$][$x_i$] B}
\end{SideBySideExample}
-For how to can change the layout of the arrows, see \nameref{sec:FineTuning}.
+\begin{SideBySideExample}[xrightmargin=3cm]
+ \ce{A ->[${x}$] B}\\% full math
+ \sffamily\bfseries
+ \ce{A ->[${x}$] B}
+\end{SideBySideExample}
+
+For how you can change the layout of the arrows, see \nameref{sec:FineTuning}.
\section{Equation Operators}
@@ -706,14 +724,14 @@ you could add these rules to you own \macro{cesplit} definition.
All options explained here, can either be set using the \macro{mhchemoptions} command
-\begin{Verbatim}
- \mhchemoptions{arrows=pgf}
+\begin{Verbatim}[commandchars=+()]
+ +textbf(\mhchemoptions{)arrows=pgf+textbf(})
\end{Verbatim}
or as options to the package
\begin{Verbatim}[commandchars=+()]
- \usepackage[version=4,arrows=pgf]{mhchem}
+ +textbf(\usepackage[version=4,)arrows=pgf+textbf(]{mhchem})
\end{Verbatim}
@@ -723,9 +741,9 @@ mhchem uses the current text font (if you use \macro{ce} in text mode) or the c
Inside your document, you can use
-\begin{Verbatim}[commandchars=+\[\]]
- \mhchemoptions{+textbf[textfontcommand=\sffamily]}
- \mhchemoptions{+textbf[mathfontcommand=\mathsf]}
+\begin{Verbatim}[commandchars=+()]
+ \mhchemoptions{+textbf(textfontcommand=\sffamily)}
+ \mhchemoptions{+textbf(mathfontcommand=\mathsf)}
\end{Verbatim}
in order to get sanf-serif fonts in both, text mode and math mode.
@@ -734,28 +752,28 @@ You can use any font command there, not only the mentioned ones. Please be aware
You can specify the commands by name only, i.\,e. without the \verb|\|.
-\begin{Verbatim}[commandchars=+\[\]]
- \mhchemoptions{+textbf[textfontname=sffamily]}
- \mhchemoptions{+textbf[mathfontname=mathsf]}
+\begin{Verbatim}[commandchars=+()]
+ \mhchemoptions{+textbf(textfontname=sffamily)}
+ \mhchemoptions{+textbf(mathfontname=mathsf)}
\end{Verbatim}
\noindent
Only the latter options can be used with the \macro{usepackage} command, because the font commands are not properly defined in the preamble, yet. The shortcut
-\begin{Verbatim}[commandchars=+\[\]]
- \mhchemoptions{+textbf[font=sf]}
+\begin{Verbatim}[commandchars=+()]
+ \mhchemoptions{+textbf(font=sf)}
\end{Verbatim}
sets the two fonts to sans-serif, as mentioned above, and
-\begin{Verbatim}[commandchars=+\[\]]
- \mhchemoptions{+textbf[font=]}
+\begin{Verbatim}[commandchars=+()]
+ \mhchemoptions{+textbf(font=)}
\end{Verbatim}
switches back to the default, which is equivalent to
-\begin{Verbatim}[commandchars=+\[\]]
- \mhchemoptions{+textbf[textfontcommand=, mathfontcommand=\mathrm]}
+\begin{Verbatim}[commandchars=+()]
+ \mhchemoptions{+textbf(textfontcommand=,mathfontcommand=\mathrm)}
\end{Verbatim}
@@ -779,29 +797,38 @@ Of course, you have to load the appropriate packages in the preamble. Refer to t
\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
+By default, mhchem uses arrows that are composed of different math-font characters, because it uses some features of the amsmath package.
+
+\begin{SideBySideExample}[xrightmargin=3cm]
+ \mhchemoptions{arrows=font}% default
+ \ce{A <--> B}
+\end{SideBySideExample}
+
+But you may switch to arrows drawn with PGF (using TikZ). These are activated by
\begin{Verbatim}[commandchars=+()]
\usepackage[version=3,+textbf(arrows=pgf)]{mhchem}
+ % or
+ \usepackage[version=3,+textbf(arrows=pgf-filled)]{mhchem}
\end{Verbatim}
-If you use this switch inside your document with \macro{mhchemoptions}, don't forget to load the \verb|tikz| package manually. (The \verb|tikz| package is a wrapper for---and included in---the pgf bundle.)
+The \verb|tikz| package is loaded automatically if you switch to PGF arrows in the preamble (as you do when using \verb|\usepackage|). If you switch inside your document (with \macro{mhchemoptions}), don't forget to load the required packages manually in your preamble: \verb|\RequirePackage{tikz}\usetikzlibrary{arrows.meta}|.
-\medskip
\begin{SideBySideExample}[xrightmargin=3cm]
- \mhchemoptions{arrows=font}% default
+ \mhchemoptions{arrows=pgf}
\ce{A <--> B}
\end{SideBySideExample}
-\medskip
\begin{SideBySideExample}[xrightmargin=3cm]
- \mhchemoptions{arrows=pgf}
+ \mhchemoptions{arrows=pgf-filled}
\ce{A <--> B}
\end{SideBySideExample}
+You can select other pre-defined PGF arrows (see PGF manual) or even define your own. Activate them with the option \verb|pgf={arrow-name}{line-width}|. The dimensions of your custom arrows are expected to be close to those of the built-in mhchem arrows. By the way, they have line width of 0.09ex.
\begin{SideBySideExample}[xrightmargin=3cm]
- \mhchemoptions{arrows=pgf-filled}
+ \mhchemoptions{arrows=%
+ pgf{Kite[length=0pt 4,width'=0pt 1]}{0.15ex}}
\ce{A <--> B}
\end{SideBySideExample}
@@ -848,6 +875,12 @@ Meaning and usage of \macro{bond} changed.
\section{Most Recent Changes}% check
+\minisec{2015-11-29 mhchem v4.03}
+\begin{compactitem}
+\item reworked arrows and provided option for custom pgf arrows
+\item improved speed
+\end{compactitem}
+
\minisec{2015-07-23 mhchem v4.02}
\begin{compactitem}
\item added rudimentary TeX4ht support