chemmacros (4nov11)

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

5 files changed, 58 insertions, 15 deletions

diff --git a/Master/texmf-dist/doc/latex/chemmacros/README b/Master/texmf-dist/doc/latex/chemmacros/README
index b017ced447a..e5c7c318a1f 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/README
+++ b/Master/texmf-dist/doc/latex/chemmacros/README
@@ -1,8 +1,8 @@
 --------------------------------------------------------------------------
-the chemmacros package v2.0
+the chemmacros package v2.0a
 a collection of macros to make typesetting chemistry documents more
 convenient
-2011/10/28
+2011/11/03
 --------------------------------------------------------------------------
 Clemens Niederberger
 Web:    http://www.mychemistry.eu/
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 4478c854c43..aa1e87d770e 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 dac3f33b06e..95ab2f78ad7 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_de.tex
@@ -4,7 +4,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2011/10/28                                                              - %
+% - 2011/11/03                                                              - %
 % --------------------------------------------------------------------------- %
 % - http://www.mychemistry.eu/                                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -34,7 +34,7 @@
 
 \newcommand*\CMname{\textsf{chemmacros}\xspace}
 \newcommand*\CMversion{2.0\xspace}
-\newcommand*\CMdate{2011/10/28\xspace}
+\newcommand*\CMdate{2011/11/03\xspace}
 
 % changing some tufte-handout settings
 \titleformat{\section}[hang]{\normalfont\Large\bfseries}{\thesection}{1em}{}[]
@@ -176,7 +176,7 @@
 \begin{titlepage}
  \begin{fullwidth}
  \centering
- \Huge chemmacros v\CMversion
+ \Huge chemmacros v\CMversion{}a
  \vskip.5cm
  \Large\CMdate
  \vskip.5cm
@@ -255,6 +255,7 @@ Eine Reihe einfacher Makros, um häufig gebrauchte Teilchen sowie ein Symbol dar
  \item\cmd{ntr} \ntr (Neutron)
  \item\cmd{Nu} \Nu (Nucleophil)
  \item\cmd{El} \El (Elektrophil)
+ \item\cmd{ba} \ba (Base)
  \item\cmd{fplus} \fplus
  \item\cmd{fminus} \fminus
  \item\cmd{transitionstatesymbol} \transitionstatesymbol\ Über\-gangs\-zu\-stands\-symbol (verwendet \TikZ)
@@ -267,6 +268,22 @@ Daneben gibt es noch einen weiteren Befehl, mit dem Radikale mit Ladungen und In
 \begin{LTXexample}
  \R[+]{tert} \R[-]{sek} \R{prim}
 \end{LTXexample}
+Die beiden Teilchen \cmd{Nu} und \cmd{ba} können modifiziert werden. Dafür gibt es den Schlüssel \code{elpair}\Key[false][particle]{elpair}{false/\uline{dots}/dash}. Dieser Schlüssel hat nur Auswirkungen, wenn das Paket \paket{chemfig} geladen wurde, da er dessen Befehl \cmd{Lewis} verwendet.
+\begin{LTXexample}
+ \documentclass{article}
+ \usepackage{chemmacros,chemfig}
+ \begin{document}
+  \ba[elpair] \Nu[elpair=dash]
+ \end{document}
+\end{LTXexample}
+\begin{LTXexample}
+ \documentclass{article}
+ \usepackage{chemmacros,chemfig}
+ \begin{document}
+  \chemsetup[particle]{elpair}
+  \ba \Nu
+ \end{document}
+\end{LTXexample}
 
 \section{Stereo-Deskriptoren, Nomenklatur, lateinische Aus\-drücke}\label{sec:stereo}
 \subsection{Stereo-Deskriptoren und Nomenklatur}
@@ -412,7 +429,6 @@ Setzen von Oxidationszahlen:\changed{ox}
  \ox{+1,Na}, \ox{2,Ca}, \ox{-2,S}, \ox{-1,F}
 \end{LTXexample}
 
-\newpage
 Es gibt eine Reihe von Schlüssel/Wert-Paaren, die eingesetzt werden können, um den \cmd{ox}-Befehl zu modifizieren.\Key[true][ox]{parse}{\uline{true}/false}\Key[true][ox]{roman}{\uline{true}/false}\Key[top][ox]{pos}{top/super/side}\Key[false][ox]{explicit-sign}{\uline{true}/false}\Key[point][ox]{decimal-marker}{comma/point}
 \begin{itemize}
  \item\code{parse = \uline{true}/false} ermöglicht bei \code{false} eine beliebige Eingabe für \code{<number>}.
