path: root/Master/texmf-dist/source/latex/chemstyle/chemstyle.dtx

% \iffalse meta-comment
%
% Copyright (C) 2007 by
%    Joseph Wright <joseph.wright@morningstar2.co.uk>
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either
% version 1.3 of this license or (at your option) any later
% version. The latest version of this license is in
%    http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of
% LaTeX version 2003/12/01 or later.
%
% This work has the LPPL maintenance status ``maintained.''
%
% The current maintainer of this work is Joseph Wright.
%
% This work consists of the source file chemscheme.dtx
%                 and the derived files chemstyle.ins,
%                                       chemstyle.sty,
%                                       chemstyle.pdf,
%                                       rsc.jdf,
%                                       angew.jdf,
%                                       tetlett.jdf,
%                                       jomc.jdf,
%                                       jacs.jdf,
%                                       ic.jdf,
%                                       jpc.jdf,
%                                       orglett.jdf and
%                                       none.jdf
% Unpacking:
%    (a) If chemstyle.ins is present:
%           tex chemstyle.ins
%    (b) Without chemstyle.ins:
%           tex chemstyle.dtx
%    (c) If you use LaTeX to generate files:
%           latex \let\install=y\input{chemstyle.dtx}
%
% Documentation:
%    (a) Without write18 enabled:
%          pdflatex chemstyle.dtx
%          makeindex -s gind.ist chemstyle.idx
%          makeindex -s gglo.ist -o chemstyle.gls  chemstyle.glo
%          pdflatex chemstyle.dtx
%          makeindex -s gind.ist chemstyle.idx
%          makeindex -s gglo.ist -o chemstyle.gls  chemstyle.glo
%          pdflatex chemstyle.dtx
%    (b) With write18 enabled:
%          pdflatex chemstyle.dtx
%          pdflatex chemstyle.dtx
%          pdflatex chemstyle.dtx
%
% Installation:
%     Copy chemstyle.sty to a location searched by TeX, and
%     if required by your TeX installation, run the appropriate
%     command to build a hash of files (texhash, mpm --update-db,
%     etc.)
%
% Note:
%     The jawltxdoc.sty file is not needed for installation,
%     only for building the documentation.  It may be deleted.
%
%<*ignore>
% This is all taken verbatim from Heiko Oberdiek's packages
\begingroup
  \def\x{LaTeX2e}%
\expandafter\endgroup
\ifcase 0\ifx\install y1\fi\expandafter
         \ifx\csname processbatchFile\endcsname\relax\else1\fi
         \ifx\fmtname\x\else 1\fi\relax
\else\csname fi\endcsname
%</ignore>
%<*install>
\input docstrip.tex
\keepsilent
\askforoverwritefalse
\preamble
 ----------------------------------------------------------------
 The chemstyle package --- Writing chemistry with style
 Maintained by Joseph Wright
 E-mail: joseph.wright@morningstar2.co.uk
 Released under the LaTeX Project Public License v1.3 or later
 See http://www.latex-project.org/lppl.txt
 ----------------------------------------------------------------

\endpreamble
\Msg{Generating chemstyle files:}
\usedir{tex/latex/contib/chemstyle}
\generate{\file{\jobname.ins}{\from{\jobname.dtx}{install}}
          \file{\jobname.sty}{\from{\jobname.dtx}{package}}
          \file{jawltxdoc.sty}{\from{\jobname.dtx}{jawltxdoc}}
}
\generate{\file{rsc.jdf}{\from{chemstyle.dtx}{rsc}}
          \file{angew.jdf}{\from{chemstyle.dtx}{angew}}
          \file{tetlett.jdf}{\from{chemstyle.dtx}{tetlett}}
          \file{jomc.jdf}{\from{chemstyle.dtx}{jomc}}
          \file{jacs.jdf}{\from{chemstyle.dtx}{jacs}}
          \file{ic.jdf}{\from{chemstyle.dtx}{ic}}
          \file{jpc.jdf}{\from{chemstyle.dtx}{jpc}}
          \file{orglett.jdf}{\from{chemstyle.dtx}{orglett}}
}
\generate{\file{none.jdf}{\from{chemstyle.dtx}{none}}
}
\endbatchfile
%</install>
%<*ignore>
\fi
% Will Robertson's trick
\immediate\write18{makeindex -s gind.ist -o \jobname.ind  \jobname.idx}
\immediate\write18{makeindex -s gglo.ist -o \jobname.gls  \jobname.glo}
%</ignore>
%<*driver>
\PassOptionsToClass{a4paper}{article}
\documentclass{ltxdoc}
\EnableCrossrefs
\CodelineIndex
\RecordChanges
%\OnlyDescription
% The various formatting commands used in this file are collected
% together in |jawltxdoc|.
\usepackage{jawltxdoc}
\begin{document}
  \DocInput{\jobname.dtx}
