chemmacros (10apr14)

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

7 files changed, 66 insertions, 5 deletions

diff --git a/Master/texmf-dist/doc/latex/chemmacros/README b/Master/texmf-dist/doc/latex/chemmacros/README
index 48b53adb453..11ca389c3b7 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/README
+++ b/Master/texmf-dist/doc/latex/chemmacros/README
@@ -1,8 +1,8 @@
 --------------------------------------------------------------------------
-the CHEMMACROS bundle 2014/01/29
- - chemmacros package v4.4   -> macros and commands for chemists
- - chemformula package v4.4  -> typeset chemical compounds and reactions
- - ghsystem package v4.2e    -> typeset H & P statements and pictograms
+the CHEMMACROS bundle 2014/04/08
+ - chemmacros package v4.5   -> macros and commands for chemists
+ - chemformula package v4.5  -> typeset chemical compounds and reactions
+ - ghsystem package v4.5     -> typeset H & P statements and pictograms
                                 from the globally harmonised system (GHS)
  - chemgreek package v0.4    -> handle mapping of upright greek letters to
                                 the \chemalpha ... commands
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.pdf b/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.pdf
index 6ac302eab5b..c1e6ba8075d 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.pdf
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.pdf
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex
index 36ff900a1fa..00ebc3d13d8 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex
@@ -803,7 +803,7 @@ right.
 \end{example}
 They are shifted if they \emph{follow} a subscript which follows \ac{iupac}
 recommendations~\cite[][p.\,51]{iupac:greenbook}.  The amount of the shift can
-be set with the option \key{charge-hshift}.
+be set with the option \option{charge-hshift}.
 \begin{example}
   \ch{SO4^2-} \ch{NH4+} \ch{Na+} \par
   \chemsetup[chemformula]{charge-hshift=.5ex}
@@ -1015,10 +1015,16 @@ There are various different types:
     stoichiometric equation
   \command{ch}[\Marg{ <=> } \ch{<=>}]
     equilibrium arrow
+  \command{ch}[\Marg{ >=< } \ch{>=<}]
+    reversed equilibrium arrow
   \command{ch}[\Marg{ <=>> } \ch{<=>>}]
     unbalanced equilibrium arrow to the right
+  \command{ch}[\Marg{ >=<< } \ch{>=<<}]
+    reversed unbalanced equilibrium arrow to the right
   \command{ch}[\Marg{ <<=> } \ch{<<=>}]
     unbalanced equilibrium arrow to the left
+  \command{ch}[\Marg{ >>=< } \ch{>>=<}]
+    reversed unbalanced equilibrium arrow to the left
   \command{ch}[\Marg{ <o> } \ch{<o>}]
     isolobal arrow
 \end{commands}
@@ -1456,6 +1462,52 @@ The next example shows the effect of some of the options:
   }
 \end{example}
 
+\section{Kröger-Vink Notation}\label{sec:kroger-vink-notation}
+
+\chemformula\ also supports the Kröger-Vink notation\sinceversion{4.5}.
+\begin{options}
+  \keybool{kroeger-vink}\Default{false}
+    Enable the Kröger-Vink notation. As most options this can be enabled
+    globally via the setup command or locally as option to \cs{ch}.
+\end{options}
+
+With this option enabled several changes come into effect: \code{'} prodoces a
+prime, a \code{x} in a superscript produces $\times$, and both a \code{.} and
+a \code{*} produce a little filled circle. In the Kröger-Vink notation a prime
+denotes a negative relative charge, the circle a positive relative charge, and
+the cross denotes a neutral relative charge.
+
+\begin{example}[side-by-side]
+  \setchemformula{kroeger-vink=true}
+  \ch{Al_{Al}^'}
+  \ch{Al_{Al}'}\par
+  \ch{Ni_{Cu}^{x}}\par
+  \ch{V_{Cl}^.}
+  \ch{V_{Cl}^*}\par
+  \ch{Ca_i^{..}}\par
+  \ch{e^'}\par
+  \ch{Cl_i^{''}}
+  \ch{Cl_i''}\par
+  \ch{O_i^{''}}
+  \ch{O_i''}
+\end{example}
+
+There are a number of options for customizations:
+\begin{options}
+  \keyval{kv-positive-style}{\TikZ}\Default
+    \TikZ\ code for positive charge dot.
+  \keyval{kv-positive-radius}{dim}\Default{.3ex}
+    Radius of positive charge dot
+  \keyval{kv-positive-hshift}{dim}\Default{.15em}
+    Horizontal shift of positive charge dot
+  \keyval{kv-positive-vshift}{dim}\Default{.5ex}
+    Vertical shift positive charge dot
+  \keyval{kv-positive-offset}{dim}\Default{.4em}
+    The offset of two consecutive positive charge dots
+  \keyval{kv-neutral-symbol}{\TeX\ code}\Default{\$\cs*{times}\$}
+    Symbol for neutral particles.
+\end{options}
+
 \section{Further Examples}
 This section presents some examples of a possible usage.
 
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.pdf b/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.pdf
index b25f82c8f41..2bc8bcd89d8 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.pdf
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.pdf
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf
index 31851b59554..cb13c1ad0ea 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.pdf
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
index 517d55d2ea8..bc5bcc0d24e 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
@@ -425,6 +425,12 @@ With version~4.0 some changes have been made:
   \item New \module{nmr} option \option{coupling-pos-cs}.
 \end{itemize}
 
+\subsection{Version 4.5}
+\begin{itemize}
+  \item New \module{acid-base} option \option{subscript}.
+  \item Dutch translations.
+\end{itemize}
+
 \section{Package Options}\label{sec:options}
 \chemmacros\ has several package options. They all are used as key/value pairs
 like
@@ -1178,6 +1184,9 @@ There is one option which changes the style the \p{} is typeset:
     The subscript to \cs{Kb} and \cs{pKb}.
   \keyval{K-water}{text}\Module{acid-base}\Default{W}
     The subscript to \cs{Kw}.
+  \keychoice{subscript}{lowercase,uppercase}\Module{acid-base}\Default{uppercase}
+    Choose\sinceversion{4.5} if the default subscript is written in lower- or
+    uppercase.
 \end{options}
 \begin{example}
   \pH, \pKa \par
diff --git a/Master/texmf-dist/doc/latex/chemmacros/ghsystem_en.pdf b/Master/texmf-dist/doc/latex/chemmacros/ghsystem_en.pdf
index 288abb1dacf..f52b8a18b42 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/ghsystem_en.pdf
+++ b/Master/texmf-dist/doc/latex/chemmacros/ghsystem_en.pdf