@@ -468,7 +484,9 @@ Auch die folgenden Makros sind \va beim Einsatz mit \paket{chemfig} nützlich.
  \cmd{scrp} \scrp (\textbf{scr}iptstyle + \textbf{p}lus) \\
  \cmd{scrm} \scrm (\textbf{scr}iptstyle + \textbf{m}inus) \\
  \cmd{fscrp} \fscrp \\
- \cmd{fscrm} \fscrm
+ \cmd{fscrm} \fscrm \\
+ \cmd{fsscrp} \fsscrp (im \cmd{scriptscriptstyle})\\
+ \cmd{fsscrm} \fsscrm
 \end{framed}
 \begin{LTXexample}[pos=b,rframe=]
  \setatomsep{1.8em}\chemfig{CH_3-\chemabove{C}{\scrp}(-[6]C|H_3)-\vphantom{H_3}CH_3}
@@ -476,7 +494,6 @@ Auch die folgenden Makros sind \va beim Einsatz mit \paket{chemfig} nützlich.
  \chemfig{\fmch{}|O-\chemabove{N}{\fscrp}(-[1]O|\fmch)-[7]O|\fmch}
 \end{LTXexample}
 
-\newpage
 \section{Reaktionsmechanismen}\label{sec:mechanismen}
 Der Befehl\marginnote{Dieser Befehl ist auch in Mathematikumgebungen und im \cmd{ce}-Befehl von \paket{mhchem} einsetzbar.}
 \begin{framed}
@@ -876,7 +893,6 @@ Mit einigen Schlüsseln kann \cmd{mhName} angepasst werden.\Key[\cmd{centering}]
 
 In v1.1 gab es noch den Befehl \cmd{setmhName\ma{<textattr>}}\formercmd{setmhName\ma{<textattr>}}. Mit Laden der Paketoption \code{version=1} wird er bereitgestellt.
 
-\newpage
 \section{Newman-Projektionen}\label{sec:newman}
 \CMname stellt das Makro\changed{newman}
 \begin{framed}
