summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex')
-rw-r--r--Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex48
1 files changed, 45 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex
index 00ebc3d13d8..a00165db17a 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemformula_en.tex
@@ -613,6 +613,21 @@ gives the excited state.
\ch{NO^*}
\end{example}
+Actually\changedversion{4.5a} a dot \code{.} is not always treated as
+indicator for a radical: if the dot in the superscript is followed by a number
+it is interpreted as a decimal sign. It is typeset according to the option
+\option{decimal-marker}. This may be a good place to mention that a comma
+\code{,} in a superscript is also typeset according to
+\option{decimal-marker}.
+
+\begin{example}[side-by-side]
+ \ch{^{22,98}_{11}Na}
+ \ch{^{22.98}_{11}Na}\par
+ \setchemformula{decimal-marker={,}}
+ \ch{^{22,98}_{11}Na}
+ \ch{^{22.98}_{11}Na}
+\end{example}
+
Ions and ion composites with more than one charge can be typeset quite as
easy:
\begin{example}[side-by-side]
@@ -629,6 +644,25 @@ superscript alignment. The \chemmacros\ option \code{circled} is obeyed by
\ch{H+ + OH- <=> H2O}
\end{example}
+\chemformula{} knows the options \option{circled} and \option{circletype} also
+on its own:
+
+There are coupled with \chemmacros{} options, \ie, setting \chemmacros'
+options will also set \chemformula's equivalents. The other way around the
+options act independently: setting \chemformula's options will \emph{not} set
+\chemmacros' options.
+\begin{options}
+ \keychoice{circled}{formal,\default{all},none}\Default{formal}
+ \chemformula\ uses two different kinds of charges which indicate the usage
+ of real ($+/-$) and formal (\fplus/\fminus) charges. The choice
+ \code{formal} distinguishes between them, choice \code{none} displays them
+ all without circle, choice \code{all} circles all.
+ % circletype
+ \keychoice{circletype}{\default{chem},math}\Default{chem}
+ This option switches between two kinds of circled charge symbols:
+ \cs{fplus} \fplus\ and \verbcode+$\oplus$+ $\oplus$.
+\end{options}
+
\paragraph{Behaviour}
The supercripts behave differently depending on their position in a compound,
if there are super- and subscripts following each other directly.
@@ -773,6 +807,14 @@ These options allow you to customize the ouptut of the compounds:
Extra vertical shift of the superscripts.
\keychoice{charge-style}{text,math}\Default{text}
Style that is used to typeset the superscripts.
+ \keychoice{circled}{formal,\default{all},none}\Default{formal}
+ \sinceversion{4.6}Like \chemmacros' package option but local to
+ \chemformula's \cs{ch}. That is: since \chemmacros' macros use
+ \chemformula's mechanism this is effectively an alias.
+ \keychoice{circletype}{\default{chem},math}\Default{chem}
+ \sinceversion{4.6}Like \chemmacros' package option but local to
+ \chemformula's \cs{ch}. That is: since \chemmacros' macros use
+ \chemformula's mechanism this is effectively an alias.
\keyval{adduct-space}{dim}\Default{.1333em}
Space to the left and the right of the adduct point.
\keyval{bond-length}{dim}\Default{.5833em}
@@ -1477,7 +1519,7 @@ 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]
+\begin{example}[side-by-side,add-sourcecode-options={literate=}]
\setchemformula{kroeger-vink=true}
\ch{Al_{Al}^'}
\ch{Al_{Al}'}\par
@@ -1486,8 +1528,8 @@ the cross denotes a neutral relative charge.
\ch{V_{Cl}^*}\par
\ch{Ca_i^{..}}\par
\ch{e^'}\par
- \ch{Cl_i^{''}}
- \ch{Cl_i''}\par
+ \ch{Cl_i^'}
+ \ch{Cl_i'}\par
\ch{O_i^{''}}
\ch{O_i''}
\end{example}