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.tex68
1 files changed, 51 insertions, 17 deletions
diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
index 447fa1b652f..b32946b52e8 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_en.tex
@@ -5,7 +5,7 @@
% - macros and commands for chemists
% -----------------------------------------------------------------------------
% - Clemens Niederberger
-% - 2012/05/07
+% - 2012/05/13
% -----------------------------------------------------------------------------
% - https://bitbucket.org/cgnieder/chemmacros/
% - contact@mychemistry.eu
@@ -57,7 +57,7 @@
\colorlet{chemformula}{darkgray}
\begin{filecontents}{index_en.ist}
- preamble "\\begin{theindex}\n Section titles are indicated \\textbf{bold}, packages \\textsf{sans serif}, commands \\textcolor{code}{\\code{\\textbackslash brown}}, keys \\textcolor{key}{\\code{green}} and modules (only \\chemmacros) \\textcolor{module}{\\code{red}}.\\newline\n\n"
+ preamble "\\begin{theindex}\n Section titles are indicated \\textbf{bold}, packages \\textsf{sans serif}, commands \\code{\\textbackslash\\textcolor{code}{brown}}, options \\textcolor{key}{\\code{green}} and modules (only \\chemmacros) \\textcolor{module}{\\code{red}}.\\newline\n\n"
heading_prefix "{\\bfseries "
heading_suffix "\\hfil}\\nopagebreak\n"
headings_flag 1
@@ -79,6 +79,13 @@
year = {2008},
publisher = {\IUPAC \&\ RSC Publishing, Cambridge}
}
+@book{iupac:redbook,
+ author = {Neil G. Connelly and Ture Damhus and Richard M. Hartshorn and Alan T. Hutton},
+ title = {“Nomenclature of Inorganic Chemistry”, \IUPAC Red Book},
+ year = {2005},
+ publisher = { \IUPAC \&\ RSC Publishing, Cambridge},
+ isbn = {0-85404-438-8}
+}
@misc{eu:ghsystem_regulation,
author = {{The European Parliament and The Council of the European Union}},
title = {Regulation (EC) No 1272/2008 of the European Parliament and of the Council},
@@ -122,13 +129,13 @@
\redox(r1,r2)[blue,-cf][-1]{\small\ch[font-spec={[Color=blue]Augie},math-space=.3em]{$+$ 2 e-}}}
\addcmds{
- a,abinitio,AddRxnDesc,aq,aqi,b,ba,bottomrule,cancel,cd,cdot,ce,cee,celsius,
+ a,abinitio,AddRxnDesc,anti,aq,aqi,b,ba,bottomrule,bridge,cancel,cd,cdot,ce,cee,celsius,
centering,chemabove,Chemalpha,Chembeta,Chemgamma,Chemdelta,ChemDelta,chemfig,
chemname,Chemomega,chemsetup,cip,cis,ch,cnsetup,CNMR,color,cstsetup,d,D,data,
DeclareChemArrow,DeclareChemIUPAC,DeclareChemLatin,DeclareChemNMR,
DeclareChemParticle,DeclareChemPhase,DeclareChemReaction,DeclareChemState,
DeclareInstance,DeclareSIUnit,definecolor,delm,delp,Delta,Dfi,draw,E,el,
- electronvolt,ElPot,Enthalpy,enthalpy,Entropy,footnotesize,fmch,fpch,fscrm,
+ electronvolt,ElPot,endo,Enthalpy,enthalpy,Entropy,footnotesize,fmch,fpch,fscrm,
fscrp,g,gas,ghs,ghslistall,ghspic,Gibbs,glqq,gram,grqq,H,hapto,HNMR,Helmholtz,
hertz,hspace,includegraphics,insitu,intertext,invacuo,iupac,IUPAC,J,joule,Ka,
Kb,kilo,Kw,L,latin,lewis,Lewis,Lfi,listofreactions,lqd,mch,mega,meta,metre,
@@ -308,6 +315,12 @@ Choosing the language \code{italian} defines two additional IUPAC commands:
\item The package option \key{upgreek} got renamed into \key{greek}.
\item Some additional \code{\textbackslash\textcolor{code}{Chem<greekletter>}}-commands are provided, see section \ref{sec:teilchen}.
\end{itemize}
+
+\subsection{Version 3.3a}
+\begin{itemize}
+ \item The IUPAC commands \cmd{hapto} and \cmd{bridge} are new.
+ \item The H and P statements now are available in Italian.
+\end{itemize}
\secidx*{News}\secidx*{PRELIMINARIES}
\part{\texorpdfstring{\Chemmacros}{chemmacros}}\secidx{CHEMMACROS}\label{part:chemmacros}
@@ -335,6 +348,7 @@ Choosing the language \code{italian} defines two additional IUPAC commands:
\befehl{Chemdelta} \Chemdelta
\befehl{Chemepsilon} \Chemepsilon
\befehl{Chemeta} \Chemeta
+ \befehl{Chemkappa} \Chemkappa
\befehl{Chemmu} \Chemmu
\befehl{Chemnu} \Chemnu
\befehl{Chemrho} \Chemrho
@@ -403,7 +417,7 @@ Depending on the \key{method} you chose as option the \code{<definition>} will e
\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.
\begin{beschreibung}
- \item\cmd{iupac}{<IUPAC name>} Inside this command use \cmd{|} and \cmd{-} to indicate a breaking point or a breaking dash. Use {\catcode`\^=11\cmd{^}} as a shortcut for \lstinline=\textsuperscript=\footnote{Actually another mechanism is used, but the effect is essentially the same.}.
+ \item\cmd{iupac}{<IUPAC name>} Inside this command use \cmd{|} and \cmd{-} to indicate a breaking point or a breaking dash. Use {\catcode`\^=11\relax\cmd{^}} as a shortcut for \lstinline=\textsuperscript=\footnote{Actually another mechanism is used, but the effect is essentially the same.}.
\end{beschreibung}
\begin{beispiel}
@@ -411,7 +425,7 @@ Similar to the \paket{bpchem} package \chemmacros provides a command\footnote{Th
\iupac{Tetra\|cyclo[2.2.2.1\^{1,4}]\-un\|decane-2\-dodecyl\-5\-(hepta\|decyl\|iso\|dodecyl\|thio\|ester)}
\end{minipage}
\end{beispiel}
-The \cmd{iupac} command is more of a semantic command. Most times you can achieve (nearly) the same thing by using \cmd{-} instead of \cmd{|}, \code{-} instead of \cmd{-} and \lstinline=\textsuperscript= instead of {\catcode`\^=11\cmd{^}}.
+The \cmd{iupac} command is more of a semantic command. Most times you can achieve (nearly) the same thing by using \cmd{-} instead of \cmd{|}, \code{-} instead of \cmd{-} and \lstinline=\textsuperscript= instead of {\catcode`\^=11\relax\cmd{^}}.
There are some subtleties: \cmd{-} inserts a small space before the hyphen a removes a small space after it. The command \cmd{|} not only prevents ligatures but also inserts a small space.
\begin{beispiel}
@@ -455,6 +469,9 @@ Greek letters in compound names are typeset upright. For this there are the pack
\befehl{b} \iupac{\b}
\befehl{g} \iupac{\g}
\befehl{d} \iupac{\d}
+ \befehl{k} \iupac{\k}
+ \befehl{m} \iupac{\m}
+ \befehl{n} \iupac{\n}
\befehl{w} \iupac{\w}
\end{beschreibung}
\begin{beispiel}
@@ -511,7 +528,7 @@ The package \paket{cool} defines the commands \cmd{E} and \cmd{D}, too. If you l
\befehl{para} \para
\end{beschreibung}
-\paragraph{absolute configuration}\index{absolute configuration} (uses \TikZ)
+\paragraph{Absolute Configuration}\index{absolute configuration} (uses \TikZ)
\begin{beschreibung}
\befehl{Rconf}[<letter>] \cmd{Rconf}: \Rconf \quad\cmd{Rconf}[]: \Rconf[]
\befehl{Sconf}[<letter>] \cmd{Sconf}: \Sconf \quad\cmd{Sconf}[]: \Sconf[]
@@ -531,6 +548,23 @@ Examples:
\end{beispiel}
\secidx*{Stereo Descriptors and Nomenclature}
+\paragraph{Coordination Chemistry}
+\chemmacros provides two commands useful with coordination chemistry:
+\begin{beschreibung}
+ \befehl{bridge}{<num>} \bridge{3}
+ \befehl{hapto}{<num>} \hapto{5}
+\end{beschreibung}
+\begin{beispiel}
+ Ferrocene = \iupac{bis(\hapto{5}cyclo\|penta\|dienyl)iron} \\
+ \iupac{tetra\-\bridge{3}iodido\-tetrakis[tri\|methyl\|platinum(IV)]}
+\end{beispiel}
+
+Two options allow customization:
+\begin{beschreibung}
+ \option[iupac]{bridge-number}{sub/super} appends the number as a supscript or superscript. IUPAC recommendation is the subscript \cite{iupac:redbook}. Default = \code{sub}
+ \option[iupac]{coord-use-hyphen}{\default{true}/false} append a hyphen to \cmd{hapto} and \cmd{bridge} or don't. Default = \code{true}
+\end{beschreibung}
+
\subsubsection{Own Naming Commands}\secidx[own]{IUPAC Names}
If you find any commands missing you can define them using
\begin{beschreibung}
@@ -539,9 +573,9 @@ If you find any commands missing you can define them using
\end{beschreibung}
A command defined in this way will obey the setting of the option \key[option]{iupac}. This means any existing command is only overwritten with \key{iupac}{strict}. However, \cmd{DeclareChemIUPAC} will \emph{not} change the definition of an existing \IUPAC naming command but issue a warning/an error (depending on the package option \key{strict}) if the \IUPAC naming command already exists.
\begin{beispiel}
- % uses the `upgreek' package
- \DeclareChemIUPAC\hapto{\Chemeta}
- Ferrocene = \iupac{bis(\hapto\^5\-cyclo\|penta\|dienyl)iron}
+ \DeclareChemIUPAC\endo{\textit{endo}}
+ \DeclareChemIUPAC\anti{\textit{anti}}
+ \iupac{(2\-\endo,7\-\anti)\-2\-bromo\-7\-fluoro\|bicyclo[2.2.1]heptane}
\end{beispiel}
\cmd{RenewChemIUPAC} allows you to redefine the existing iupac naming commands.
@@ -865,8 +899,6 @@ Examples:% TODO: watch pagebreaks!
\redox(o1,o2)[draw=red,->][3.33]{\small OX: $- 2\el$}
\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}}"
@@ -2402,11 +2434,11 @@ To resolve this \ghsystem tests which engine is used and if \pdfTeX\ which mode
\secidx*{Pictograms}
\section{Available Languages}\label{sec:ghsystem_language}
-Right now the H and P statements are only available in English or German. The package adapts the package option \key[option]{german} but does not (yet) recognize language settings by \paket{babel} or \paket{polyglossia}.
+Right now the H and P statements are only available in English, German or Italian. The package adapts the package option \key[option]{german} but does not (yet) recognize language settings by \paket{babel} or \paket{polyglossia}.
You can also choose the language explicitly.
\begin{beschreibung}
- \Option{language}{english/german}
+ \Option{language}{english/german/italian}
\end{beschreibung}
\begin{beispiel}
\ghs{h}{201}
@@ -2485,10 +2517,12 @@ Some options can be set without value. Then the \default{underlined} value is us
xspace & option & \default{true}/false & true & page \pageref{key:option_xspace} \\
\multicolumn{5}{l}{\cmd{ba}, \cmd{Nu}:} \\
elpair & particle & \default{dots}/dash/false & false & page \pageref{key:particle_elpair} \\
- \multicolumn{5}{l}{\cmd{|}, \cmd{-}:} \\
+ \multicolumn{5}{l}{IUPAC commands:} \\
+ break-space & iupac & <dim> & .01em & page \pageref{key:iupac_break-space} \\
+ bridge-number & iupac & sub/super & sub & page \pageref{key:iupac_bridge-number} \\
+ coord-use-hyphen & iupac & \default{true}/false & true & page \pageref{key:iupac_coord-use-hyphen} \\
hyphen-pre-space & iupac & <dim> & .01em & page \pageref{key:iupac_hyphen-pre-space} \\
hyphen-post-space & iupac & <dim> & -.03em & page \pageref{key:iupac_hyphen-post-space} \\
- break-space & iupac & <dim> & .01em & page \pageref{key:iupac_break-space} \\
\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}:} \\
@@ -2592,7 +2626,7 @@ Many thanks to all the people who already provided me with feedback, especially
\item \href{http://www.mathannotated.com/}{Peter Cao}
\item Christina Lüdigk
\item Dr.\@ Paul King
- \item Jonas Rivetti
+ \item Jonas Rivetti (Special thanks for his translation of the hazard and precautionary statements into Italian!)
\item Christoph Schäfer
\end{itemize}