\end{document}
%</driver>
% \fi
%
%\CheckSum{658}
%
% \CharacterTable
%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%   Digits        \0\1\2\3\4\5\6\7\8\9
%   Exclamation   \!     Double quote  \"     Hash (number) \#
%   Dollar        \$     Percent       \%     Ampersand     \&
%   Acute accent  \'     Left paren    \(     Right paren   \)
%   Asterisk      \*     Plus          \+     Comma         \,
%   Minus         \-     Point         \.     Solidus       \/
%   Colon         \:     Semicolon     \;     Less than     \<
%   Equals        \=     Greater than  \>     Question mark \?
%   Commercial at \@     Left bracket  \[     Backslash     \\
%   Right bracket \]     Circumflex    \^     Underscore    \_
%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%   Right brace   \}     Tilde         \~}
%
% \GetFileInfo{\jobname.sty}
%
%\changes{v1.0}{2006/08/06}{Initial release of package}
%\changes{v1.0b}{2007/09/04}{Added |microtype| and |notes2bib| to
%  template}
%\changes{v1.1}{2007/09/17}{License changed from GPL to LPPL}
%\changes{v1.1}{2007/09/17}{Phrases modified to better avoid clash
%  with user's own commands}
%\changes{v1.1}{2007/09/17}{Fixed error with spacing after
%  \emph{e.g.}~and \emph{i.e.}}
%\changes{v1.1a}{2007/09/18}{Fixed error in documentation compilation
%  under LaTeX}
%\changes{v1.1c}{2007/09/23}{Fixed problems with capitalisation
%  of \texttt{SIunits}}
%\changes{v1.1c}{2007/09/23}{Documentation improved}
%\changes{v1.1e}{2007/10/07}{Fixed packaging problem}
%
%\DoNotIndex{\@fs@capt,\@fs@cfont,\@fs@iftopcapt,\@fs@mid,\@fs@post}
%\DoNotIndex{\@fs@pre,\@ifclassloaded,\@ifnextchar,\@ifpackageloaded}
%\DoNotIndex{\@undefined,\abovecaptionskip,\addto,\AtBeginDocument}
%\DoNotIndex{\begin,\begingroup,\belowcaptionskip,\bfseries,\bibname}
%\DoNotIndex{\captionsetup,\cm,\color,\csname,\CurrentOption}
%\DoNotIndex{\DeclareCaptionFormat,\DeclareCaptionLabelSeparator}
%\DoNotIndex{\DeclareOption,\DeclareRobustCommand,\def}
%\DoNotIndex{\documentclass,\edef,\else,\emph,\end,\endcsname}
%\DoNotIndex{\endgroup,\ensuremath,\ExecuteOptions,\expandafter}
%\DoNotIndex{\femtogram,\fg,\fi,\figurename,\floatc@plain}
%\DoNotIndex{\floatc@ruled,\floatcontentscentre,\floatplacement}
%\DoNotIndex{\floatstyle,\hertz,\hrule,\iffalse,\iftrue,\ifx,\input}
%\DoNotIndex{\InputIfFileExists,\kern,\labelformat,\languagename}
%\DoNotIndex{\let,\MakeUppercase,\MessageBreak,\NeedsTeXFormat}
%\DoNotIndex{\newcommand,\newfloat,\newif,\newunit,\PackageInfo}
%\DoNotIndex{\PackageWarning,\PassOptionsToPackage,\ProcessOptions}
%\DoNotIndex{\providecommand,\ProvidesFile,\ProvidesPackage,\quad}
%\DoNotIndex{\refname,\relax\renewcommand,\RequirePackage}
%\DoNotIndex{\restylefloat,\rotatebox,\selectlanguage,\space}
%\DoNotIndex{\tablename,\textsc,\textsuperscript,\unitsep}
%\DoNotIndex{\unitsuperscript,\usepackage,\varnothing,\vspace}
%\DoNotIndex{\xspace,\@tempa,\@tempb,\centi,\cubed,\deci}
%\DoNotIndex{\DeclareMathSymbol,\DeclareSymbolFont,\dm}
%\DoNotIndex{\mathord,\metre,\milli,\mole,\relax,\spacefactor}
%\DoNotIndex{\usk,\futurelet,\@ifundefined}
%
% \title{\texttt{chemstyle} --- Writing chemistry with style%
%   \thanks{This file describes version \fileversion, last revised
%           \filedate.}}
% \author{Joseph Wright%
%   \thanks{E-mail: joseph.wright@morningstar2.co.uk}}
% \date{Released \filedate}
%
% \maketitle
%
%\begin{abstract}
% The |chemstyle| package provides a ``one-stop shop'' for setting up
% formatting of LaTeX documents following the editorial policies of
% various chemical journals.  It provides a number of handy
% chemistry-related commands, and loads several support packages to
% aid the chemist.
%\end{abstract}
%
%\begin{multicols}{2}
%\tableofcontents
%\end{multicols}
%
%\section{Introduction}
% The aim of |chemstyle| is to provide a quick method to set up
% various document parameters (such as caption formatting), simply by
% specifying the model journal.  The package has also been designed
% to allow rapid addition of new journal styles.  Each style
% definition is a separate file, and new styles can be added very
% readily. |chemstyle| has grown out of the |rsc| package, which had
% a similar aim but was much more limited (and less robustly
% implemented).  The |chemstyle| package is also designed with the
% use of |biblatex| in mind: the |rsc| package is closely bound to
% traditional BibTeX use.
%
% As a successor to the |rsc| package, |chemstyle| provides a range
% of chemistry-related additional macros.  The set provided here is
% an extended version of those provide by |rsc|.  Everything that can
% be done using the |rsc| LaTeX package is therefore possible using
% the |chemstyle| package.
%
% The formatting system provided by |chemstyle| are intended for
% writing a variety of documents.  Thus the stylistic changes made by
% the package do not seek to reproduce the appearance of printed
% journal articles.  The package aims to be suitable for use in
% preparing drafts of papers, but also for writing reports, theses
% and so on.
%
%\section{Style options for \texttt{chemstyle}}
% |chemstyle| should be loaded with a package option specifying which
% journal style to follow.  Currently, |chemstyle| is aware of a the
% styles listed in Table~\ref{styles}.  New styles can be developed
% by creating a new file modelled on the existing definitions;
% |chemstyle| will automatically search for correctly-named styles.
%\begin{table}
%  \begin{tabular}{ll}
%    \toprule
%    Option & Journals using this style \\
%    \midrule
%    none &  Not applicable\\
%    angew & \emph{Angew.\ Chem.}, \emph{Chem.\ Eur.\ J.} \\
%    jomc & \emph{J.\ Organomet.\ Chem.},
%      \emph{Coord.\ Chem.\ Rev.} \\
%    ic & \emph{Inorg.\ Chem.} \\
%    jacs & \emph{J.\ Am.\ Chem.\ Soc.} \\
%    jcp & \emph{J.\ Phys.\ Chem.\ A}, \emph{J.\ Phys.\ Chem.\ B} \\
%    orglett & \emph{Org.~Lett.}\\
%    rsc & \emph{Chem.\ Commun.}, \emph{Org.\ Biomol.\ Chem.} \\
%     & \emph{Dalton Trans.} \\
%    tetlett & \emph{Tetrahedron}, \emph{Tetrahedron Lett.} \\
%    \bottomrule
%  \end{tabular}
%  \caption{Styles provided by \texttt{chemstyle}}\label{styles}
%\end{table}
% The style files provided with |chemstyle| have been derived from
% current practice in the target journals.  It is not always easy to
% pick the correct stylistic settings from (sometimes inconsistent)
% real-world examples.  The package author welcomes feedback on the
% styles provided.
%
% The |none| style is notable as it is not based on a journal.
% Instead this is a minimal style, which provides the additional
% commands without making formatting changes.  It is also the default
% style if no option is given.  This document has been compiled
% implicity using the |none| option, for example.
%
%\subsection{Creating styles}
% The process of creating a new styles for |chemstyle| is intended to
% be relatively easy.  New styles should be saved as files with the
% extension |.jdf| (standing for for Journal Definition File), and
% should be saved somewhere in the path searched by
% TeX.\footnote{Depending on your TeX distribution, you may need to
% rebuild your file database after creating a new style.  For MikTeX
% users, this can be done graphically or by typing \texttt{mpm
% --update-db} at the command line; for TeXLive, run
% \texttt{texhash}.}  The definition files included in the package
% should provide a guide to the basic options available for producing
% new styles.  Arbitrary TeX commands can be included, if they are
% necessary for a particular style.  For example, other packages can
% be loaded in \cmd{\usepackage}.
%
% The maintainer of |chemstyle| is happy to add new styles to the
% package, either by contribution by users or on request (when he has
% sufficient time!).  If you have a new style to add (or corrections to
% an existing one), please contact the package author.
%
%\subsection{Package options}
% As well as the various journal styles provided with the package, a
% number of options are recognised to alter compatibility with other
% packages and to give the desired output. |chemstyle| will also pass
% options through to the |chemscheme| package, which is used to
% provide support for schemes.  Users should consult the |chemscheme|
% documentation for the options applicable.
%
% Currently, |chemstyle| has options |nonotes|, |nophrases|,
% |SIunits| and |xspace|.  These are explained at the appropriate
% places within this document.  All are hopefully relatively clearly
% named.
%
%\section{Naming of the references section}
% |chemstyle| alters the naming of the references section of a
% document. By default, |chemstyle| alters the value of
% \cmd{\bibname} or \cmd{\refname} (as appropriate) to the form of
% words chosen by the target journal for the ``\refname'' section.
%
% The ``\refname'' naming commands are language-aware, \emph{via} the
% |babel| interface.  Currently, |chemstyle| includes appropriate
% labels for babel languages |english|, |UKenglish|, |ngerman| and
% |french|.\footnote{The \texttt{french} option for \texttt{babel}
% causes a clash with \texttt{unitsdef} concerning the command
% \texttt{\textbackslash fg}.  \texttt{babel} uses this for
% \emph{guillemets}, while \texttt{unitsdef} uses it as an
% abbreviation for \texttt{\textbackslash femtogram}.  The
% \texttt{chemstyle} package prevents the clash, and leaves the
% \texttt{babel} definition intact.} Other languages can be added if
% appropriate wordings are provided to the author.
%
% The |chemstyle| packages recognises the |nonotes| option, which
% affects how the \refname section is headed.   With the |nonotes|
% option, the ``Notes'' part of the section name is omitted, and only
% the ``\refname'' phrase is output.
%
%\section{Additional macros}
%
%\subsection{Additional units}
% Both the |unitsdef| and |SIunits| packages provide a great number
% of easy to use unit commands, and handles spacing between numbers
% and units very well. However, a few useful units seem to be
% missing, and are provided here. By default, |chemstyle| uses the
% |unitsdef| package to achieve this, but using the |SIunits| option
% will use that package instead.
%\DescribeMacro{\Hz}
%\DescribeMacro{\mmHg}
%\DescribeMacro{\molar}
%\DescribeMacro{\Molar}
%\DescribeMacro{\cmc}
% The most obvious of these is \cmd{\Hz}, which simply gives \Hz. The
% command \cmd{\mmHg} has a non-breaking thin space, leading to
% \mmHg. Two related commands are given for concentration:
% \cmd{\molar} gives \molar, whilst \cmd{\Molar} gives \Molar.
% Finally, the command \cmd{\cmc} is provided for generating \cmc.
% When using |unitsdef|, all of the new macros space correctly with
% numbers, so inputting |10\cmc| gives 10\cmc, with a non-breaking
% space.  Users of |SIunits| will be familiar with the approach used
% by that package.
%
%\subsection{The standard state symbol}
%\DescribeMacro{\standardstate}
% Related to the above, but not exactly a unit is the
% \cmd{\standardstate} command.\footnote{The \texttt{\textbackslash
% standardstate} macro is only defined if the user does not have
% their own version.}  This generates the tricky \standardstate\
% symbol: |$\Delta S\standardstate$| generates $\Delta
% S\standardstate$.  Note that this is safe in either text or maths
% mode.
%
%\subsection{Alkyl radicals}
%\DescribeMacro{\iPr}
%\DescribeMacro{\iPr}
%\DescribeMacro{\nBu}
%\DescribeMacro{\iBu}
%\DescribeMacro{\sBu}
%\DescribeMacro{\tBu}
% There are a few alkyl radicals that come up all of the time.  No
% one seems to have put these into a package, so they are provided
% here. As you would expect, \cmd{\iPr} gives \iPr, \cmd{\iBu} gives
% \iBu\ and \cmd{\tBu} gives \tBu, and so on.  The style of the
% output depends on the journal style specified; most journals seem
% to favour one version of the abbreviation.  When |chemstyle| is
% loaded using the |xspace| option, the |xspace| package is
% automatically used to add space after the command names, so that
% |\iPr group| will result in ``\iPr\ group'' being
% typeset.\footnote{Reader of the source of this document will see
% that this document has been compiled \emph{without} the |xspace|
% option!}
%
%\subsection{Latin phrases}
%\DescribeMacro{\latin}
%\DescribeMacro{\etc}
%\DescribeMacro{\eg}
%\DescribeMacro{\ie}
%\DescribeMacro{\etal}
%\DescribeMacro{\invacuo}
% The various Latin phrases commonly used in chemistry are made
% available as the obvious commands.  By altering the definition of
% \cmd{\latin}, this allows ready switching from italic to Roman
% typesetting.  Notice that \cmd{\etc}, \cmd{\ie} and \cmd{\eg} are
% aware of trailing periods, and so doubling-up should not occur.
% Once again, these macros use |xspace| when given as a package
% option to handle automatic addition of spaces after these phrases.
%  For American journals, where it is obligatory to follow ``\eg''
% and ``\ie'' with a comma, the package provides a mechanism for
% handling this automatically.  Thus, when using an appropriate
% journal style, |\eg|, |\eg.| and |\eg,| will all result in
% typesetting ``\eg,''.
%
% The \cmd{\etc} and \cmd{\etal} commands are set up on the
% assumption that they come at the end of a sentence.  Hence the
% spacing after these will default to an inter-sentence space.  If
% you desire an inter-word space, use the normal methods
% |\etc\ more text|, |\etc~more text|, \etc.  If this is a big issue,
% the package author may look at it again.
%
% The definitions of all of the phrases are designed not to overwrite
% any given by the user \emph{in the preamble}.  So, if you have your
% own \cmd{\latin} macro, it will be used even if you load
% |chemstyle|. If you encounter any problems, try loading the package
% with the |nophrases| option; this option prevents the package even
% trying to define any of the phrase macros.
%
%\DescribeMacro{\latinemphon}
%\DescribeMacro{\latinemphoff}
% The formatting of Latin phrases can be altered using the two macros
% \cmd{\latinemphon} and \cmd{\latinemphoff}, which switch the use of
% \cmd{\emph} for Latin phrases on and off.  These macros are mainly
% intended for the use in journal style files, but may be more
% generally useful.
%
%\section{Additional information}
%\subsection{Advice for users of \texttt{rsc} and \texttt{achemso}}
% The |chemstyle| package is intended as a replacement for the |rsc|
% package.  As such, it covers almost everything the the |rsc| LaTeX
% package does, and more.  Users of |rsc| are strongly encouraged to
% update to using |chemstyle|.  The bibliography styles provided by
% |achemso| and |rsc| will continue to be required, of course.
% Migration of these styles to |biblatex| is an on-going project.
%
%\subsection{Interactions with other packages}
% The |chemstyle| package has been designed to avoid, as far as
% possible, clashes with other packages.  The package requires the
% presence of the standard |graphicx| and |varioref| packages. If
% these packages need to be loaded with explicit options, this should
% be done \emph{before} loading |chemstyle|. The |chemscheme| package
% is also needed, as it provides the floating |scheme| environment
% essential in synthetic chemistry documents.
%
%\subsection{Captions above floats}
% The |scheme| float type is generated using the |float| package.
% This has the side-effect that the placement of captions for floats
% does not depended on where the \cmd{\caption} command comes inside
% the floating environment.\footnote{Normally this is a good thing.}
% If you wish to alter the placement of captions, the mechanism of
% the underlying |float| package will be needed.  This requires the
% use of \cmd{\floatstyle} to load the desired settings, followed by
% \cmd{\restylefloat} to apply the settings.  This is most usually
% done with tables.
%\begin{LaTeXexample}[\typesetfloatexample]
% \begin{table}[h]
% \caption{A caption above the float contents}
% The float contents
% \end{table}
% \floatstyle{plaintop}
% \restylefloat{table}
% \begin{table}[h]
% \caption{A second caption above the float contents}
% The second float contents
% \end{table}
%\end{LaTeXexample}
%
% \iffalse
%<*template>
% \fi
% \section{A template for chemical articles}
% This is a very simple template for chemistry-related documents.
% Hopefully it contains a few extra hints for getting well-formatted
% documents quickly.  For simplicity, the template assumes that the
% user is writing a thesis for a U.K.~university.  Hence it uses
% U.K.~defaults and RSC-based styling.
%
% The versatile \textsc{koma-script} bundle provides more advanced
% versions of the standard document classes.  If you want paragraphs
% separated out, with no indents (a common style for theses), add the
% |parskip| option to the font and paper size ones given here.
%    \begin{macrocode}
\documentclass[fontsize=10pt,paper=a4]{scrreprt}
%    \end{macrocode}
% The |geometry| package allows the users to alter page layout
% with ease; much better than trying to hack the raw LaTeX system.
%    \begin{macrocode}
\usepackage{geometry}
%    \end{macrocode}
% The |babel| system is loaded to sort out hyphenation and so on,
% and could be useful if there are any foreign-language quotes.
%    \begin{macrocode}
\usepackage[english,UKenglish]{babel}
%    \end{macrocode}
% Load |chemstyle| (of course) to give not only some easy formatting,
% but also to automatically provide a float type for schemes, thanks
% to the |chemscheme| package.  This also loads either
% |chemcompounds| or (optionally) |bpchem| to track compound numbers.
% Using the |xspace| option automatically adds space after the
% various abbreviations.
%    \begin{macrocode}
\usepackage[rsc,xspace]{chemstyle}
%    \end{macrocode}
% The |mhchem| package provides the \cmd{\ce} command for rapidly
% typesetting formulas, so that you can type |\ce{H2SO4}| and get
% \ce{H2SO4}.
%    \begin{macrocode}
\usepackage[version=3]{mhchem}
%    \end{macrocode}
% Greek letters should be italic if used for variables, but upright
% (Roman) if used otherwise.  So the standard LaTeX |$\delta$| is
% fine for typesetting an NMR shift (\eg\ $\delta = \dots$ ppm.),
% but not for a $\upsigma$-bond or a $\uppi$-complex.  The |upgreek|
% package provides commands such as |$\upsigma$| and |$\uppi$| which
% are ideal for this.
%    \begin{macrocode}
\usepackage{upgreek}
%    \end{macrocode}
% The default LaTeX table formatting is not very good.  The
% |booktabs| package does things properly, and has good
% advice in the manual.  A highly-recommended package for
% those interested in formatting (\ie\ all (La)TeX users!).
%    \begin{macrocode}
\usepackage{booktabs}
%    \end{macrocode}
% The |microtype| package improves formatting when used with the
% pdfTeX engine.  By giving the |final| option, it is active even
% when using |draft| as a global option.
%    \begin{macrocode}
\usepackage[final]{microtype}
%    \end{macrocode}
% Using |notes2bib| allows the user to automatically add notes to the
% bibliography from within the document body.  So you can put
% |\bibnote{A note}| in the source, and this will move into the
% References section without any further effort.  The |footnotes|
% option means that footnotes do the same.
%    \begin{macrocode}
\usepackage[footnotes]{notes2bib}
%    \end{macrocode}
% Finally, the |hyperref| package makes headings, citations and so on into
% hyperlinks.
%    \begin{macrocode}
\usepackage[colorlinks]{hyperref}
%    \end{macrocode}
% The bulk of the document can then start.
%    \begin{macrocode}
\begin{document}
\end{document}
%    \end{macrocode}
% \iffalse
%</template>
% \fi
%
% \StopEventually{}
%
% \iffalse
%<*package>
% \fi
%\section{The package code}
%
%\subsection{Setup code}
% First of all, the package identifies itself and loads other
% packages needed to function.  Loading |chemscheme| is deferred
% until later, to allow processing of options at the correct point.
%    \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{chemstyle}
  [2007/10/31 v1.1h Writing chemistry with style]
%    \end{macrocode}
%\changes{v1.1d}{2007/10/04}{Require caption in all cases}
%\changes{v1.0a}{2007/08/23}{No longer load \texttt{fixltx2e}
%  package}
% Packages that are needed under all circumstances are loaded here.
%    \begin{macrocode}
\RequirePackage{graphicx,varioref,caption}
%    \end{macrocode}
%
%\subsection{Alkyl radicals}
%\begin{macro}{\cst@emph}
%\begin{macro}{\cst@hyph}
%\begin{macro}{\cst@super}
% Alkyl radical abbreviations are produced using the macro
% \cmd{\cst@radical}.  This uses a series of formatting commands,
% which have default values provided here.  The names are hopefully
% pretty self-explanatory.
%    \begin{macrocode}
\let\cst@emph\relax
\def\cst@hyph{}
\let\cst@super\relax
\newif  \ifcst@prefix   \cst@prefixtrue
%    \end{macrocode}
%\end{macro}
%\end{macro}
%\end{macro}
%\begin{macro}{\cst@radical}
% The \cmd{\cst@radical} macro does the hard work of declaring
% each abbreviation.  To ensure there is no unexpected clash of
% names, \cmd{\newcommand} is used first to check for any problems.
% The commands are made robust so they can (hopefully) be used
% anywhere.
%    \begin{macrocode}
\def\cst@radical#1#2{%
  \expandafter\newcommand\expandafter{\csname #1#2\endcsname}{}%
  \expandafter\DeclareRobustCommand\expandafter{%
    \csname #1#2\endcsname}{%
    \ifcst@prefix
      \cst@super{\cst@emph{#1}}\cst@hyph#2%
    \else
      #2\cst@hyph\cst@super{\cst@emph{#1}}%
    \fi%
    \cst@xspace
  }
}
%    \end{macrocode}
%\end{macro}
% With a mechanism in place, the abbreviations are declared.  The
% format of the resulting output will depend upon the configuration
% file used.
%    \begin{macrocode}
\cst@radical{n}{Pr}%
\cst@radical{i}{Pr}%
\cst@radical{n}{Bu}%
\cst@radical{i}{Bu}%
\cst@radical{s}{Bu}%
\cst@radical{t}{Bu}%
%    \end{macrocode}
%
% \subsection{Option handling}
% Firstly, the ``pass through'' options are handled, as these will be
% sent through to |chemscheme|.  The package options for |chemstyle|
% are also handled here.
%\changes{v1.1}{2007/09/17}{Added \texttt{phrases} option}
%\changes{v1.1}{2007/09/17}{Added \texttt{siunits} option}
%\changes{v1.1}{2007/09/17}{Added \texttt{xspace} option}
%\changes{v1.1c}{2007/09/23}{Added \texttt{SIunits} option}
%    \begin{macrocode}
\newif  \ifcst@notes    \cst@notestrue
\newif  \ifcst@phrases  \cst@phrasestrue
\newif  \ifcst@si       \cst@sifalse
\newif  \ifcst@xspace   \cst@xspacefalse
\DeclareOption{ch}{\ExecuteOptions{chapter}}
\DeclareOption{chapter}%
  {\PassOptionsToPackage{chapter}{chemscheme}}
\DeclareOption{chemcompounds}%
  {\PassOptionsToPackage{chemcompounds}{chemscheme}}
\DeclareOption{nonotes}{\cst@notesfalse}
\DeclareOption{nophrases}{\cst@phrasesfalse}
\DeclareOption{siunits}{\cst@sitrue}
\DeclareOption{SIunits}{\cst@sitrue}
\DeclareOption{xspace}{\cst@xspacetrue}
%    \end{macrocode}
% In order to handle the loading of style definitions correctly, a
% bit of care is needed.  The package options need to be loaded
% \emph{before} |chemscheme|, but the style definitions need to
% be loaded after |chemscheme|.  This is achieved by saving the
% options and looking at them again once the package loading is done.
% Notice that only one style definition can be used, so this is
% taken care of with a warning if needed.
%    \begin{macrocode}
\let\cst@option\relax
\DeclareOption*{%
  \ifx\cst@option\relax\else
    \PackageWarning{chemstyle}
      {Extra option \cst@option\space ignored}
  \fi
  \edef\cst@option{\CurrentOption}
}
%    \end{macrocode}
% If |SIunits| is already loaded, then the option has to be set.
%    \begin{macrocode}
\@ifpackageloaded{SIunits}
  {\ExecuteOptions{siunits}}
  {\@ifpackageloaded{siunits}
    {\ExecuteOptions{siunits}}
    {}}
\ProcessOptions*
\ifcst@si
  \@ifpackageloaded{unitsdef}
    {\PackageWarning{chemstyle}{%
      You have set the SIunits option,\MessageBreak
      but have already loaded unitsdef!\MessageBreak
      unitsdef will be used for extra unit macros}
    \cst@sifalse}
    {\AtBeginDocument{%
      \@ifpackageloaded{siunits}%
        {}
        {\RequirePackage{SIunits}}%
      }
    }
\else
%    \end{macrocode}
% The \cmd{\fg} macro is defined in French as a \emph{guillemet} sign,
% and so to avoid a clash a bit of patching is needed. A check to see
% if |babel| has already defined \cmd{\fg}\@. If it has, the definition
% is saved and deleted.
%    \begin{macrocode}
  \ifx\fg\@undefined
  \else
    \ifx\fg\relax
    \else
      \let\cst@fg\fg
      \let\fg\@undefined
    \fi
  \fi
  \RequirePackage{unitsdef}
%    \end{macrocode}
% If \cmd{\cst@fg} exists, it is restored here, otherwise \cmd{\fg}
% is undefined.  At the beginning of the document, \cmd{\fg} is
% defined as an abbreviation for a femtogram if it is not being used
% by |babel|.  This way there is not a problem if |babel| is loaded
% after |chemstyle|.
%    \begin{macrocode}
  \ifx\cst@fg\@undefined
    \let\fg\@undefined
  \else
    \let\fg\cst@fg
  \fi
  \AtBeginDocument{%
    \ifx\fg\@undefined
      \newcommand{\fg}{\femtogram}
    \fi
  }
\fi
\RequirePackage{chemscheme}
%    \end{macrocode}
%
%\subsection{Extra units and related commands}
%
%\begin{macro}{\cubiccentimeter}
%\begin{macro}{\cmc}
%\begin{macro}{\Hz}
%\begin{macro}{\Molar}
%\begin{macro}{\molar}
%\begin{macro}{\mmHg}
%\begin{macro}{\mol}
%\changes{v1.0b}{2007/09/04}{New macro}
% A few additional unit types are provides, which |unitsdef| and
% |SIunits| do not provide. Most of these require different set up
% for the two supported packages.
%    \begin{macrocode}
\ifcst@si
  \newcommand{\cubiccentimeter}{\centi\metre\cubed}
  \newcommand{\Molar}{\textsc{m}}
  \newcommand{\molar}{\mole\usk\deci\metre\rpcubed}
  \newcommand{\mmHg}{\milli\metre~Hg}
  \newcommand{\mol}{\mole}
\else
  \newunit{\cubiccentimeter}{\cm\unitsuperscript{3}}
  \newunit{\Molar}{\textsc{m}}
  \newunit{\molar}{\mole\unitsep\dm\unitsuperscript{--3}}
  \newunit{\mmHg}{mm\unitsep{}Hg}
  \newunit{\mol}{\mole}
\fi
\newcommand{\cmc}{\cubiccentimeter}
\newcommand{\Hz}{\hertz}
%    \end{macrocode}
%\end{macro}
%\end{macro}
%\end{macro}
%\end{macro}
%\end{macro}
%\end{macro}
%\end{macro}
%\begin{macro}{\cst@varnothing}
%\changes{v1.1}{2007/09/17}{New macro}
%\begin{macro}{\standardstate}
% In a very similar vein, the ``standard state'' symbol is handy.
% This is produced by rotating the ``varnothing'' symbol from the
% \textsc{ams} set. Note that the rotation angle here has been
% carefully checked, but is set by eye. The symbol is loaded directly
% here, rather than using the |amssymb| package, to avoid any
% clashes.
%\changes{v1.1c}{2007/09/23}{Definition only occurs if user does not
%  have own version}
%\changes{v1.1c}{2007/09/23}{Altered angle of rotation for better
%  appearance}
%    \begin{macrocode}
\DeclareSymbolFont{CSTAMS}{U}{msb}{m}{n}
\DeclareMathSymbol{\cst@varnothing}{\mathord}{CSTAMS}{"3F}
\providecommand*{\standardstate}%
  {\textsuperscript{\rotatebox[origin=c]{138.8}%
  {\ensuremath{\cst@varnothing}}}}
%    \end{macrocode}
%\end{macro}
%\end{macro}
%
%\subsection{Float formatting}
% The next step is to format the floats correctly. Unfortunately,
% |memoir| does not provide all of the commands needed to achieve
% this.  Thus the |float| package is needed; in order to load it, the
% \cmd{\newfloat} command in |memoir| is killed off.  The
% |chemscheme| package does not load |float| when |memoir| is being
%  used, because creating a new float type is catered for directly
% by |memoir|.  Unfortunately, the |memoir| system isn't flexible
% enough for what is needed by |chemstyle|, so the hard work of
% |chemscheme| is undone here!  For other document classes, |float|
% will already have been loaded by |chemscheme|.
%    \begin{macrocode}
\@ifclassloaded{memoir}
  {\let\newfloat\@undefined
   \RequirePackage{float}}
  {}
%    \end{macrocode}
% The standard float types are now restyled to place the captions
% correctly (for most journals).  Normally in chemical documents
% the author expects the float to be ``here'' if possible; this is
% therefore set as the default.
%    \begin{macrocode}
\floatstyle{plaintop}
\restylefloat{table}
\floatstyle{plain}
\restylefloat{scheme}
\restylefloat{figure}
\floatplacement{table}{htbp}
\floatplacement{scheme}{htbp}
\floatplacement{figure}{htbp}
%    \end{macrocode}
% The contents of floats are centred by default, using the hook
% from the |chemstyle| package.
%    \begin{macrocode}
\floatcontentscentre
%    \end{macrocode}
%
%\subsection{Cross-references}
%\changes{v1.1g}{2007/10/19}{Fixed problem with cross-referencing
%  when \texttt{babel} is not loaded}
% The naming for cross-references is sorted out properly using the
% |varioref| package.
%    \begin{macrocode}
\AtBeginDocument{%
  \labelformat{scheme}{\schemename~#1}}
\labelformat{figure}{\figurename~#1}
\labelformat{table}{\tablename~#1}
%    \end{macrocode}
%
% \subsection{Latin words}
%
%\begin{macro}{\latin}
%\begin{macro}{\cst@latin}
%\changes{v1.1}{2007/09/17}{New macro}
%\begin{macro}{\latinemphon}
%\begin{macro}{\latinemphoff}
% A series of Latin phrases are provided, with a quick switch to
% print them in Roman letters if needed.  A mechanism is needed
% to alter the effect of the \cmd{\latin} command \emph{only}
% if the user does not have their own version.  This is achieved
% here, with precautions taken to ensure the user can define
% their own \cmd{\latin} command \emph{after} loading |chemstyle|
% and still have everything work properly.
%    \begin{macrocode}
\let\latinemphon\relax
\let\latinemphoff\relax
\let\cst@latin\relax
\ifcst@phrases
  \newcommand{\latinemphon}{\let\cst@latin\emph}
  \newcommand{\latinemphoff}{\let\cst@latin\relax}
  \AtBeginDocument{%
    \providecommand\latin{\cst@latin}
  }
\fi
\latinemphon
%    \end{macrocode}
%\end{macro}
%\end{macro}
%\end{macro}
%\end{macro}
%
% In ACS journals, the abbreviations ``\eg'' and ``\ie'' are always
% followed by a comma.  In order to provide an automated way to do
% this, a series of macros are needed to test the punctuation
% trailing the macro names.  Firstly, a switch is provided for the
% journal style files.
%    \begin{macrocode}
\newif  \ifcst@comma    \cst@commafalse
%    \end{macrocode}
% The implementation of the testing code is delayed until the
% beginning of the document to allow the switching to occur.  First
% the case where a comma is needed is handled.
%    \begin{macrocode}
\AtBeginDocument{%
  \ifcst@comma
%    \end{macrocode}
%\begin{macro}{\cst@punct}
% The \cmd{\cst@punct} macro holds the comma-containing punctuation
% to be added.
%    \begin{macrocode}
    \def\cst@punct{.,\cst@xspace}
%    \end{macrocode}
%\end{macro}
%\begin{macro}{\cst@addpunct}
%\changes{v1.1}{2007/09/17}{New macro}
%\changes{v1.1f}{2007/10/14}{No longer used when comma not required}
%\begin{macro}{\cst@add@punct}
%\changes{v1.1}{2007/09/17}{New macro}
%\begin{macro}{\cst@add@punct@}
%\changes{v1.1}{2007/09/17}{New macro}
% The following macros are very closely based on those in the |cite|
% package used for moving citations after punctuation.  The first
% macro is used as an initial hook.  Notice that \cmd{\relax} is
% essential here, as it provides an argument for \cmd{\cst@add@punct}
% in the first round of checking.
%    \begin{macrocode}
    \def\cst@addpunct{%
      \cst@add@punct\relax%
    }
%    \end{macrocode}
% Here, a plain TeX \cmd{\futurelet} is used to test the next
% character. Notice that this macro takes a single argument, which is
% used to recursively gobble up punctuation.
%    \begin{macrocode}
    \def\cst@add@punct#1{%
      \futurelet\@tempa\cst@add@punct@%
    }
%    \end{macrocode}
% The checking occurs here.  If a match is made, then the process is
% repeated to allow the punctuation to be gobbled.
%    \begin{macrocode}
    \def\cst@add@punct@{%
      \ifx\@tempa.%
        \let\@tempb\cst@add@punct%
      \else
        \ifx\@tempa,%
          \let\@tempb\cst@add@punct%
%    \end{macrocode}
% No match, and so new punctuation is to be added and the loop ended.
%    \begin{macrocode}
        \else
          \let\@tempb\cst@punct%
        \fi
      \fi
      \@tempb%
    }
  \fi
}
%    \end{macrocode}
%\end{macro}
%\end{macro}
%\end{macro}
%
%\begin{macro}{\cst@xspace}
% The use of |xspace| is optional; this is handled using a package
% option and the internal macro \cmd{\cst@xspace}.
%    \begin{macrocode}
\ifcst@xspace
  \RequirePackage{xspace}
  \let\cst@xspace\xspace
\else
  \let\cst@xspace\relax
\fi
%    \end{macrocode}
%\end{macro}
%
%\begin{macro}{\etc}
%\begin{macro}{\invacuo}
%\begin{macro}{\etal}
%\changes{v1.1f}{2007/10/14}{Fixed problem with full stop spacing}
%\begin{macro}{\eg}
%\changes{v1.1}{2007/09/17}{Adds comma for ACS journals}
%\changes{v1.1f}{2007/10/14}{Fixed problem with full stop spacing}
%\changes{v1.1f}{2007/10/14}{Definition comma-mode dependent}
%\begin{macro}{\ie}
%\changes{v1.1}{2007/09/17}{Adds comma for ACS journals}
%\changes{v1.1f}{2007/10/14}{Fixed problem with full stop spacing}
%\changes{v1.1f}{2007/10/14}{Definition comma-mode dependent}
% For the macros themselves, care is taken about trailing full stops.
% The \cmd{\xspace} command deals with any problems of spacing.
% Things could go wrong with complex punctuation, as no other checks
% are performed.  All of these functions use \cmd{\providecommand}
% to avoid standing on the user's own versions, if they exist.
%    \begin{macrocode}
\ifcst@phrases
  \AtBeginDocument{
    \providecommand{\etc}%
      {\@ifnextchar.{\cst@etc}{\cst@etc.\cst@xspace}}
    \providecommand{\invacuo}%
      {\latin{in vacuo}\cst@xspace}
    \providecommand{\etal}%
      {\@ifnextchar.{\cst@etal}{\cst@etal.\cst@xspace}}
    \ifcst@comma
      \providecommand{\eg}%
        {\cst@eg\cst@addpunct}
      \providecommand{\ie}%
        {\cst@ie\cst@addpunct}
    \else
      \providecommand{\eg}%
        {\@ifnextchar.{\cst@eg}{\cst@eg.\cst@xspace}}
      \providecommand{\ie}%
        {\@ifnextchar.{\cst@ie}{\cst@ie.\cst@xspace}}
    \fi
  }
\fi
%    \end{macrocode}
% \end{macro}
% \end{macro}
% \end{macro}
% \end{macro}
% \end{macro}
%\begin{macro}{\cst@etal}
%\changes{v1.1f}{2007/10/14}{New macro}
%\begin{macro}{\cst@etc}
%\changes{v1.1f}{2007/10/14}{New macro}
%\begin{macro}{\cst@eg}
%\changes{v1.1f}{2007/10/14}{New macro}
%\begin{macro}{\cst@ie}
%\changes{v1.1f}{2007/10/14}{New macro}
% Internal macros are used for items ending in a full stop, to allow
% clean handling of spacing.  Notice that \cmd{\ie} and \cmd{\eg}
% cannot come at the end of a sentence, they are designed to give
% only an inter-word space.
%    \begin{macrocode}
\def\cst@etal{\latin{et~al}}
\def\cst@etc{\latin{etc}}
\def\cst@ie{\latin{i.e\spacefactor999\relax}}
\def\cst@eg{\latin{e.g\spacefactor999\relax}}
%    \end{macrocode}
%\end{macro}
%\end{macro}
%\end{macro}
%\end{macro}
%
% \subsection{Handling section naming}
%
% First, a new if is needed to differentiate between ``Notes and
% References'' and ``References and Notes.''
%    \begin{macrocode}
\newif  \ifcst@notesbefore  \cst@notesbeforetrue
%    \end{macrocode}
% \begin{macro}{\cst@name@refs}
% To keep life simple in the main macro, and to save on redundant
% code, the ordering of ``Notes,'' ``and'' and ``References'' is
% handled here.
%    \begin{macrocode}
\def\cst@name@refs#1#2#3{%
  \ifcst@notesbefore
    #3\space#2\space#1%
  \else
    #1\space#2\space#3%
  \fi
}
%    \end{macrocode}
% \end{macro}
% \begin{macro}{\cst@language}
% The default language of the document is probably English.  However,
% this is alterable if needed, as it is not set in stone.
% Anyone needing to mess with this is probably happy using
% \cmd{\makeatletter}, so the command is kept out of user space.
%    \begin{macrocode}
\def\cst@language{english}
%    \end{macrocode}
% \end{macro}
% \begin{macro}{\cst@refsection}
%\changes{v1.1g}{2007/10/19}{Changed to use \cs{@ifundefined}}
% The existence of a suitable reference section name command is
% checked here.  Some document classes (\eg\ minimal) may not define
% a suitable command. Assuming that is not the case,
% \cmd{\cst@refsection} is used to store the name of the macro
% holding the references section.
%    \begin{macrocode}
\@ifundefined{refname}{%
  \@ifundefined{bibname}{%
     \PackageWarning{chemstyle}%
       {No bibliography name command defined in document class}%
     \def\cst@namerefs#1#2#3#4{}%
  }{%
     \def\cst@refsection{\bibname}%
  }
}{%
   \def\cst@refsection{\refname}%
}
%    \end{macrocode}
% \end{macro}
% \begin{macro}{\cst@namerefs}
%\changes{v1.1g}{2007/10/19}{Changed to use \cs{@ifundefined}}
% \begin{macro}{\cst@language@check}
% The main macro of the heading-altering section takes four
% arguments, \marg{language}, \marg{references}, \marg{and}
% and \marg{notes}.  The first is the |babel| label for the language
% that the words are four, and the other three parameters and the
% words ``References'', ``and'' and ``Notes'', respectively.
%    \begin{macrocode}
\@ifundefined{cst@namerefs}{%
  \def\cst@namerefs#1#2#3#4{%
    \ifcst@notes%
%    \end{macrocode}
% The non-|babel| version of the function only does anything if the
% language passed in |#1| is the default document language (probably
% English). The check for this needs the macro
% \cmd{\cst@language@check} to get |\ifx| to behave as desired.
%    \begin{macrocode}
      \def\cst@language@check{#1}
      \ifx\cst@language\cst@language@check
        \expandafter\renewcommand\expandafter{\cst@refsection}%
          {\cst@name@refs{#2}{#3}{#4}}%
      \fi
%    \end{macrocode}
% To ensure that things work whether |babel| is loaded or not, a few
% hoops have to be jumped through.  Altering the |babel| strings is
% delayed until the start of the document, in case |babel| is loaded
% after |chemstyle|.  There is also a complication that MikTeX
% defines \cmd{\languagename} even if |babel| is not loaded.  This
% may contain an undesired value, and so the presence of |babel|
% needs to be tested for to avoid strange errors.
%    \begin{macrocode}
      \AtBeginDocument{%
        \@ifpackageloaded{babel}{%
          \expandafter\addto\expandafter{\csname captions#1\endcsname}%
            {\expandafter\renewcommand\expandafter{\cst@refsection}%
            {\cst@name@refs{#2}{#3}{#4}}}%
          \expandafter\selectlanguage\expandafter{\languagename}}
        {}}
    \else%
      \ifx#1\cst@language
        \expandafter\renewcommand\expandafter{\cst@refsection}{#2}%
      \fi
      \AtBeginDocument{%
        \@ifpackageloaded{babel}{%
          \expandafter\addto\expandafter{\csname captions#1\endcsname}%
            {\expandafter\renewcommand\expandafter{\cst@refsection}{#2}}%
          \expandafter\selectlanguage\expandafter{\languagename}}%
        {}}
    \fi%
  }
}{}
%    \end{macrocode}
% \end{macro}
% \end{macro}
% Finally, default names are loaded for a range of languages.  Most
% journals stick to the same words, with only the order changing.
%\changes{v1.1c}{2007/09/23}{Added \texttt{german} alias for
%  \texttt{ngerman}}
%\changes{v1.1c}{2007/09/23}{Added \texttt{frenchb} alias for
%  \texttt{french}}
%    \begin{macrocode}
\cst@namerefs{english}{References}{and}{Notes}
\cst@namerefs{UKenglish}{References}{and}{Notes}
\cst@namerefs{ngerman}{Literatur}{und}{Notizen}
\cst@namerefs{german}{Literatur}{und}{Notizen}
\cst@namerefs{french}{R\'ef\'erences}{et}{Notes}
\cst@namerefs{frenchb}{R\'ef\'erences}{et}{Notes}
%    \end{macrocode}
%
% \subsection{Loading the style definition}
%
% The style definition is loaded here, once else  everything is in
% place.  A style must be loaded, so a default is provided to be on
% the safe side.  The journal style file must have extension
% |.jdf|.
%\changes{v1.1b}{2007/09/19}{Load \texttt{caption} even when
%  journal style does not exist}
%    \begin{macrocode}
\ifx\cst@option\relax
  \PackageWarning{chemstyle}
    {You didn't say which style to use \MessageBreak
     Defaulting to the ``no change'' style: none}
  \def\cst@option{none}
\fi
\InputIfFileExists{\cst@option.jdf}
  {\PackageInfo{chemstyle}
    {Loaded \cst@option.jdf}}
  {\PackageWarning{chemstyle}
    {Required style \cst@option\space does not exist}}
%    \end{macrocode}
% \iffalse
%</package>
% \fi
%
% \section{Configuration files}
%
% Each journal style needs slightly differing commands to get the
% formatting just right.  This is handled here, with each style in
% a separate file.  There is not a lot happening in most of these
% files, as the information is by its nature quite repetitive.
%
% \iffalse
%<*rsc>
% \fi
%
% \subsection{RSC style}
%\changes{v1.0b}{2007/09/04}{Sorted a problem with \texttt{babel}
% and figure name format}
%\changes{v1.0b}{2007/09/04}{Fixed formatting of alkyls}
%\changes{v1.1}{2007/09/17}{Fixed (another) error in alkyl formatting}
%    \begin{macrocode}
\ProvidesFile{rsc.jdf}[2007/10/31 v1.1h]
\AtBeginDocument{%
  \renewcommand{\figurename}{Fig.}}
\captionsetup{labelsep=quad,labelfont=bf}
\let\cst@emph\emph
\def\cst@hyph{-}
\let\cst@super\relax
\cst@prefixtrue
\latinemphon
\cst@commafalse
%    \end{macrocode}
% \iffalse
%</rsc>
%<*angew>
% \fi
%
%\subsection{\emph{Angew.~Chem.}~style}
%\changes{v1.0a}{2007/08/23}{Fixed incorrect Latin formatting for
%  \texttt{angew} option}
%    \begin{macrocode}
\ProvidesFile{angew.def}[2007/10/31 v1.1h]
\captionsetup{labelsep=period,labelfont={bf,it},font=sf,singlelinecheck=off}
\captionsetup[table]{labelsep=colon}
\let\cst@emph\emph
\def\cst@hyph{}
\let\cst@super\relax
\cst@prefixtrue
\latinemphoff
\cst@commafalse
%    \end{macrocode}
% \iffalse
%</angew>
%<*jomc>
% \fi
%
%\subsection{\emph{J.~Organomet.~Chem.}~style}
%\changes{v1.1g}{2007/10/19}{Added \texttt{jomc} style}
%    \begin{macrocode}
\ProvidesFile{jomc.def}[2007/10/31 v1.1h]
\captionsetup{labelsep=period}
\captionsetup[table]{labelsep=newline,singlelinecheck=off}
\AtBeginDocument{%
  \renewcommand{\figurename}{Fig.}}
\let\cst@emph\emph
\def\cst@hyph{}
\let\cst@super\textsuperscript
\cst@prefixtrue
\latinemphoff
\cst@commafalse
%    \end{macrocode}
% \iffalse
%</jomc>
%<*tetlett>
% \fi
%
%\subsection{\emph{Tetrahedron Lett.}~style}
%\changes{v1.1h}{2007/10/31}{Added \texttt{tetlett} style}
%    \begin{macrocode}
\ProvidesFile{tetlett.def}[2007/10/31 v1.1h]
\captionsetup{labelsep=period,singlelinecheck=off,labelfont=bf}
\let\cst@emph\emph
\def\cst@hyph{-}
\let\cst@super\relax
\cst@prefixtrue
\latinemphoff
\cst@commatrue
%    \end{macrocode}
% \iffalse
%</tetlett>
%<*jacs>
% \fi
%
%\subsection{\emph{J.~Am.~Chem.~Soc.}~style}
%    \begin{macrocode}
\ProvidesFile{jacs.jdf}[2007/10/31 v1.1h]
\DeclareCaptionLabelSeparator{perquad}{.\quad}
\captionsetup{labelfont={bf,it,sf},textfont=sf,labelsep=perquad}
\captionsetup[figure]{textfont=rm}
\captionsetup{singlelinecheck=off}
\let\cst@emph\emph
\def\cst@hyph{}
\let\cst@super\textsuperscript
\cst@prefixtrue
\floatstyle{plaintop}
\restylefloat{scheme}
\floatstyle{plain}
\latinemphoff
\cst@notesbeforefalse
\cst@commatrue
%    \end{macrocode}
% \iffalse
%</jacs>
%<*ic>
% \fi
%
%\subsection{\emph{Inorg.~Chem.}~style}
% Almost exactly the same as for \emph{J.~Am.~Chem.~Soc.}, so most of
% the work is left to |jacs.jdf|.
%    \begin{macrocode}
\ProvidesFile{ic.jdf}[2007/10/31 v1.1h]
\input {jacs.jdf}
\captionsetup{textfont=rm}
%    \end{macrocode}
%\iffalse
%</ic>
%<*jpc>
%\fi
%
%\subsection{\emph{J.~Phys.~Chem.}~style}
%\changes{v1.0a}{2007/08/23}{Added \emph{J.~Phys.~Chem.}~style}
%    \begin{macrocode}
\ProvidesFile{jpc.jdf}[2007/10/31 v1.1h]
\DeclareCaptionFormat{labelcaps}{\MakeUppercase{#1}#2#3}
\captionsetup{font=bf,labelsep=colon,format=labelcaps}
\captionsetup[figure]{format=plain,textfont=md,labelsep=period}
\captionsetup{singlelinecheck=off}
\let\cst@emph\emph
\def\cst@hyph{}
\let\cst@super\textsuperscript
\cst@prefixtrue
\floatstyle{plaintop}
\restylefloat{scheme}
\floatstyle{plain}
\latinemphoff
\cst@notesbeforefalse
\cst@commatrue
%    \end{macrocode}
%\iffalse
%</jpc>
%<*orglett>
% \fi
%
%\subsection{\emph{Org.~Lett.}~style}
%\changes{v1.0a}{2007/08/23}{Added \emph{Org.~Lett.}~style}
%    \begin{macrocode}
\ProvidesFile{orglett.jdf}[2007/10/31 v1.1h]
\RequirePackage{xcolor}
%    \end{macrocode}
%\begin{macro}{\OrgLettColour}
% To allow the user to control the colour of the ``bars'' in this
% style, an additional macro is provided.  The |purple| colour looks
% about right for matching the printed journal, but if anyone has a
% better suggestion please let the package author know.
%    \begin{macrocode}
\newcommand*{\OrgLettColour}{purple}
%    \end{macrocode}
%\end{macro}
% In order to get the distinctive coloured bars used by
% \emph{Org.~Lett.}, a new style for floats is needed.  This is based
% on the |ruled| style from the |float| package.
%    \begin{macrocode}
\newcommand\fs@orglett{\def\@fs@cfont{\bfseries}
  \let\@fs@capt\floatc@ruled
  \def\@fs@pre{\begingroup\color{\OrgLettColour}
    \hrule height12pt depth0pt \kern2pt\endgroup}%
%    \end{macrocode}
% This is the same \cmd{\@fs@mid} as is used in the |float| package
% for |plaintop| floats.
%    \begin{macrocode}
  \def\@fs@mid{\vspace\belowcaptionskip\relax}%
  \def\@fs@post{\begingroup\color{\OrgLettColour}\kern2pt
    \hrule height1.5pt depth0pt\endgroup}%
  \let\@fs@iftopcapt\iftrue}
%    \end{macrocode}
% Figures need to be slightly different, so an almost identical
% command is needed.
%    \begin{macrocode}
\newcommand\fs@orglettfig{\def\@fs@cfont{\bfseries}
  \let\@fs@capt\floatc@plain
  \def\@fs@pre{\begingroup\color{\OrgLettColour}
    \hrule height12pt depth0pt \kern2pt\endgroup}%
  \def\@fs@mid{\vspace\abovecaptionskip\relax}%
  \def\@fs@post{\begingroup\color{\OrgLettColour}\kern2pt
    \hrule height1.5pt depth0pt\endgroup}%
  \let\@fs@iftopcapt\iffalse}
%    \end{macrocode}
% The new style is now applied.  Users can change back to normal
% floats by changing back to the |plain| style.
%    \begin{macrocode}
\floatstyle{orglettfig}
\restylefloat{figure}
\floatstyle{orglett}
\restylefloat{scheme}
\restylefloat{table}
%    \end{macrocode}
% The more usual style commands now occur.
%    \begin{macrocode}
\DeclareCaptionLabelSeparator{perquad}{.\quad}
\captionsetup{labelfont=bf,labelsep=perquad}
\let\cst@emph\emph
\def\cst@hyph{}
\let\cst@super\textsuperscript
\cst@prefixtrue
\latinemphoff
\cst@notesbeforefalse
\cst@commatrue
%    \end{macrocode}
% \iffalse
%</orglett>
%<*none>
%\fi
%
%\subsection{The empty style --- none}
% To allow the user to load the extra macros provided here without
% any style changes, a ``do nothing'' style is provided.  It simply
% makes sure that very little changes compared to the LaTeX kernel.
% This requires undoing the defaults provided above.  For commands
% where a default is needed (\eg\ the \cmd{\latin} command) the style
% of the RSC is followed.  As the |float| package has been loaded,
% notice that captions will be placed below floats even if the
% \cmd{\caption} command appears above the contents of the floating
% environment.
%
%    \begin{macrocode}
\ProvidesFile{none.jdf}[2007/10/31 v1.1h]
\floatstyle{plain}
\restylefloat{table}
\labelformat{scheme}{#1}
\labelformat{figure}{#1}
\labelformat{table}{#1}
\floatplacement{table}{tbp}
\floatplacement{scheme}{tbp}
\floatplacement{figure}{tbp}
%    \end{macrocode}
% \iffalse
%</none>
% \fi
% \PrintChanges
% \PrintIndex
% \Finale
%\iffalse
%<*jawltxdoc>
% The following is convenient method for collecting together package
% loading, formatting commands and new macros used to format |dtx|
% files written by the current author.  It is based on the similar
% files provided by Will Robertson in his packages and Heiko Oberdiek
% as a stand-alone package.  Notice that it is not intended for other
% users: there is no error checking!  However, it is covered by the
% LPPL in the same way as the rest of this package.
%
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{jawltxdoc}
  [2007/10/14 v1.0b]
% First of all, a number of support packages are loaded.
\usepackage[T1]{fontenc}
\usepackage[english,UKenglish]{babel}
\usepackage[scaled=0.95]{helvet}
\usepackage[version=3]{mhchem}
\usepackage[final]{microtype}
\usepackage[osf]{mathpazo}
\usepackage{booktabs,array,url,graphicx,courier,unitsdef}
\usepackage{upgreek,ifpdf,listings}
% If using PDFLaTeX, the source will be attached to the PDF. This
% is basically the system used by Heiko Oberdiek, but with a check
% that PDF mode is enabled.
\ifpdf
  \usepackage{embedfile}
  \embedfile[%
    stringmethod=escape,%
    mimetype=plain/text,%
    desc={LaTeX docstrip source archive for package `\jobname'}%
    ]{\jobname.dtx}
\fi
\usepackage{\jobname}
\usepackage[numbered]{hypdoc}
%
% To typeset examples, a new environment is needed.  The code below
% is based on that in used by |listings|, but is modified to get
% better formatting for this context.  The formatting of the output
% is basically that in Will Robertson's |dtx-style| file.
\newlength\LaTeXwidth
\newlength\LaTeXoutdent
\newlength\LaTeXgap
\setlength\LaTeXgap{1em}
\setlength\LaTeXoutdent{-0.15\textwidth}
\def\typesetexampleandcode{%
  \begin{list}{}{%
    \setlength\itemindent{0pt}
    \setlength\leftmargin\LaTeXoutdent
    \setlength\rightmargin{0pt}
  }
  \item
    \setlength\LaTeXoutdent{-0.15\textwidth}
    \begin{minipage}[c]{\textwidth-\LaTeXwidth-\LaTeXoutdent-\LaTeXgap}
      \lst@sampleInput
    \end{minipage}%
    \hfill%
    \begin{minipage}[c]{\LaTeXwidth}%
      \hbox to\linewidth{\box\lst@samplebox\hss}%
    \end{minipage}%
  \end{list}
}
\def\typesetcodeandexample{%
  \begin{list}{}{%
    \setlength\itemindent{0pt}
    \setlength\leftmargin{0pt}
    \setlength\rightmargin{0pt}
  }
  \item
    \begin{minipage}[c]{\LaTeXwidth}%
      \hbox to\linewidth{\box\lst@samplebox\hss}%
    \end{minipage}%
    \lst@sampleInput
  \end{list}
}
\def\typesetfloatexample{%
  \begin{list}{}{%
    \setlength\itemindent{0pt}
    \setlength\leftmargin{0pt}
    \setlength\rightmargin{0pt}
  }
  \item
    \lst@sampleInput
    \begin{minipage}[c]{\LaTeXwidth}%
      \hbox to\linewidth{\box\lst@samplebox\hss}%
    \end{minipage}%
  \end{list}
}
\def\typesetcodeonly{%
  \begin{list}{}{%
    \setlength\itemindent{0pt}
    \setlength\leftmargin{0pt}
    \setlength\rightmargin{0pt}
  }
  \item
    \begin{minipage}[c]{\LaTeXwidth}%
      \hbox to\linewidth{\box\lst@samplebox\hss}%
    \end{minipage}%
  \end{list}
}
\edef\LaTeXexamplefile{\jobname.tmp}
\lst@RequireAspects{writefile}
\newbox\lst@samplebox
\lstnewenvironment{LaTeXexample}[1][\typesetexampleandcode]{%
  \let\typesetexample#1
  \global\let\lst@intname\@empty
  \setbox\lst@samplebox=\hbox\bgroup
  \setkeys{lst}{language=[LaTeX]{TeX},tabsize=4,gobble=2,%
    breakindent=0pt,basicstyle=\small\ttfamily,basewidth=0.51em,%
    keywordstyle=\color{blue},%
% Notice that new keywords should be added here. The list is simply
% macro names needed to typeset documentation of the package
% author.
    morekeywords={bibnote,citenote,bibnotetext,bibnotemark,%
      thebibnote,bibnotename,includegraphics,schemeref,%
      floatcontentsleft,floatcontentsright,floatcontentscentre,%
      schemerefmarker,compound,schemerefformat,color,%
      startchemical,stopchemical,chemical,setupchemical,bottext,%
      listofschemes}}
  \lst@BeginAlsoWriteFile{\LaTeXexamplefile}
}{%
  \lst@EndWriteFile\egroup
  \setlength\LaTeXwidth{\wd\lst@samplebox}
  \typesetexample%
}
\def\lst@sampleInput{%
  \MakePercentComment\catcode`\^^M=10\relax
  \small%
  {\setkeys{lst}{SelectCharTable=\lst@ReplaceInput{\^\^I}%
    {\lst@ProcessTabulator}}%
    \leavevmode \input{\LaTeXexamplefile}}%
  \MakePercentIgnore%
}
\hyphenation{PDF-LaTeX}
%</jawltxdoc>
%\fi