summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex')
-rw-r--r--Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex136
1 files changed, 105 insertions, 31 deletions
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 09d57866e1a..1a599ca9f70 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex
@@ -35,7 +35,7 @@
% > makeindex -sl index_en.ist chemmacros_doc_en.idx
% > xelatex chemmacros_doc_en
%
-\documentclass[DIV11,idx=totoc,toc=bib]{scrartcl}
+\documentclass[DIV11,toc=index,toc=bib]{scrartcl}
\usepackage{fontspec,xltxtra}
\usepackage{polyglossia}
\setmainlanguage{english}
@@ -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ürgen 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},
@@ -85,6 +85,13 @@
journal = {Official Journal of the European Union},
date = {2008-12-16}
}
+@online{unece:ghsystem_implementation,
+ author = {United Nations Economic Commission for Europe},
+ title = {GHS Implementation},
+ url = {http://www.unece.org/trans/danger/publi/ghs/implementation_e.html},
+ urldate = {2012-03-20},
+ date = {2012-03-20}
+}
\end{filecontents}
\DeclareInstance{xfrac}{chemformula-text-frac}{text}
@@ -159,7 +166,7 @@
\section{Licence, Requirements and README}
The \chemmacros bundle underlies the \LaTeX\ project public license (lppl) version 1.3 or later. (\url{http://www.latex-project.org/lppl.txt})
-The \chemmacros bundle needs the bundles \paket{l3kernel} and \paket{l3packages}.It also needs the packages \paket{siunitx}, \paket{mathtools}, \paket{bm}, \paket{nicefrac} and \paket{environ} as well as \paket*{tikz}\footnote{CTAN: \href{http://www.ctan.org/pkg/pgf/}{pgf}} and the \TikZ libraries \texttt{calc} and \texttt{arrows}.
+The \chemmacros bundle needs the bundles \paket{l3kernel} and \paket{l3packages}. It also needs the packages \paket{siunitx}, \paket{mathtools}, \paket{bm}, \paket{nicefrac} and \paket{environ} as well as \paket*{tikz}\footnote{CTAN: \href{http://www.ctan.org/pkg/pgf/}{pgf}} and the \TikZ libraries \texttt{calc} and \texttt{arrows}.
Package option \key{bpchem} (section \ref{sec:optionen}) needs the package \paket{bpchem}, package option \key{xspace} needs the package \paket{xspace} and package option \key{method}{mhchem} needs the package \paket{mhchem}.
@@ -178,7 +185,7 @@ I would guess that nearly every chemist using \LaTeXe\ is aware of the great \pa
\chemformula works very similar to \paket{mhchem} but is more strict as to how compounds, stoichiometric factors and arrows are input. In the same time \chemformula offers possibilities to customize the output that \paket{mhchem} does not. Since \chemformula is meant as an \emph{alternative} to \paket{mhchem} \chemmacros offers a package option allowing you to choose which one of the two is used.
-As a chemist you are probably aware of the fact that the \textsc{United Nations} have developed the \enquote{\textbf{G}lobally \textbf{H}armonized \textbf{S}ystem of Classification and Labelling of Chemicals} (GHS) as a global replacement for the various different systems in different countries. While it has not been implemented by all countries yet\footnote{\url{http://www.unece.org/trans/danger/publi/ghs/implementation_e.html}}, it as only a matter of time.
+As a chemist you are probably aware of the fact that the \textsc{United Nations} have developed the \enquote{\textbf{G}lobally \textbf{H}armonized \textbf{S}ystem of Classification and Labelling of Chemicals} (GHS) as a global replacement for the various different systems in different countries. While it has not been implemented by all countries yet\cite{unece:ghsystem_implementation}, it as only a matter of time.
The package \ghsystem now enables you to typeset all the hazard and precautionary statements and pictograms in a very easy way. The statements are taken from EU regulation 1272/2008 \cite{eu:ghsystem_regulation}.
@@ -189,7 +196,7 @@ There are four points I hope I have achieved with this bundle:
\item as much customizability as I could think of so every user can adapt the commands to his or her own wishes
\item \IUPAC compliant default settings
\end{itemize}
-Especially the last point needed some pushing from users\footnote{Many thanks to Dr.~Paul~King!} to get things right in many places. If you find anything not compliant with \IUPAC recommendations\footnote{This does not convern the \cmd{ox} command. The \IUPAC version is \cmd[oxa]{ox*}.} I would welcome an email very much!
+Especially the last point needed some pushing from users to get things right in many places. If you find anything not compliant with \IUPAC recommendations\footnote{This does not convern the \cmd{ox} command. The \IUPAC version is \cmd[oxa]{ox*}.} I would welcome an email very much!
\section{Installation, Loading the Bundle}\secidx{Loading the Bundle}\secidx{Installation}
The bundle comes with three style files\footnote{Those ending \texttt{sty}.}, a directory called \texttt{language/} containing the language-definition files for GHS (ending \texttt{def}), and a directory \texttt{pictures/} containing \texttt{eps}, \texttt{jpg} and \texttt{png} files (the GHS pictogramms). If you install the bundle manually \emph{please make sure to place the directories \texttt{language/} and \texttt{pictures/} in the \emph{same} directory as the style files}.
@@ -200,7 +207,7 @@ Loading \chemmacros with
\end{beispiel}
will also load \chemformula and \ghsystem. However, you can prevent \chemmacros from loading \ghsystem:
\begin{beispiel}[code only]
- \usepackage[ghs=false]{chemmacros} % `chemmacros' and `formula' are loaded
+ \usepackage[ghsystem=false]{chemmacros} % `chemmacros' and `formula' are loaded
\end{beispiel}
Loading \chemformula or \ghsystem explicitly is possible and will also load \chemmacros if it hasn't been loaded yet, and will therefore implicitly load the other package, too.
@@ -223,20 +230,20 @@ Some also can be used without value (\lstinline+\usepackage[option1]{chemmacros}
Both \chemformula and \ghsystem don't have package options of their own. If you load them explicitly you can give them \chemmacros' options instead and they will pass them on to \chemmacros.
\begin{description}
\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]{circled}{\uline{formal}/all/none} \chemmacros uses two different kinds of charges 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}.
- \item \key[option]{ghs}{\uline{true}/false} Disable the use of the \ghsystem package. Setting \key{ghs}{false} will prevent \chemmacros from loading \ghsystem. (default = \texttt{true})
+ \item \key[option]{ghsystem}{\uline{true}/false} Disable the use of the \ghsystem package. Setting \key{ghs}{false} will prevent \chemmacros from loading \ghsystem. (default = \texttt{true})
\item \key[option]{iupac}{auto/restricted/strict} Take care of how iupac naming commands are defined, see page \pageref{key:iupac} (default = \texttt{auto})
\item \key[option]{method}{\uline{chemformula}/mhchem} You can choose the method which \chemmacros will use for the reaction environments (see section \ref{ssec:mhchem_reaktionen}) and the typesetting of the particles (see section \ref{sec:teilchen}). (default = \texttt{chemformula}). This option can only be chosen in the preamble.
\item \key[option]{Nu}{\uline{chemmacros}/mathspec} The package \paket{mathspec} also defines a macro \cmd{Nu}. This option chooses which definition holds, see page \pageref{Nu}. (default = \texttt{chemmacros}). This option can only be chosen in the preamble.
\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} 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]{upgreek}{none/textgreek/\uline{upgreek}} This Options determines how the letters \cmd{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} \emph{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}
@@ -486,19 +493,32 @@ A command defined in this way will obey the setting of the option \key[option]{i
\secidx*{IUPAC Names}
\subsection{Latin Phrases}\secidx{Latin Phrases}
-At last there are two commands for common latin phrases.
+The package \paket{chemstyle} provides the command \cmd{latin} to typeset common latin phrases in a consistent way. \chemmacros defines a similar \cmd{latin} only if \paket{chemstyle} has \emph{not} been loaded and additionally provides these commands:
\begin{description}
\item \cmd{insitu} \insitu
\item \cmd{abinitio} \abinitio
+ \item \cmd{invacuo} \invacuo
\end{description}
-If the package \paket{chemstyle} has been loaded, too\footnote{\paket*{chemstyle} defines other similar commands like \etal, \invacuo.}, they are defined using \paket{chemstyle}'s \lstinline+\latin+ command. This means that then the appearance depends on \paket{chemstyle}'s option \texttt{abbremph}:
+If the package \paket{chemstyle} has been loaded they are defined using \paket{chemstyle}'s \lstinline+\latin+ command. This means that then the appearance depends on \paket{chemstyle}'s option \texttt{abbremph}:
\begin{beispiel}
\insitu, \abinitio\\
\cstsetup{abbremph=false}
\insitu, \abinitio
\end{beispiel}
-If \paket{chemstyle} hasn't been loaded, they're always in \textit{italics}.
+The commands are defined through
+\begin{description}
+ \item \cmd{DeclareChemLatin}{<cmd>}\ma{<phrase>}
+ \item \cmd{RenewChemLatin}{<cmd>}\ma{<phrase>}
+\end{description}
+\begin{beispiel}
+ \DeclareChemLatin\ltn{latin text}
+ \ltn \cstsetup{abbremph=false} \ltn
+\end{beispiel}
+If you have \emph{not} loaded \paket{chemstyle} you can change the appearance with this option:
+\begin{description}
+ \item \key[latin]{format}{<definition>} Default = \lstinline+\itshape+
+\end{description}
\secidx*{Latin Phrases}
\section{Units for the Usage With \textsf{siunitx}}\label{sec:einheiten}\secidx{Units}
@@ -541,7 +561,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:
@@ -723,10 +743,10 @@ one can specify the most common reaction mechanisms. \texttt{<type>} can have on
\secidx*{Reaction Mechanisms}
\section{Redox Reactions}\label{sec:redoxreaktionen}\secidx{Redox Reactions}
-\chemmacros provides two commands\footnote{Thanks to \href{http://www.mathannotated.com/}{Peter Cao} who suggested this feature.}, to visualize the transfer of electrons in redox reactions. Both commands are using \TikZ.
+\chemmacros provides two commands to visualize the transfer of electrons in redox reactions. Both commands are using \TikZ.
\begin{description}
\item \cmd{OX}{<name>,<atom>}
- \item \cmd{redox}(<name1>,<name2>)[<tikz>][<num>]{<text>}
+ \item \cmd{redox}(<name1>,<name2>)[<tikz>][<num>]{<text>} Only the first argument \da{<name1>,<name2>} is required, the others are all optional.
\end{description}
\cmd{OX} places \texttt{<atom>} into a node, which is named with \texttt{<name>}. If you have set two \cmd{OX}, they can be connected with a line using \cmd{redox}. To do so the names of the two nodes that are to be connected are written in the round braces. Since \cmd{redox} draws a tikzpicture with options \texttt{remember picture,overlay}, the document needs to be \emph{compiled at least two times}.
@@ -1092,6 +1112,17 @@ The list lists all reactions with a number and disregards reactions without numb
2 H2O <<=> H3O+ + OH-
\end{reaction}
\end{beispiel}
+If you use the \texttt{reactions} environment this will not work, though. In this case you can use
+\begin{description}
+ \item\cmd{AddRxnDesc}{<description>}
+\end{description}
+\begin{beispiel}
+ \begin{reactions}
+ Cl "\Lewis{0.,\vphantom{Cl}}" + CH4 &-> HCl + "\Lewis{4.,\vphantom{CH}}" CH3 \AddRxnDesc{first~step~of~chain} \\
+ "\Lewis{4.,\vphantom{CH}}" CH3 + Cl2 &-> CH3Cl + Cl "\Lewis{0.,\vphantom{Cl}}" \AddRxnDesc{second~step~of~chain}
+ \end{reactions}
+\end{beispiel}
+Note: you don't have to use the phantom commands if you haven't changed the format of the atoms, see section \ref{sec:format} on page \pageref{sec:format}.
\secidx*{Reaction Environments}
\section{Phases}\label{sec:phasen}\secidx{Phases}
@@ -1117,7 +1148,7 @@ With the package option \key{german} (see section \ref{sec:optionen}) you get th
\ch{C\sld{} + 2 H2O\lqd{} -> CO2\gas{} + 2 H2\gas}
\end{beispiel}
-The \IUPAC recommendation\footnote{Thanks to Paul King for pointing this out.} to indicate the state of aggregation is to put it in parentheses after the compound \cite{iupac:greenbook}. However, you might want to put it as a subscript which is also very common.
+The \IUPAC recommendation to indicate the state of aggregation is to put it in parentheses after the compound \cite{iupac:greenbook}. However, you might want to put it as a subscript which is also very common.
\begin{myquote}[{\IUPAC Green Book \cite[][p.\,54]{iupac:greenbook}}]
The [\ldots] symbols are used to represent the states of aggregation of chemical species. The letters are appended to the formula in parentheses and should be printed in Roman (upright) type without a full stop (period).
@@ -1275,9 +1306,9 @@ 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} \\
+ cmversion & option & 1/2/bundle & bundle & page \pageref{key:option_cmversion} \\
german & option & \uline{true}/false & false & page \pageref{key:option_german} \\
- ghs & option & \uline{true}/false & true & page \pageref{key:option_ghs} \\
+ ghsystem & option & \uline{true}/false & true & page \pageref{key:option_ghsystem} \\
iupac & option & auto/restricted/strict & auto & page \pageref{key:option_iupac} \\
method & option & chemformula/formula & formula & page \pageref{key:option_method} \\
Nu & option & chemmacros/mathspec & chemmacros & page \pageref{key:option_Nu} \\
@@ -1288,6 +1319,8 @@ Some keys can be set without value. Then the \uline{underlined} value is used.
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} \\
+ \multicolumn{5}{l}{\cmd{DeclareChemLatin}:} \\
+ format & latin & <anything> & \lstinline=\itshape= & page \pageref{key:latin_format} \\
\multicolumn{5}{l}{\cmd{pch}, \cmd{mch}, \cmd{fpch}, \cmd{fmch}:} \\
append & charges & \uline{true}/false & false & page \pageref{key:charges_append} \\
\multicolumn{5}{l}{acid/base:} \\
@@ -1654,7 +1687,10 @@ Changing the length of the bonds:\secidx[bonds!length]{Compounds}
\secidx*{Compounds}
\section{Special Input Types}\secidx{Special Types}
-There are some \enquote{special type} input groups. These are groups which consist of only one token, namely of the following ones:
+There are some \enquote{special type} input groups.
+
+\subsection{Single Token Groups}\secidx[single token groups]{Special Types}
+The first kind are groups which consist of only one token, namely of the following ones:
\begin{description}
\item \cmd{ch}{ + } \ch{+} creates the plus sign between compounds with space around it:\\
\cmd{ch}{2 Na + Cl2} \ch{2 Na + Cl2}
@@ -1671,6 +1707,26 @@ The space left and right of the plus sign can be set with this option:
\ch{A + B}\\
\ch[plus-space=4pt]{A + B}
\end{beispiel}
+
+\subsection{Option Input}\secidx[option input]{Special Types}
+\achtung{This is an experimental feature and may well be dropped in future versions.}
+Sometimes you might want to apply an option only to a part of a, say, reaction. Of course you have the possibility to use \cmd{ch} several times.
+\begin{beispiel}
+ \ch{H2O +}\textcolor{red}{\ch{H2SO4}}\ch{-> H3O+ + HSO4-} \\
+ \ch{H2O +}\ch[subscript-vshift=2pt]{H2SO4}\ch{-> H3O+ + HSO4-}
+\end{beispiel}
+This, however, interrupts the input in your source and \emph{may} mess with the spacing. That's why there is an alternative:
+\begin{description}
+ \item \ttfamily\cmd{ch}\{\lstinline+@{<options>}+\}\normalfont\ The options specified this way will be valid \emph{only} until the next compound is set.
+\end{description}
+\begin{beispiel}
+ \ch{H2O +}\textcolor{red}{\ch{H2SO4}}\ch{-> H3O+ + HSO4-} \\
+ \ch{H2O + @{format=\color{red}} H2SO4 -> H3O+ + HSO4-} \\
+ or of course:\\
+ \ch{H2O + \textcolor{red}{H2SO4} -> H3O+ + HSO4-}\\[1em]
+ \ch{H2O +}\ch[subscript-vshift=2pt]{H2SO4}\ch{-> H3O+ + HSO4-} \\
+ \ch{H2O + @{subscript-vshift=2pt} H2SO4 -> H3O+ + HSO4-}
+\end{beispiel}
\secidx*{Special Types}
\section{Escaped Input}\secidx{Escaped Input}
@@ -1689,7 +1745,7 @@ If you put something between \lstinline+" "+ or \lstinline+' '+ then the input w
In many cases you won't need to escape the input. But when you get into trouble when using a command inside \cmd{ch} try hiding it.
\subsection{Math}\secidx[math]{Escaped Input}
-If you espacially want to input math you just enclose it with \lstinline+$ $+. This output is different from the escaped text as it is followed by a space.
+If you especially want to input math you just enclose it with \lstinline+$ $+. This output is different from the escaped text as it is followed by a space.
\begin{description}
\item \cmd{ch}{ \lstinline"$<escaped math>$" }
\end{description}
@@ -1773,8 +1829,6 @@ These are the options which enable you to customize the arrows:
\item \key{arrow-offset}{<dim>} This is the length that an arrow protrudes a label on both sides. This means an empty arrow's length is two times \texttt{arrow-offset}. Default = \texttt{1.5ex}
\item \key{arrow-yshift}{<dim>} Shifts an arrow up (positive value) or down (negative value). Default = \texttt{0pt}
\item \key{arrow-ratio}{<factor>} The ratio of the arrow lengths of the unbalanced equilibrium. \texttt{.4} would mean that the length of the shorter arrow is $0.4\times$ the length of the longer arrow. Default = \texttt{.6}
-% \item \key{arrow-tips}{<type>} This specifies the arrow tips. In principle all of \TikZ' arrows could be used. However, this option requires \texttt{<type>} to be an arrow tip itself \emph{and} to have a \texttt{left <type>} and \texttt{right <type>} to be defined. This means if you don't define any arrow tips yourself you can only choose between \texttt{cf} and \texttt{to}. Default = \texttt{cf}
-% \item \key{arrow-style}{<tikz>} \TikZ keys for free customization of the arrows.
\item \key{compound-sep}{<dim>} The space between compounds and the arrows. Default = \texttt{1ex}
\item \key{label-offset}{<dim>} The space between the labels and the arrows. Default = \texttt{2pt}
\item \key{label-style}{<font command>} The relative font size of the labels. Default = \lstinline+\footnotesize+
@@ -1790,8 +1844,22 @@ The following code shows the effect of the different options on the \lstinline+<
larger distance to compounds: \ch[compound-sep=2ex]{A <=>>[x][y] B} \\
smaller labels: \ch[label-style=\tiny]{A <=>[x][y] B}
\end{beispiel}
-
-\subsection{Modify Arrow Types}\secidx[types!modify]{Arrows}
+%
+% The tips of the arrows are designed to match the appearance of \paket{chemfig}'s arrows. If you like other arrow tips better and want to change them without redefining all the arrows (see section \ref{sec:arrows_modify}) you can use the command
+% \begin{description}
+% \item \cmd{pgfarrowsrenewalias}{<new start>}\ma{<new end>}\ma{<old start>}\ma{<old end>}
+% \end{description}
+% This command is the same as \lstinline=\pgfarrowsdeclarealias= but without the check if the new tips exist. This means it lets you overwrite old definitions.
+% \begin{beispiel}
+% % overwrite the chemformula arrow heads `cf' and `left cf'
+% \pgfarrowsrenewalias{left cf}{left cf}{left to}{left to}
+% \pgfarrowsrenewalias{cf}{cf}{to}{to}
+%
+% \ch{CO + H2O <=> CO2 + H2} \\
+% \ch{C + H2O -> CO + H2}
+% \end{beispiel}
+
+\subsection{Modify Arrow Types}\label{sec:arrows_modify}\secidx[types!modify]{Arrows}
The arrows are defined with the command
\begin{description}
\item \cmd{DeclareChemArrow}{<tokens>}\ma{<tikz>}
@@ -1866,7 +1934,7 @@ If for some reason you want to insert an exclamation mark \emph{without} it crea
\end{beispiel}
\secidx*{Names}
-\section{Format and Font}\secidx{Format and Font}
+\section{Format and Font}\secidx{Format and Font}\label{sec:format}
In the standard setting \chemformula doesn't make any default changes to the font of the formula output. Let's take a look at a nonsense input which shows all features:
\begin{beispiel}
\newcommand*\sample{\ch{H2C-C+C-CH=CH+ + CrO4^2- <=>[x][y] 2.5 Cl^{-.} + 3_1/2 Na*OH_{(aq)} + !(name)( A^n ) "\LaTeXe"}}
@@ -1985,7 +2053,6 @@ The following example shows how the cancelling of compounds could be done\footno
\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}
@@ -2006,8 +2073,8 @@ All of \ghsystem's options belong to the module \textcolor{module}{\texttt{ghsys
\subsection{Simple Statements}\secidx[get statements]{GHSYSTEM}
The general usage is simple: you use the command
\begin{description}
- \item\cmd{ghs}[<options>]{<type>}{<number>}
- \item\cmd[ghsa]{ghs*}[<options>]{<type>}{<number>}
+ \item\cmd{ghs}[<options>]{<type>}\ma{<number>}
+ \item\cmd[ghsa]{ghs*}[<options>]{<type>}\ma{<number>}
\end{description}
There are three types available: \texttt{h}, \texttt{euh} and \texttt{p}. The \ma{<type>} argument is case insensitive, so just type them in as you like.
\begin{beispiel}
@@ -2229,11 +2296,18 @@ The code below shows how \ref{tab:ghs-hp-statements} was created:
\appendix
\part{Appendix}\index{APPENDIX@\textbf{APPENDIX}}
\section*{Suggestions and Bug Reports}\addcontentsline{toc}{section}{Suggestions and Bug Reports}
-Feedback on \chemmacros, \chemformula and \ghsystem is highly appreciated and welcome! If you have suggestions for macros, missing features \etc, please don't hesitate to contact me. If you recognize any errors, be it chemical ones, wrong documentation and the like, I'd be grateful about a short email\footnote{\href{mailto:contact@mychemistry.eu}{contact@mychemistry.eu}}.
+Feedback on \chemmacros, \chemformula and \ghsystem is highly appreciated and welcome! Especially \chemformula and \ghsystem are still in beta testing phase so even if I repeat myself: feedback is highly welcome.
+
+If you have suggestions for macros, missing features \etc, please don't hesitate to contact me. If you recognize any errors, be it chemical ones, wrong documentation and the like, I'd be grateful about a short email\footnote{\href{mailto:contact@mychemistry.eu}{contact@mychemistry.eu}}.
If you find any bugs, it would be best, if you'd send me a minimal example, with which I can reproduce the bug. You can also submit an issue on \url{https://bitbucket.org/cgnieder/chemmacros/} instead.
-Many thanks to all the people, who already provided me with feedback!
+Many thanks to all the people who already provided me with feedback, especially (in alphabetical order):
+\begin{itemize}
+ \item \href{http://www.mathannotated.com/}{Peter Cao}
+ \item Dr.\ Paul King
+ \item Christoph Schäfer
+\end{itemize}
\printbibliography