chemmacros (14mar12)

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

11 files changed, 290 insertions, 69 deletions

diff --git a/Master/texmf-dist/doc/latex/chemmacros/README b/Master/texmf-dist/doc/latex/chemmacros/README
index 9c311693bfa..bf63c5b3013 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/README
+++ b/Master/texmf-dist/doc/latex/chemmacros/README
@@ -1,10 +1,10 @@
 --------------------------------------------------------------------------
-the CHEMMACROS bundle v3.1b
+the CHEMMACROS bundle v3.1c
 -> chemmacros package  -> macros and commands for chemists
 -> chemformula package -> typeset chemical compounds and reactions
 -> ghsystem package    -> typeset H & P statements and pictograms
                           from the globally harmonised system (GHS)
-2012/03/03
+2012/03/14
 --------------------------------------------------------------------------
 This bundle succeeds the chemmacros package which is now part of the
 bundle
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemformula_test_sub_and_superscripts.tex b/Master/texmf-dist/doc/latex/chemmacros/chemformula_test_sub_and_superscripts.tex
new file mode 100644
index 00000000000..7811ab97c31
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemformula_test_sub_and_superscripts.tex
@@ -0,0 +1,132 @@
+\documentclass[parskip=full]{scrartcl}
+
+\usepackage{chemmacros}
+\newcommand*\cmd[2]{}
+\begin{document}
+
+% {\chemsetup[chemformula]{charge-hshift=0pt}
+% \ch{NO2^*} X\\
+% \ch{NO^*} X\\
+% \ch{H2O} X\\
+% \ch{^4S_{3/2}^-} X\\
+% \ch{C5H11-} X\\
+% \ch{^1H} X\\
+% \ch{^{12}1H} X
+% }
+% % \end{document}
+% 
+% \ch{NO2^*} X\\
+% \ch{H2O} X\\
+% \ch{^4S_{3/2}^-} X\\
+% \ch{C5H11-} X\\
+% \ch{^1H} X\\
+% \ch{^{12}1H} X
+
+Isotop:\\
+\verb|\ch{^3B}| \ch{^3B +}\\
+\verb|\ch{3B}| \ch{3B +}\\
+\verb|\ch{_3B}| \ch{_3B +}\\
+\verb|\ch{3^3B}| \ch{3^3B +}\\
+\verb|\ch{_3^3B}| \ch{_3^3B +}\\
+\verb|\ch{^33B}| \ch{^33B +}\\
+\verb|\ch{^{23}123B}| \ch{^{23}123B +}\\
+\verb|\ch{^{23}_{123}B}| \ch{^{23}_{123}B +}\\
+\verb|\ch{^{123}23B}| \ch{^{123}23B +}\\
+\verb|\ch{^{123}_{23}B}| \ch{^{123}_{23}B +}\\
+\verb|\ch{123^{23}B}| \ch{123^{23}B +}\\
+\verb|\ch{_{123}^{23}B}| \ch{_{123}^{23}B +}\\
+\verb|\ch{23^{123}B}| \ch{23^{123}B +}\\
+\verb|\ch{_{23}^{123}B}| \ch{_{23}^{123}B +}
+
+Formel:\\
+\verb|\ch{B3}| \ch{B3 +}\\
+\verb|\ch{B23}| \ch{B23 +}\\
+\verb|\ch{B123}| \ch{B123 +}\\
+\verb|\ch{B^3}| \ch{B^3 +}\\
+\verb|\ch{B^{23}}| \ch{B^{23} +}\\
+\verb|\ch{B^{123}}| \ch{B^{123} +}\\
+\verb|\ch{B3^3}| \ch{B3^3 +}\\
+\verb|\ch{B^33}| \ch{B^33 +}\\
+\verb|\ch{B123^{23}}| \ch{B123^{23} +}\\
+\verb|\ch{B_{123}^{23}}| \ch{B_{123}^{23} +}\\
+\verb|\ch{B^{23}123}| \ch{B^{23}123 +}\\
+\verb|\ch{B^{23}_{123}}| \ch{B^{23}_{123} +}\\
+\verb|\ch{B123^{23}}| \ch{B23^{123} +}\\
+\verb|\ch{B_{123}^{23}}| \ch{B_{23}^{123} +}\\
+\verb|\ch{B^{123}23}| \ch{B^{123}23 +}\\
+\verb|\ch{B^{123}_{23}}| \ch{B^{123}_{23} +} \\
+\verb|\ch{H2O}| \ch{H2O} \\
+\verb|\ch{H2SO4}| \ch{H2SO4} \\
+\verb|\ch{Na+}| \ch{Na+} \\
+\verb|\ch{NH4+}| \ch{NH4+} \\
+\verb|\ch{SO4^2-}| \ch{SO4^2-}
+
+full shift:\chemsetup[chemformula]{charge-hshift=full}\\
+\verb|\ch{B3}| \ch{B3 +}\\
+\verb|\ch{B23}| \ch{B23 +}\\
+\verb|\ch{B123}| \ch{B123 +}\\
+\verb|\ch{B^3}| \ch{B^3 +}\\
+\verb|\ch{B^{23}}| \ch{B^{23} +}\\
+\verb|\ch{B^{123}}| \ch{B^{123} +}\\
+\verb|\ch{B3^3}| \ch{B3^3 +}\\
+\verb|\ch{B^33}| \ch{B^33 +}\\
+\verb|\ch{B123^{23}}| \ch{B123^{23} +}\\
+\verb|\ch{B_{123}^{23}}| \ch{B_{123}^{23} +}\\
+\verb|\ch{B^{23}123}| \ch{B^{23}123 +}\\
+\verb|\ch{B^{23}_{123}}| \ch{B^{23}_{123} +}\\
+\verb|\ch{B123^{23}}| \ch{B23^{123} +}\\
+\verb|\ch{B_{123}^{23}}| \ch{B_{23}^{123} +}\\
+\verb|\ch{B^{123}23}| \ch{B^{123}23 +}\\
+\verb|\ch{B^{123}_{23}}| \ch{B^{123}_{23} +} \\
+\verb|\ch{H2O}| \ch{H2O} \\
+\verb|\ch{H2SO4}| \ch{H2SO4} \\
+\verb|\ch{Na+}| \ch{Na+} \\
+\verb|\ch{NH4+}| \ch{NH4+} \\
+\verb|\ch{SO4^2-}| \ch{SO4^2-}
+
+no shift:\chemsetup[chemformula]{charge-hshift=0pt}\\
+\verb|\ch{B3}| \ch{B3 +}\\
+\verb|\ch{B23}| \ch{B23 +}\\
+\verb|\ch{B123}| \ch{B123 +}\\
+\verb|\ch{B^3}| \ch{B^3 +}\\
+\verb|\ch{B^{23}}| \ch{B^{23} +}\\
+\verb|\ch{B^{123}}| \ch{B^{123} +}\\
+\verb|\ch{B3^3}| \ch{B3^3 +}\\
+\verb|\ch{B^33}| \ch{B^33 +}\\
+\verb|\ch{B123^{23}}| \ch{B123^{23} +}\\
+\verb|\ch{B_{123}^{23}}| \ch{B_{123}^{23} +}\\
+\verb|\ch{B^{23}123}| \ch{B^{23}123 +}\\
+\verb|\ch{B^{23}_{123}}| \ch{B^{23}_{123} +}\\
+\verb|\ch{B123^{23}}| \ch{B23^{123} +}\\
+\verb|\ch{B_{123}^{23}}| \ch{B_{23}^{123} +}\\
+\verb|\ch{B^{123}23}| \ch{B^{123}23 +}\\
+\verb|\ch{B^{123}_{23}}| \ch{B^{123}_{23} +} \\
+\verb|\ch{H2O}| \ch{H2O} \\
+\verb|\ch{H2SO4}| \ch{H2SO4} \\
+\verb|\ch{Na+}| \ch{Na+} \\
+\verb|\ch{NH4+}| \ch{NH4+} \\
+\verb|\ch{SO4^2-}| \ch{SO4^2-}
+
+ \ch{A^{x-}} \\
+ \ch{A^x-} \\
+ \ch{A^{x}-} \\
+ \ch{A^{$x-$}} \\
+ \ch{RNO2^{-.}} \\
+ \ch{^31H} \\
+ \ch{^{14}6C} \\
+ \ch{^{58}_{26}Fe} \\
+ \ch{NO^*} \\
+ \ch{SO4^2-} \ch{Ca^2+ SO4^2-}
+
+\chemsetup[option]{circled=all}
+ \ch{H+ + OH- <=> H2O}
+
+\chemsetup{option/circled=formal,chemformula/charge-hshift=.5ex}
+\ch{H^2} \ch[charge-vshift=.2ex]{H^2} H$^2$
+
+\[ \ch{SO4^2-} K = \frac{[\ch{Na+}]^2[\ch{SO4^2-}]}{[\ch{Na2SO4}]} \]
+
+\( K = \frac{\bigl[\ch{Na+}\bigr]^2\bigl[\ch{SO4^2-}\bigr]}{\bigl[\ch{Na2SO4}\bigr]} \)
+
+$ A^{\ch{SO4^2-}}$
+\end{document}
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros-codehelper.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros-codehelper.tex
index b55a80f5659..5c9ecaf919b 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros-codehelper.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros-codehelper.tex
@@ -5,7 +5,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2012/03/03                                                              - %
+% - 2012/03/12                                                              - %
 % --------------------------------------------------------------------------- %
 % - https://bitbucket.org/cgnieder/chemmacros/                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -100,6 +100,7 @@
           b,
           ba,
           bottomrule,