@@ -888,6 +904,7 @@ zur Verfügung, mit dem sich Newman-Projektionen erstellen lassen (verwendet `\T
  \newman{1,2,3,4,5,6} \newman{1,2,3} \newman{,,,4,5,6}
 \end{LTXexample}
 
+\newpage
 Mehrere Schlüssel erlauben das Anpassen des Layouts:\Key[0][newman]{angle}{<angle>}\Key[1][newman]{scale}{<factor>}\Key[][newman]{ring}{<tikz>}\Key[][newman]{atoms}{<tikz>}\Key[][newman]{back-atoms}{<tikz>}
 \begin{itemize}
  \item\code{angle = <angle>} Einstellen des Default-Drehwinkels
@@ -912,6 +929,7 @@ Mehrere Schlüssel erlauben das Anpassen des Layouts:\Key[0][newman]{angle}{<ang
  \newman{1,2,3,4,5,6} \newman(170){1,2,3,4,5,6}
 \end{LTXexample}
 
+\newpage
 \section{s-, p- und Hybrid-Orbitale}\label{sec:orbitale}
 In v1.1 gab es noch die Befehle \cmd{porb\oa{<options>}}\formercmd{porb\oa{<options>}}, \cmd{phorb\oa{<options>}}\formercmd{phorb\oa{<options>}}, \cmd{pxorb}\formercmd{pxorb}, \cmd{pyorb}\formercmd{pyorb} und \cmd{pzorb}\formercmd{pzorb}. Mit Laden der Paketoption \code{version=1} werden sie bereitgestellt.
 
@@ -997,6 +1015,8 @@ Manche Schlüssel können auch ohne Wert eingesetzt werden. Sie entsprechen dann
  german              & option   & \uline{true}/false      & false                 & Seite \pageref{key:option_german} \\
  version             & option   & 1/2                     & 2                     & Seite \pageref{key:option_version} \\
  xspace              & option   & \uline{true}/false      & true                  & Seite \pageref{key:option_xspace} \\
+ \multicolumn{5}{l}{\cmd{ba}, \cmd{Nu}:} \\
+ elpair              & base     & \uline{dots}/dash/false & false                 & Seite \pageref{key:particle_elpair} \\
  \multicolumn{5}{l}{\cmd{pch}, \cmd{mch}, \cmd{fpch}, \cmd{fmch}:} \\
  append              & charges  & \uline{true}/false      & false                 & Seite \pageref{key:charges_append} \\
  \multicolumn{5}{l}{\cmd{ox}:} \\
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 70762cd2e28..2b26a42485a 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 1d719c2f66a..8fc970a5562 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemmacros_doc_en.tex
@@ -4,7 +4,7 @@
 % - macros and commands for chemists                                        - %
 % --------------------------------------------------------------------------- %
 % - Clemens Niederberger                                                    - %
-% - 2011/10/28                                                              - %
+% - 2011/11/03                                                              - %
 % --------------------------------------------------------------------------- %
 % - http://www.mychemistry.eu/                                              - %
 % - contact@mychemistry.eu                                                  - %
@@ -34,7 +34,7 @@
 
 \newcommand*\CMname{\textsf{chemmacros}\xspace}
 \newcommand*\CMversion{2.0\xspace}
-\newcommand*\CMdate{2011/10/28\xspace}
+\newcommand*\CMdate{2011/11/03\xspace}
 
 % changing some tufte-handout settings
 \titleformat{\section}[hang]{\normalfont\Large\bfseries}{\thesection}{1em}{}[]
@@ -117,6 +117,7 @@
     \group_end:
   }
 
+% Key[<default>][<module>](<label prefix>){<key>}{<val>}
 \NewDocumentCommand \Key { o o d() m m }
   {
     \IfNoValueTF { #3 }
@@ -173,7 +174,7 @@
 \begin{titlepage}
  \begin{fullwidth}
  \centering
- \Huge chemmacros v\CMversion
+ \Huge chemmacros v\CMversion{}a
  \vskip.5cm
  \Large\CMdate
  \vskip.5cm
@@ -250,6 +251,7 @@ Some simple macros for displaying often needed particles and a symbol. Please no
  \item\cmd{ntr} \ntr (neutron)
  \item\cmd{Nu} \Nu (nucleophile)
  \item\cmd{El} \El (electrophile)
+ \item\cmd{ba} \ba (base)
  \item\cmd{fplus} \fplus
  \item\cmd{fminus} \fminus
  \item\cmd{transitionstatesymbol} \transitionstatesymbol\ (uses \TikZ)
@@ -262,6 +264,22 @@ There is another command which allows to typeset radicals with charges and subsc
 \begin{LTXexample}
  \R[+]{tert} \R[-]{sek} \R{prim}
 \end{LTXexample}
+The two particles \cmd{Nu} and \cmd{ba} can be modified. To do that you use the key \code{elpair}\Key[false][particle]{elpair}{false/\uline{dots}/dash}. It only has any effect, if the package \paket{chemfig} is loaded, since it uses it's command \cmd{Lewis}.
+\begin{LTXexample}
+ \documentclass{article}
+ \usepackage{chemmacros,chemfig}
+ \begin{document}
+  \ba[elpair] \Nu[elpair=dash]
+ \end{document}
+\end{LTXexample}
+\begin{LTXexample}
+ \documentclass{article}
+ \usepackage{chemmacros,chemfig}
+ \begin{document}
+  \chemsetup[particle]{elpair}
+  \ba \Nu
+ \end{document}
+\end{LTXexample}
 
 \section{Stereo Descriptors, Nomenclature, Latin Phrases}\label{sec:stereo}
 \subsection{Stereo Descriptors and Nomenclature}
@@ -298,6 +316,7 @@ absolute configuration (uses \TikZ):
  \cmd{Sconf\oa{<letter>}} \cmd{Sconf}: \Sconf \quad\cmd{Sconf\oa{}}: \Sconf[]
 \end{framed}
 
+\newpage
 Examples:\marginnote{Of course the appearance depends on the font you chose:\par\cip{2S,3R} \E \Z \Dfi \Lfi\par\fontfamily{ptm}\selectfont\cip{2S,3R} \E \Z \Dfi \Lfi\par\fontfamily{ppl}\selectfont\cip{2S,3R} \E \Z \Dfi \Lfi}
 \begin{LTXexample}[pos=b]
  \Dfi-Weins\"aure = \cip{2S,3S}-Weins\"aure  \\
@@ -308,7 +327,6 @@ Examples:\marginnote{Of course the appearance depends on the font you chose:\par
  \IUPAC{\Dfi\-Wein\|s\"aure} = \IUPAC{\cip{2S,3S}\-Wein\|s\"aure}, \IUPAC{\Dfi\-($-$)\-Threose} = \IUPAC{\cip{2S,3R}\-($-$)\-2,3,4\-Tri\|hydroxy\|butanal}
 \end{LTXexample}
 
-\newpage
 \subsection{Latin Phrases}
 At last there are two commands for common latin phrases.
 \begin{framed}
@@ -464,7 +482,9 @@ The following macros are useful together with \paket{chemfig}, too.
  \cmd{scrp} \scrp (\textbf{scr}iptstyle + \textbf{p}lus) \\
  \cmd{scrm} \scrm (\textbf{scr}iptstyle + \textbf{m}inus) \\
  \cmd{fscrp} \fscrp \\
- \cmd{fscrm} \fscrm
+ \cmd{fscrm} \fscrm \\
+ \cmd{fsscrp} \fsscrp (using \cmd{scriptscriptstyle})\\
+ \cmd{fsscrm} \fsscrm
 \end{framed}
 \begin{LTXexample}[pos=b,rframe=]
  \setatomsep{1.8em}\chemfig{CH_3-\chemabove{C}{\scrp}(-[6]C|H_3)-\vphantom{H_3}CH_3}
@@ -550,7 +570,6 @@ Examples:
 
 In v1.1 there was the command \cmd{setredoxdist\ma{<dim>}}\formercmd{setredoxdist\ma{<dim>}}. By using the package option \code{version=1} it is provided again.
 
-\newpage
 \section{(Standard) State, Thermodynamics}\label{sec:standardstate}
 \subsection{Thermodynamic Variables}\label{ssec:siunitx}
 The following commands use \paket{siunitx}:\changed{Enthalpy}\changed{Entropy}\changed{Gibbs}
@@ -844,6 +863,7 @@ One can think of other uses, too:
  C\sld[graphite]
 \end{LTXexample}
 
+\newpage
 \subsection{Text Under Compounds}\label{ssec:mhchem_beschriftung}
 \CMname provides a command, with which you can place text below of compounds.\changed{mhName}\Key[\cmd{centering}][mhName]{align}{<alignment>}\Key[][mhName]{fontattr}{<commands>}\Key[\cmd{tiny}][mhName]{fontsize}{<fontsize>}\Key[][mhName]{width}{<dim>}
 \begin{framed}
@@ -923,6 +943,7 @@ There are the following types available for \code{<type>}:
  \orbital{s} \orbital{p} \orbital{sp} \orbital{sp2} \orbital{sp3}
 \end{LTXexample}
 
+\newpage
 Depending on the type you have different keys to modify the orbitals:\Key[+][orbital/<type>](orbital){phase}{\uline{+}/-}\Key[1][orbital/<type>](orbital){scale}{<factor>}\Key[black][orbital/<type>](orbital){color}{<color>}\Key[90][orbital/<type>](orbital){angle}{<angle>}\Key[false][orbital/<type>](orbital){half}{\uline{true}/false}
 \begin{itemize}
  \item\code{phase = \uline{+}/-} changes the phase of the orbital (all types)
@@ -988,6 +1009,8 @@ Some keys can be set without value. Then the \uline{underlined} value is used.
  german              & option   & \uline{true}/false      & false                 & page \pageref{key:option_german} \\
  version             & option   & 1/2                     & 2                     & page \pageref{key:option_version} \\
  xspace              & option   & \uline{true}/false      & true                  & page \pageref{key:option_xspace} \\
+ \multicolumn{5}{l}{\cmd{ba}, \cmd{Nu}:} \\
+ elpair              & base     & \uline{dots}/dash/false & false                 & page \pageref{key:particle_elpair} \\
  \multicolumn{5}{l}{\cmd{pch}, \cmd{mch}, \cmd{fpch}, \cmd{fmch}:} \\
  append              & charges  & \uline{true}/false      & false                 & Seite \pageref{key:charges_append} \\
  \multicolumn{5}{l}{\cmd{ox}:} \\