summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex')
-rw-r--r--Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex51
1 files changed, 41 insertions, 10 deletions
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
index 45d723691b3..b1743cf1432 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
@@ -530,12 +530,24 @@ Choosing the language \code{italian} defines two additional \ac{iupac} commands:
\item \chemmacros got an Italian manual, many thanks to Jonas Rivetti who
volunteered to not only translate the H \&\ P statements but also this
documentation!
- \item the command \cmd{bond} which allows to use other bonds than single, double
+ \item The command \cmd{bond} which allows to use other bonds than single, double
and triple, see section~\ref{ssec:bonds}. I wanted to add this for a long time!
- \item a few changes to the looks of the radical point and new options to customize
+ \item A few changes to the looks of the radical point and new options to customize
it, see section~\ref{ssec:compounds:customization}.
\end{itemize}
+\subsection{Versions 3.5 and 3.6}
+\begin{itemize}
+ \item Line breaks at bonds in formulas are no longer possible.
+ \item Line breaks after arrows in formulas are possible.
+ \item Some of the horizontal spaces in formulas are now stretch- and shrinkable.
+ \item In formulas math escaping is also via \cmd*{(} and \cmd*{)} possible.
+ \item New options: \key{radical-vshift}, \key{radical-hshift} and
+ \key{radical-space} allow finer control over the radical dot.
+ \item In stoichiometric factors a leading 0 is added if missing.
+ \item New option: \key{stoich-paren-parse}.
+ \item Various internal changes to the code.
+\end{itemize}
\secidx*{News}\secidx*{PRELIMINARIES}
\part{\texorpdfstring{\Chemmacros}{chemmacros}}\secidx{CHEMMACROS}\label{part:chemmacros}
@@ -1224,11 +1236,13 @@ Examples:% TODO: watch pagebreaks!
\end{beispiel}
\begin{beispiel}[dist]
\ch{ 2 "\OX{o1,\ox{0,Na}}" + "\OX{r1,\ox{0,Cl}}" {}2 -> 2 "\OX{o2,\ox{+1,Na}}"
-\pch{} + 2 "\OX{r2,\ox{-1,Cl}}" \mch }
+ \pch{} + 2 "\OX{r2,\ox{-1,Cl}}" \mch }
\redox(o1,o2){\small OX: $- 2\el$}
\redox(r1,r2)[][-1]{\small RED: $+ 2\el$}
\vspace{7mm}
\end{beispiel}
+
+\newpage
\bspmidlength{dist}{15mm}
\begin{beispiel}[dist]
\ch{ 2 "\OX{o1,\ox{0,Na}}" + "\OX{r1,\ox{0,Cl}}" {}2 -> 2 "\OX{o2,\ox{+1,Na}}"
@@ -1237,11 +1251,10 @@ Examples:% TODO: watch pagebreaks!
\redox(r1,r2)[draw=blue,->]{\small RED: $+ 2\el$}
\end{beispiel}
-\newpage
\bspmidlength{dist}{7mm}
\begin{beispiel}[dist]
\ch{ 2 "\OX{o1,\ox{0,Na}}" + "\OX{r1,\ox{0,Cl}}" {}2 -> 2 "\OX{o2,\ox{+1,Na}}"
-\pch{} + 2 "\OX{r2,\ox{-1,Cl}}" \mch }
+ \pch{} + 2 "\OX{r2,\ox{-1,Cl}}" \mch }
\redox(o1,o2)[green,-stealth]{\small OX}
\redox(r1,r2)[purple,-stealth][-1]{\small RED}
\vspace{7mm}
@@ -2142,14 +2155,19 @@ A stoichiometric factor may only contain of numbers and the signs \lstinline+.,_
\ch{12}
% decimals:
- \ch{3.5} \\
+ \ch{.5} \\
\ch{5,75}
% fractions:
\ch{3/2} \\
\ch{1_1/2}
+
+ % ``iupac'':
+ \ch{(1/2)}
\end{beispiel}
+As you can see if you input decimal numbers a missing leading zero is added.
+
You have to be a little bit careful with the right syntax but I believe it is
rather intuitive.
\begin{beispiel}[code only]
@@ -2157,7 +2175,8 @@ rather intuitive.
\end{beispiel}
If stoichiometric factors are enclosed with parentheses the fractions are not
-recognized. What's inside the parenthesis is typeset as is.
+recognized and missing leading zeros are not added. What's inside the parentheses
+is typeset as is.
\begin{beispiel}
\ch{(1/2) H2O} \ch{1/2 H2O} \ch{0.5 H2O}
\end{beispiel}
@@ -2175,6 +2194,8 @@ There are a few possibilities to customize the output.
Default = \code{math}
\option{stoich-space}{<skip>} The space that is placed after the stoichiometric
factor. A rubber length. Default = \code{.1667em plus .0333em minus .0117em}
+ \option{stoich-paren-parse}{\default{true}|false} If set to true stoichiometric
+ factors enclosed by parentheses also are parsed. Default = \code{false}
\end{beschreibung}
\begin{beispiel}
\ch[decimal-marker={,}]{3.5} \ch[decimal-marker={$\cdot$}]{3,5}
@@ -2446,6 +2467,12 @@ These options allow you to customize the ouptut of the compounds:
empty.
\option{radical-radius}{<dim>} The radius of the radical point. Default =
\code{.2ex}
+ \option{radical-hshift}{<dim>} Horizontal shift before the radical point is
+ drawn. Default = \code{.15em}
+ \option{radical-vshift}{<dim>} Vertical shift relative to the current baseline.
+ Default = \code{.5ex}
+ \option{radical-space}{<dim>} Horizontal shift after the radical point is
+ drawn. Default = \code{.15em}
\end{beschreibung}
Maybe you have noticed that charges of certain ions are shifted to the right.\secidx[charges!shift]{Compounds}
@@ -2594,13 +2621,17 @@ when using a command inside \cmd{ch} try hiding it.
\subsection{Math}\secidx[math]{Escaped Input}
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{beschreibung}\catcode`\$=11
- \Befehl{ch}{ $<escaped math>$ }
+This output is different from the escaped text as it is followed by a space. The
+reasoning behind this is that I assume math will mostly be used to replace
+stoichiometric factors.
+\begin{beschreibung}
+ \Befehl{ch}{ \string$<escaped math>\string$ }
+ \Befehl{ch}{ \string\(<escaped math>\string\) }
\end{beschreibung}
\begin{beispiel}
escaped text: \ch{"$x$" H2O} \\
escaped math: \ch{$x$ H2O} \\
+ also escaped math: \ch{\(x\) H2O} \\
\ch{$2n$ Na + $n$ Cl2 -> $2n$ NaCl}
\end{beispiel}