+          cancel,
           cd,
           cdot,
           ce,
@@ -387,6 +388,7 @@
           b,
           ba,
           bottomrule,
+          cancel,
           cd,
           cdot,
           ce,
@@ -576,17 +578,27 @@
     \endquote
   }
 
-\NewDocumentCommand \paket { sm }
+\makeatletter
+\NewDocumentCommand \paket { som }
   {
-    \textsf { #2 }
-    \cs_if_exist:cF { paket @ #2 }
+    \textsf { #3 }
+    \cs_if_exist:cF { paket @ #3 }
       {
-        \cs_new_nopar:cpn { paket @ #2 } { }
+        \cs_new_nopar:cpn { paket @ #3 } { }
         \IfBooleanF { #1 }
-          { \footnote { CTAN: ~ \href { http://www.ctan.org/pkg/#2/ } { #2 } } }
+          {
+            \footnote
+              {
+                CTAN: ~
+                \IfNoValueTF { #2 }
+                  { \hyper@linkurl { #3 } { http://www.ctan.org/pkg/#3/} }
+                  { \hyper@linkurl { #3 } { http://www.ctan.org/pkg/#2/} }
+              }
+          }
       }
-    \index { #2 @ \textsf { #2 } }
+    \index { #3 @ \textsf { #3 } }
   }
+\makeatother
 
 % #1: module #2: key #3: value
 \NewDocumentCommand \key { somg }
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.pdf b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.pdf
index b58d5e1337f..97531961b36 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.pdf
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.pdf
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.tex
index f5e3052eb48..2e32e0cf1b4 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.tex
@@ -5,7 +5,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2012/03/03                                                              - %
+% - 2012/03/14                                                              - %
 % --------------------------------------------------------------------------- %
 % - https://bitbucket.org/cgnieder/chemmacros/                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -35,12 +35,12 @@
 % > makeindex -sl index_de.ist chemmacros_doc_de.idx
 % > xelatex chemmacros_doc_de
 %
-\documentclass[DIV11,idx=totoc,toc=bib]{scrartcl}
+\documentclass[DIV11,toc=index,toc=bib]{scrartcl}
 \usepackage{fontspec,xltxtra}
 \usepackage{polyglossia}
   \setmainlanguage{german}
 \usepackage[normalem]{ulem}
-\usepackage{chemfig,chemstyle,upgreek,multicol,makeidx,booktabs,csquotes}
+\usepackage{chemfig,chemstyle,upgreek,textgreek,multicol,makeidx,booktabs,csquotes,cancel}
 \usepackage[german]{chemmacros}
 \usepackage[version=3]{mhchem}
 \usepackage[para]{footmisc}
@@ -103,6 +103,7 @@
               bookmarksopen      = true,
               bookmarksopenlevel = 1,
               bookmarksnumbered  = true,
+              bookmarksdepth     = paragraph,
               pdfauthor          = {Clemens Niederberger},
               pdftitle           = {chemmacros bundle - deutsche Dokumentation},
               pdfsubject         = {macros and commands for chemists},
@@ -226,6 +227,7 @@ Sowohl \chemformula als auch \ghsystem haben keine eigenen Paketoptionen. Wenn S
  \item \key[option]{bpchem}{\uline{true}/false} Diese Option lädt \paket{bpchem} und passt das Layout von \cmd{NMR} den \paket{bpchem}-Befehlen \lstinline+\HNMR+ und \lstinline+\CNMR+ an. Default = \texttt{false}
  \item \key[option]{circled}{\uline{formal}/all/none} \chemmacros unterscheidet zwischen zwei Typen von Ladungen\footnote{Vielen Dank an Christoph Schäfer, der mich darauf aufmerksam machte, dass v1.1 die Ladungen zu nachlässig behandelte!}: reale ($+/-$) und formale (\fplus/\fminus) Ladungen. Die Option \texttt{formal} unterscheidet zwischen ihnen, \texttt{none} stellt alle ohne Umkreisung dar, \texttt{all} umkreist alle. Default = \texttt{formal}
  \item \key[option]{circletype}{\uline{chem}/math} Diese Option schaltet zwischen zwei Darstellungsmöglichkeiten für formale Ladungen hin und her: \cmd{fplus} \fplus\ und \lstinline+$\oplus$+ $\oplus$. Default = \texttt{chem}
+  \item \key[option]{cmversion}{1/2/bundle} Diese Option stellt die Definition einiger Befehle wieder her, so dass Dokumente, die mit v1.* gesetzt wurden, Korrekt kompilieren. Default = \texttt{bundle}. Eigentlich sind \texttt{2} und \texttt{bundle} Aliase. Diese Option kann nur in der Präambel gesetzt werden. Notiz: Das ist nur die umbenannte ehemalige Option \key{version}.
  \item \key[option]{detect-bold}{\uline{true}/false} \emph{Diese Option ist veraltet und wird nicht mehr unterstützt!} 
  \item \key[option]{EZ}{\uline{chemmacros}/cool} \emph{Diese Option ist veraltet und wird nicht mehr unterstützt!}
  \item \key[option]{german}{\uline{true}/false} Diese Option ändert die Befehle \cmd{pKa}, \cmd{sld} und \cmd{lqd}. Default = \texttt{false}. Diese Option hat den Alias \key[option]{ngerman}.
@@ -236,7 +238,7 @@ Sowohl \chemformula als auch \ghsystem haben keine eigenen Paketoptionen. Wenn S
   \item \key[option]{strict}{\uline{true}/false} Die Einstellung \key{strict}{true} wird alle Warnungen in Fehlermeldungen ändern. Default = \texttt{false}
  \item \key[option]{synchronize}{\uline{true}/false} Mit der Einstellung \texttt{true} wird \chemmacros die Schrifteinstellungen von \chemformula übernehmen, falls \chemformula als Methode gewählt wurde. Default = \texttt{false}. Um diese Option zu demonstrieren, wurde dieses Dokument mit \key{synchronize}{true} und der \chemformula Einstellung \lstinline+\chemsetup[chemformula]{font-spec={[Color=darkgray]Latin Modern Sans}}+ gesetzt.
  \item \key[option]{upgreek}{none/textgreek/\uline{upgreek}} Diese Option bestimmt, wie die Buchstaben \ch{Chemalpha} und seine Verwandten dargestellt werden. Siehe Seite \pageref{key:upgreek} für weitere Informationen. Diese Option kann nur in der Präambel gesetzt werden. Default = \texttt{upgreek}
- \item \key[option]{version}{1/2/bundle} Diese Option stellt die Definition einiger Befehle wieder her, so dass Dokumente, die mit v1.* gesetzt wurden, Korrekt kompilieren. Default = \texttt{bundle}. Eigentlich sind \texttt{2} und \texttt{bundle} Aliase. Diese Option kann nur in der Präambel gesetzt werden.
+ \item \key[option]{version} Diese Option macht gar nichts und existiert nur wegen Kompatibilität für ältere Dokumente. Die Funktionalität wird nun durch die Option \key{cmversion} bereitgestellt. Die Umbenennung war nötig damit \chemmacros auch mit \paket[koma-script]{KOMA-Script} und dessen Option \texttt{version} funktioniert.
  \item \key[option]{xspace}{\uline{true}/false} Mit dieser Option werden die meisten Makros mit einem \lstinline+\xspace+ definiert. Default = \texttt{true}
 \end{description}
 \secidx*{Paketoptionen}
@@ -642,12 +644,12 @@ Die Verwenden von \key[ox]{explicit-sign} wird immer das Vorzeichen der Oxidatio
 \end{beispiel}
 
 \begin{beispiel}
- Vergleichen Sie \ox{-1,\ch{O2^2-}} mit \ch{"\ox{-1,O}" 2^2-}
+ Vergleichen Sie \ox{-1,\ch{O2^2-}} mit \ch{"\ox{-1,O}" {}2^2-}
 \end{beispiel}
 
 Manchmal muss man formale Oxidationszahlen wie \num{.5} oder $\frac{1}{3}$ verwenden:
 \begin{beispiel}
- \ox{.5,\ch{Br2}} \ch{"\ox{1/3,I}" 3+}
+ \ox{.5,\ch{Br2}} \ch{"\ox{1/3,I}" {}3+}
 \end{beispiel}
 
 Der Bruch verwendet den \lstinline+\sfrac+-Befehl des \paket{xfrac}-Pakets. Zu diesem Zweck wurde die Instanz \lstinline+chemmacros-ox-frac+ definiert.
@@ -1285,7 +1287,7 @@ Manche Optionen können ohne Wert verwendet werden. Dann wird der \uline{unterst
  bpchem              & option   & \uline{true}/false       & false                 & Seite \pageref{key:option_bpchem} \\
  circled             & option   & formal/\uline{all}/none  & formal                & Seite \pageref{key:option_circled} \\
  circletype          & option   & chem/math                & chem                  & Seite \pageref{key:option_circletype} \\
-%  detect-bold         & option   & \uline{true}/false       & false                 & Seite \pageref{key:option_detect-bold} \\
+ cmversion           & option   & 1/2/bundle               & bundle                & Seite \pageref{key:option_version} \\
  german              & option   & \uline{true}/false       & false                 & Seite \pageref{key:option_german} \\
  ghs                 & option   & \uline{true}/false       & true                  & Seite \pageref{key:option_ghs} \\
  iupac               & option   & auto/restricted/strict   & auto                  & Seite \pageref{key:option_iupac} \\
@@ -1294,7 +1296,7 @@ Manche Optionen können ohne Wert verwendet werden. Dann wird der \uline{unterst
  strict              & option   & \uline{true}/false       & false                 & Seite \pageref{key:option_strict} \\
  synchronize         & option   & \uline{true}/false       & false                 & Seite \pageref{key:option_synchronize} \\
  upgreek             & option   & none/textgreek/\uline{upgreek} & upgreek         & Seite \pageref{key:option_upgreek} \\
- version             & option   & 1/2/bundle               & bundle                & Seite \pageref{key:option_version} \\
+ version             & option   &                          &                       & Seite \pageref{key:option_version} \\
  xspace              & option   & \uline{true}/false       & true                  & Seite \pageref{key:option_xspace} \\
  \multicolumn{5}{l}{\cmd{ba}, \cmd{Nu}:} \\
  elpair              & particle & \uline{dots}/dash/false  & false                 & Seite \pageref{key:particle_elpair} \\
@@ -1837,11 +1839,7 @@ Es gibt einige vordefinierte Koordinaten, die Sie verwenden können und sollten:
 \begin{beispiel}
  \DeclareChemArrow{.>}{\draw[-cf,dotted,red] (cf_arrow_start) -- (cf_arrow_end);}
  \DeclareChemArrow{n>}{\draw[-cf] (cf_arrow_start) .. controls ([yshift=3ex]cf_arrow_mid) .. (cf_arrow_end);}
- \DeclareChemArrow{==}{
-  \draw ([yshift=.2ex]cf_arrow_mid_start) -- ([yshift=.2ex]cf_arrow_mid_end);
-  \draw ([yshift=-.2ex]cf_arrow_mid_start) -- ([yshift=-.2ex]cf_arrow_mid_end);
- }
- \ch{A .> B} \ch{A .>[a][b] B} \ch{A n> B} \ch{A == B}
+ \ch{A .> B} \ch{A .>[a][b] B} \ch{A n> B}
 \end{beispiel}
 Wenn Sie einen existierenden Pfeil umdefinieren möchten, können Sie folgende zwei Befehle verwenden:
 \begin{description}
@@ -2013,6 +2011,18 @@ Dieser Abschnitt zeigt weitere Beispiele für die Verwendung von \chemformula, a
   H3C-CH2 "\Lewis{0.,\vphantom{H}}" + Cl2 &-> H3CCH2Cl + "\Lewis{0.,Cl}"             & &"\Enthalpy{-23.0}"
  \end{reactions*}
 \end{beispiel}
+
+Das folgende Beispiel zeigt, wie das kürzen von Formeln erreicht werden kann\footnote{Inspiriert durch eine Frage auf TeX.SE: \url{http://tex.stackexchange.com/q/30118/5049}}.
+\begin{beispiel}
+ % needs `cancel'
+ \begin{align*}
+  \centering
+  \ch{\cancel{HCOOH\aq} + H2O\lqd{}  &<=> H3O^+\aq{} + \cancel{HCOO^-\aq}} \\
+  \ch{\cancel{HCOO^-\aq} + H2O\lqd{} &<=> \cancel{HCOOH\aq} + OH^-\aq}\\[-1ex]
+  \cline{1-2}
+  \ch{H2O\lqd{} + H2O\lqd{} &<=> H3O^+\aq{} + OH^-\aq}    
+ \end{align*}
+\end{beispiel}
 \secidx*{CHEMFORMULA}
 
 \part{\texorpdfstring{\Ghsystem}{ghsystem}}\secidx{GHSYSTEM}
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.pdf b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.pdf
index c0cbfaa9826..3b11acc09a2 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.pdf
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.pdf
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex
index 56a2303fb32..09d57866e1a 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex
@@ -5,7 +5,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2012/03/03                                                              - %
+% - 2012/03/14                                                              - %
 % --------------------------------------------------------------------------- %
 % - https://bitbucket.org/cgnieder/chemmacros/                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -40,7 +40,7 @@
 \usepackage{polyglossia}
   \setmainlanguage{english}
 \usepackage[normalem]{ulem}
-\usepackage{chemfig,chemstyle,upgreek,textgreek,multicol,makeidx,booktabs,csquotes}
+\usepackage{chemfig,chemstyle,upgreek,textgreek,multicol,makeidx,booktabs,csquotes,cancel}
 \usepackage{chemmacros}
 \usepackage[version=3]{mhchem}
 \usepackage[para]{footmisc}
@@ -72,7 +72,7 @@
 \addbibresource{\jobname.bib}
 \begin{filecontents}{\jobname.bib}
 @book{iupac:greenbook,
-  author    = {E. Richard Cohan and Tomislav Cvita\v{s} and Jeremy G. Frey and Bertil Holmström and Kozo Kuchitsu and Roberto Marquardt and Ian Mills and Franco Pavese and Martin Quack and Jürgan Stohner and Herbert L. Strauss and Michio Takami and Anders J Thor},
+  author    = {E. Richard Cohan and Tomislav Cvita\v{s} and Jeremy G. Frey and Bertil Holmström and Kozo Kuchitsu and Roberto Marquardt and Ian Mills and Franco Pavese and Martin Quack and Jürgan Stohner and Herbert L. Strauss and Michio Takami and Anders J Thor},
   title     = {“Quantities, Symbols and Units in Physical Chemistry”, \IUPAC Green Book},
   edition   = {3rd Edition. 2nd Printing},
   year      = {2008},
@@ -103,6 +103,7 @@
               bookmarksopen      = true,
               bookmarksopenlevel = 1,
               bookmarksnumbered  = true,
+              bookmarksdepth     = paragraph,
               pdfauthor          = {Clemens Niederberger},
               pdftitle           = {chemmacros bundle - English documentation},
               pdfsubject         = {macros and commands for chemists},
@@ -224,6 +225,7 @@ Both \chemformula and \ghsystem don't have package options of their own. If you
  \item \key[option]{bpchem}{\uline{true}/false} This option loads the package \paket{bpchem} and adjusts the layout of the \cmd{NMR} command to the \paket{bpchem} commands \lstinline+\HNMR+ and \lstinline+\CNMR+. (default = \texttt{false})
  \item \key[option]{circled}{\uline{formal}/all/none} \chemmacros uses two different kinds of charges\footnote{Thanks to Christoph Sch\"afer, who pointed out to me, that v1.1 handled the charges too sloppy!}, which indicate the usage of real ($+/-$) and formal (\fplus/\fminus) charges. The option \texttt{formal} distinguishes between them, option \texttt{none} displays them all without circle, option \texttt{all} circles all (default = \texttt{formal})
  \item \key[option]{circletype}{\uline{chem}/math} This option switches between two kinds of circled charge symbols: \cmd{fplus} \fplus\ and \lstinline+$\oplus$+ $\oplus$. (default = \texttt{chem})
+ \item \key[option]{cmversion}{1/2/bundle} This option restores the old definitions of some commands, so documents set with v1.* will still compile correctly. (default = \texttt{bundle}). Actually \texttt{2} and \texttt{bundle} are only aliases. This option can only be chosen in the preamble. Note: this is a new name for the now deprecated option \key{version}.
  \item \key[option]{detect-bold}{\uline{true}/false} \emph{This option is deprecated!}
  \item \key[option]{EZ}{\uline{chemmacros}/cool} \emph{This option is deprecated!}
  \item \key[option]{german}{\uline{true}/false} This option changes the commands \cmd{pKa}, \cmd{sld} and \cmd{lqd} (default = \texttt{false}). This option has the alias \key[option]{ngerman}.
@@ -234,7 +236,7 @@ Both \chemformula and \ghsystem don't have package options of their own. If you
  \item \key[option]{strict}{\uline{true}/false} Setting \key{strict}{true} will turn all warning messages into erros messages. (default = \texttt{false})
  \item \key[option]{synchronize}{\uline{true}/false} The setting \texttt{true} will tell \chemmacros the adapt the font settings of \chemformula if that method has been chosen (default = \texttt{false}). In order to demonstrate this feature this document is set with \key{synchronize}{true} and the \chemformula setting \lstinline+\chemsetup[chemformula]{font-spec={[Color=darkgray]Latin Modern Sans}}+.
  \item \key[option]{upgreek}{none/textgreek/\uline{upgreek}} This Options determines how the letters \ch{Chemalpha} and friends are typeset. See page \pageref{key:upgreek} for more information. This option can only be chosen in the preamble. (default = \texttt{upgreek})
- \item \key[option]{version}{1/2/bundle} This option restores the old definitions of some commands, so documents set with v1.* will still compile correctly. (default = \texttt{bundle}). Actually \texttt{2} and \texttt{bundle} are only aliases. This option can only be chosen in the preamble.
+ \item \key[option]{version} This option does nothing and only exists for backwards compatibility. The functionality is now provided by the option \key{cmversion}. The option has been renamed so \chemmacros is compatible with the global option \texttt{version} of \paket[koma-script]{KOMA-script}.
  \item \key[option]{xspace}{\uline{true}/false} With this option most commands are defined with a \lstinline+\xspace+. (default = \texttt{true})
 \end{description}
 \secidx*{Package Options}
@@ -345,7 +347,7 @@ Depending on the \key{method} you chose as option the \texttt{<definition>} will
 
 \section{Nomenclature, Stereo Descriptors, Latin Phrases}\label{sec:stereo}
 \subsection{\IUPAC Names}\secidx{IUPAC Names}
-Similar to the \paket{bpchem} package \chemmacros provides a command\footnote{The idea and the implementation is shamelessly borrowed from \paket*{bpchem} by Bjørn Pedersen.} to typeset \IUPAC names. Why is that useful? \IUPAC names can get very long. So long indeed that they span over more than two lines, especially in two-column documents. This means they must be allowed to be broken more than one time. This is what the following command does.
+Similar to the \paket{bpchem} package \chemmacros provides a command\footnote{The idea and the implementation is shamelessly borrowed from \paket*{bpchem} by Bjørn Pedersen.} to typeset \IUPAC names. Why is that useful? \IUPAC names can get very long. So long indeed that they span over more than two lines, especially in two-column documents. This means they must be allowed to be broken more than one time. This is what the following command does.
 \begin{description}
  \item\cmd{iupac}{<IUPAC name>} Inside this command use \cmd{\textbar} and \cmd{-} to indicate a breaking point or a breaking dash. Use \cmd{\textasciicircum} as a shortcut for \lstinline=\textsuperscript=\footnote{Actually \cmd{\textasciicircum} uses a \chemformula command instead.}.
 \end{description}
@@ -539,7 +541,7 @@ Easy representation of \pH, \pKa \ldots (the command \cmd{pKa} depends on the pa
 
 \achtung{The default appearance of the \p{}-commands has changed to follow \IUPAC recommendations.}
 \begin{myquote}[\IUPAC Green Book \cite[][p.\,103]{iupac:greenbook}]
- The operator \p{} […] shall be printed in Roman type.
+ The operator \p{} […] shall be printed in Roman type.
 \end{myquote}
 
 There is one option which changes the style the \p{} is typeset:
@@ -640,12 +642,12 @@ Using the \key[ox]{explicit-sign} key will always show the sign of the oxidation
 \end{beispiel}
 
 \begin{beispiel}
- Compare \ox{-1,\ch{O2^2-}} to \ch{"\ox{-1,O}" 2^2-}
+ Compare \ox{-1,\ch{O2^2-}} to \ch{"\ox{-1,O}" {}2^2-}
 \end{beispiel}
 
 Sometimes one might want to use formal oxidation numbers like \num{.5} or $\frac{1}{3}$:
 \begin{beispiel}
- \ox{.5,\ch{Br2}} \ch{"\ox{1/3,I}" 3+}
+ \ox{.5,\ch{Br2}} \ch{"\ox{1/3,I}" {}3+}
 \end{beispiel}
 
 The fraction uses the \lstinline+\sfrac+ command of the \paket{xfrac} package. For this purpose the instance \lstinline+chemmacros-ox-frac+ is defined.
@@ -1273,6 +1275,7 @@ Some keys can be set without value. Then the \uline{underlined} value is used.
  bpchem              & option   & \uline{true}/false       & false                 & page \pageref{key:option_bpchem} \\
  circled             & option   & formal/\uline{all}/none  & formal                & page \pageref{key:option_circled} \\
  circletype          & option   & chem/math                & chem                  & page \pageref{key:option_circletype} \\
+ version             & option   & 1/2/bundle               & bundle                & page \pageref{key:option_version} \\
  german              & option   & \uline{true}/false       & false                 & page \pageref{key:option_german} \\
  ghs                 & option   & \uline{true}/false       & true                  & page \pageref{key:option_ghs} \\
  iupac               & option   & auto/restricted/strict   & auto                  & page \pageref{key:option_iupac} \\
@@ -1281,7 +1284,7 @@ Some keys can be set without value. Then the \uline{underlined} value is used.
  strict              & option   & \uline{true}/false       & false                 & page \pageref{key:option_strict} \\
  synchronize         & option   & \uline{true}/false       & false                 & page \pageref{key:option_synchronize} \\
  upgreek             & option   & none/textgreek/\uline{upgreek} & upgreek         & page \pageref{key:option_upgreek} \\
- version             & option   & 1/2/bundle               & bundle                & page \pageref{key:option_version} \\
+ version             & option   &                          &                       & page \pageref{key:option_version} \\
  xspace              & option   & \uline{true}/false       & true                  & page \pageref{key:option_xspace} \\
  \multicolumn{5}{l}{\cmd{ba}, \cmd{Nu}:} \\
  elpair              & particle & \uline{dots}/dash/false  & false                 & page \pageref{key:particle_elpair} \\
@@ -1939,7 +1942,7 @@ The \cmd{ch} command can be used inside math equations. It recognizes \lstinline
 \secidx*{Math Environments}
 
 \section{Further Examples}
-This section just presents some examples of a possible usage.
+This section presents some examples of a possible usage.
 
 \begin{beispiel}
  \begin{reaction}[Synthese von Alkanen]
@@ -1977,6 +1980,18 @@ This section just presents some examples of a possible usage.
   H3C-CH2 "\Lewis{0.,\vphantom{H}}" + Cl2 &-> H3CCH2Cl + "\Lewis{0.,Cl}"             & &"\Enthalpy{-23.0}"
  \end{reactions*}
 \end{beispiel}
+
+The following example shows how the cancelling of compounds could be done\footnote{Inspired by a question on TeX.SE: \url{http://tex.stackexchange.com/q/30118/5049}}.
+\begin{beispiel}
+ % needs `cancel'
+ \begin{align*}
+  \centering
+  \ch{\cancel{HCOOH\aq} + H2O\lqd{}  &<=> H3O^+\aq{} + \cancel{HCOO^-\aq}} \\
+  \ch{\cancel{HCOO^-\aq} + H2O\lqd{} &<=> \cancel{HCOOH\aq} + OH^-\aq}\\[-1ex]
+  \cline{1-2}
+  \ch{H2O\lqd{} + H2O\lqd{} &<=> H3O^+\aq{} + OH^-\aq}    
+ \end{align*}
+\end{beispiel}
 \secidx*{CHEMFORMULA}
 
 \part{\texorpdfstring{\Ghsystem}{ghsystem}}\secidx{GHSYSTEM}
diff --git a/Master/texmf-dist/tex/latex/chemmacros/chemformula.sty b/Master/texmf-dist/tex/latex/chemmacros/chemformula.sty
index a5555476e0d..11b5e014f7f 100644
--- a/Master/texmf-dist/tex/latex/chemmacros/chemformula.sty
+++ b/Master/texmf-dist/tex/latex/chemmacros/chemformula.sty
@@ -5,7 +5,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2012/03/03                                                              - %
+% - 2012/03/14                                                              - %
 % --------------------------------------------------------------------------- %
 % - https://bitbucket.org/cgnieder/chemmacros/                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -30,8 +30,8 @@
 \RequirePackage{ expl3 }
 \ProvidesExplPackage
   {chemformula}
-  {2012/03/03}
-  {3.1b}
+  {2012/03/14}
+  {3.1c}
   {typeset chemical compounds and reactions}
 
 %-----------------------------------------------------------------------------%
@@ -251,9 +251,9 @@
 % determine length in dependency of labels
 \cs_new:Npn \chemformula_determine_arrow_length:nn #1#2
   {
-    \hbox_set:Nn \l_tmpa_box { { #1 } }
+    \box_set_eq:NN \l_tmpa_box #1
     \dim_set:Nn \l_tmpa_dim { \box_wd:N \l_tmpa_box }
-    \hbox_set:Nn \l_tmpa_box { { #2 } }
+    \box_set_eq:NN \l_tmpa_box #2
     \dim_set:Nn \l_tmpb_dim { \box_wd:N \l_tmpa_box }
     \box_clear:N \l_tmpa_box
     \dim_compare:nTF { \l_tmpa_dim >= \l_tmpb_dim }
@@ -290,8 +290,8 @@
 \prop_new:N \l_chemformula_arrows_code_prop
 \seq_new:N \l_chemformula_arrows_type_seq
 \tl_new:N \l_chemformula_arrow_type_tl
-\tl_new:N \l_chemformula_arrow_arg_i_tl
-\tl_new:N \l_chemformula_arrow_arg_ii_tl
+\box_new:N \l_chemformula_arrow_arg_i_box
+\box_new:N \l_chemformula_arrow_arg_ii_box
 
 % read optional arguments
 \cs_new_nopar:Npn \l_chemformula_arrow_read_args:w
@@ -303,7 +303,8 @@
 
 \cs_new_nopar:Npn \l_chemformula_arrow_read_args_aux_i:w [#1]
   {
-    \tl_set:Nn \l_chemformula_arrow_arg_i_tl { #1 }
+    \hbox_set:Nn \l_chemformula_arrow_arg_i_box
+      { \tl_use:N \l_chemformula_arrow_label_style_tl #1 }
     \peek_meaning:NTF [
       { \l_chemformula_arrow_read_args_aux_ii:w }
       { \l_chemformula_arrow_read_args_aux_iii: }
@@ -311,7 +312,8 @@
 
 \cs_new_nopar:Npn \l_chemformula_arrow_read_args_aux_ii:w [#1]
   {
-    \tl_set:Nn \l_chemformula_arrow_arg_ii_tl { #1 }
+    \hbox_set:Nn \l_chemformula_arrow_arg_ii_box
+      { \tl_use:N \l_chemformula_arrow_label_style_tl #1 }
     \l_chemformula_arrow_read_args_aux_iii:
   }
 
@@ -329,8 +331,8 @@
 \cs_new_nopar:Npn \chemformula_arrows_get:n #1
   {
     % first clear the arguments
-    \tl_clear:N \l_chemformula_arrow_arg_i_tl
-    \tl_clear:N \l_chemformula_arrow_arg_ii_tl
+    \box_clear:N \l_chemformula_arrow_arg_i_box
+    \box_clear:N \l_chemformula_arrow_arg_ii_box
     % then get the arrow type
     \tl_set:Nn \l_chemformula_arrow_type_tl { #1 }
     \l_chemformula_arrow_read_args:w
@@ -343,9 +345,9 @@
     % TODO: flexible Pfeilspitzen, TikZ-Keys ermöglichen
     \tl_set_rescan:Nnn \l_tmpc_tl { \char_set_catcode_letter:N \_ } { #1 }
     % determine length of the arrow
-    \chemformula_determine_arrow_length:oo
-      { \l_chemformula_arrow_arg_i_tl }
-      { \l_chemformula_arrow_arg_ii_tl }
+    \chemformula_determine_arrow_length:NN
+      \l_chemformula_arrow_arg_i_box
+      \l_chemformula_arrow_arg_ii_box
     \chemformula_tikz:nf
       { inner~sep=0, baseline=(chemformula_arrow_start.base) }
       {
@@ -370,23 +372,17 @@
         % the arrow labels:
         \draw
             node
-              [
-                above=\l_chemformula_arrow_label_offset_dim,
-                font=\l_chemformula_arrow_label_style_tl,
-                butt~cap-butt~cap
-              ] at (cf_arrow_mid) { \l_chemformula_arrow_arg_i_tl }
+              [ above=\l_chemformula_arrow_label_offset_dim ] at (cf_arrow_mid)
+              { \box_use:N \l_chemformula_arrow_arg_i_box }
             node
-              [
-                below=\l_chemformula_arrow_label_offset_dim,
-                font=\l_chemformula_arrow_label_style_tl,
-                butt~cap-butt~cap
-              ] at (cf_arrow_mid) { \l_chemformula_arrow_arg_ii_tl }
+              [ below=\l_chemformula_arrow_label_offset_dim ] at (cf_arrow_mid)
+              { \box_use:N \l_chemformula_arrow_arg_ii_box }
           ;
         \tl_use:N \l_tmpc_tl
       }
   }
 \cs_generate_variant:Nn \chemformula_arrow_draw:n { V }
-\cs_generate_variant:Nn \chemformula_determine_arrow_length:nn { oo }
+\cs_generate_variant:Nn \chemformula_determine_arrow_length:nn { NN }
 
 % commands to declare arrows (can also be used by users):
 %  #1: symbol, #2: code
@@ -1696,6 +1692,8 @@ VERSION HISTORY
                             various flaws: clear distinction between isotope and
                             formula
                           - new option charge-vshift
+2012/03/14 - version 3.1c - a few changes in chemmacros.sty
+                          - improved arrow labels
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % TODO
diff --git a/Master/texmf-dist/tex/latex/chemmacros/chemmacros.sty b/Master/texmf-dist/tex/latex/chemmacros/chemmacros.sty
index c12b04033ca..77dab7f9d0c 100644
--- a/Master/texmf-dist/tex/latex/chemmacros/chemmacros.sty
+++ b/Master/texmf-dist/tex/latex/chemmacros/chemmacros.sty
@@ -5,7 +5,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2012/03/03                                                              - %
+% - 2012/03/14                                                              - %
 % --------------------------------------------------------------------------- %
 % - https://bitbucket.org/cgnieder/chemmacros/                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -33,8 +33,8 @@
 
 \ProvidesExplPackage
   {chemmacros}
-  {2012/03/03}
-  {3.1b}
+  {2012/03/14}
+  {3.1c}
   {macros and commands for chemists}
 
 \@ifpackageloaded { chemformula } {} { \RequirePackage { chemformula } }
@@ -181,12 +181,16 @@
       \bool_set_false:N \l_chemmacros_use_upgreek_bool
       \bool_set_false:N  \l_chemmacros_use_textgreek_bool ,
     upgreek            .default:n  = upgreek ,
-    version            .choice: ,
-    version / 1        .code:n     =
+    % dummy version for compatibility with KOMA's global option and backwards
+    % compatibility of chemmacros
+    version            .code:n     = ,
+    % TODO: neuen Namen finden!
+    cmversion          .choice: ,
+    cmversion / 1      .code:n     =
       { \bool_set_true:N \l_chemmacros_version_one_bool } ,
-    version / 2        .code:n     =
+    cmversion / 2      .code:n     =
       { \bool_set_false:N \l_chemmacros_version_one_bool } ,
-    version / bundle   .code:n     =
+    cmversion / bundle .code:n     =
       { \bool_set_false:N \l_chemmacros_version_one_bool } ,
     xspace             .bool_set:N = \l_chemmacros_xspace_bool ,
     xspace             .default:n  = true
@@ -1833,7 +1837,7 @@
               {
                 \addcontentsline { lor } { reaction }
                   {
-                    \l_chemmacros_reaction_lorname_tl #3 ##1 #4
+                    \l_chemmacros_reaction_lorname_tl #3 #2 ##1 #4
                     \tl_use:c { l_chemmacros_reaction_ \thereaction _tl }
                   }
               }
@@ -1881,6 +1885,7 @@
     \bool_if:NTF \l_chemmacros_version_one_bool
       { \usetagform { CMreaction } }
       { \usetagform { reaction } }
+    % => this is problematic because it disallows resetting the counter:
     \tl_new:c { l_chemmacros_reaction_ \thereaction _tl }
   }
 
@@ -3257,6 +3262,9 @@ Version history
                           - deprecated option: "option/detect-bold"
 2012/03/03 - version 3.1b - changes in the chemformula package
                           - IUPAC compliance for \Delta and \ox
+2012/03/14 - version 3.1c - compatibility with KOMA's global option
+                            "version = <value>"
+                          - bugfix in the list of reactions
 
 % --------------------------------------------------------------------------- %
 % TODO:
diff --git a/Master/texmf-dist/tex/latex/chemmacros/ghsystem.sty b/Master/texmf-dist/tex/latex/chemmacros/ghsystem.sty
index 43a250ef30a..72e2ab854e7 100644
--- a/Master/texmf-dist/tex/latex/chemmacros/ghsystem.sty
+++ b/Master/texmf-dist/tex/latex/chemmacros/ghsystem.sty
@@ -5,7 +5,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2012/03/03                                                              - %
+% - 2012/03/14                                                              - %
 % --------------------------------------------------------------------------- %
 % - https://bitbucket.org/cgnieder/chemmacros/                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -30,8 +30,8 @@
 \RequirePackage{ expl3 }
 \ProvidesExplPackage
   {ghsystem}
-  {2012/03/03}
-  {3.1b}
+  {2012/03/14}
+  {3.1c}
   {globally harmonised system}
 
 % --------------------------------------------------------------------------- %
@@ -454,6 +454,7 @@ VERSION HISTORY
                             package
 2012/02/26 - version 3.1a - changes in the chemmacros package
 2012/03/03 - version 3.1b - changes in packages chemformula and chemmacros
+2012/03/14 - version 3.1c - changes in packages chemformula and chemmacros
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % TODO:
diff --git a/Master/texmf-dist/tex/latex/chemmacros/language/ghsystem_langtemplate.def b/Master/texmf-dist/tex/latex/chemmacros/language/ghsystem_langtemplate.def
index d0e308f4a70..cd39ca89831 100644
--- a/Master/texmf-dist/tex/latex/chemmacros/language/ghsystem_langtemplate.def
+++ b/Master/texmf-dist/tex/latex/chemmacros/language/ghsystem_langtemplate.def
@@ -5,7 +5,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2012/01/30                                                              - %
+% - 2012/03/03                                                              - %
 % --------------------------------------------------------------------------- %
 % - http://www.mychemistry.eu/                                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -27,6 +27,51 @@
 % -                                                                         - %
 % - The Current Maintainer of this work is Clemens Niederberger.            - %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% A few informations how to use this template:
+%
+% The H, EUH, and P statements are stored in a property list, respectively.
+% The commands for adding a respective entry are pre-typed so you only have to
+% fill in the missing text.
+% The commands are in a logical order (first H then EUH then P, numbers
+% increasing) and have hints where to find the corresponding statements in the
+% EU regulation 1272/2008.
+% You will notice that some of the gaps are pre-filled with commands like
+% `\ghsystem_exposure:'. These commands are called “fill-in functions” and put a
+% corresponding replacement text in their position depending on package options
+% used. They should _not_ be replaced but be in the corresponding position in
+% statement where the replacement text should appear.
+%
+% You need to know:
+% - every gap that is to be filled is indicated be three dots: ...
+% - you need to take care of hyphenation by adding \- at the appropriate places
+% - you need to take care of special symbols such as ä replaced with \"a etc.
+%   so the statements can be used with latex, pdflatex, xelatex, and lualatex as
+%   well
+% - for the fill-in functions the original English text is given to help you
+%   identify the right one
+%
+% You may find it helpful to have a look at existing language files. You'll find
+% them in the directory of chemmacros in your TeX installation in a
+% sub-directory called `language'.
+%
+% To test your language file you have to name it
+%   \ghsystem_<language name>.def
+% for example by replacing `langtemplate' in the name of this file. Then place a
+% copy in the `language' directory of chemmacros. You now can use it with
+%   \chemsetup[ghsystem]{language=<language name>}
+% I suggest running a test file similar to this:
+% -----------------------------------------------------------------------------
+% \documentclass{article}
+% \usepackage{chemmacros}
+% \chemsetup[ghsystem]{language=<language name>,fill-in=true}
+% \begin{document}
+% 
+% \ghslistall
+% 
+% \end{document}
+% -----------------------------------------------------------------------------
+%
 \ExplSyntaxOn
 % <LANGUAGE> DEFINITIONS
 \prop_clear:N \l_ghsystem_h_prop