% \iffalse meta-comment
%
% Copyright (C) 2006-2008 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.3c or later is part of all distributions of
% LaTeX version 2005/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 rsc.dtx
%                 and the derived files rsc.ins,
%                                       rsc.sty,
%                                       rsc.pdf,
%                                       rsc.bst,
%                                       rscM.bst
%                                       rscnat.bst,
%                                       rsc-mc.bst,
%                                       angew.bst,
%                                       angeM.bst
%                                       angewnat.bst,
%                                       angew-mc.bst and
%                                       jawltxdoc.sty
% Unpacking:
%    (a) If achemso.ins is present:
%           tex rsc.ins
%    (b) Without achemso.ins:
%           tex rsc.dtx
%    (c) If you use LaTeX to generate files:
%           latex \let\install=y\input{rsc.dtx}
%
% Documentation:
%    (a) Without write18 enabled:
%          pdflatex rsc.dtx
%          makeindex -s gglo.ist -o rsc.gls  rsc.glo
%          pdflatex rsc.dtx
%          makeindex -s gglo.ist -o rsc.gls  rsc.glo
%          pdflatex rsc.dtx
%    (b) With write18 enabled:
%          pdflatex rsc.dtx
%          pdflatex rsc.dtx
%          pdflatex rsc.dtx
%
% Installation:
%     Copy rsc.sty and the *.bst files 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 rsc package - BibTeX support for Royal Society of Chemistry
 and Wiley style article
 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 achemso files:}
\usedir{tex/latex/contib/rsc}
\generate{\file{\jobname.ins}{\from{\jobname.dtx}{install}}
          \file{\jobname.sty}{\from{\jobname.dtx}{package}}
          \file{jawltxdoc.sty}{\from{\jobname.dtx}{jawltxdoc}}
}
\declarepostamble\bibtexable
\endpostamble
\usedir{bibtex/bst/rsc}
\generate{\usepostamble\bibtexable
          \file{rsc.bst}{\from{rsc.dtx}{bib,rsc}}
          \file{rscnat.bst}{\from{rsc.dtx}{bib,rsc,nat}}
          \file{rsc-mc.bst}{\from{rsc.dtx}{bib,rsc,mc}}
          \file{angew.bst}{\from{rsc.dtx}{bib,angew}}
          \file{angewnat.bst}{\from{rsc.dtx}{bib,angew,nat}}
          \file{angew-mc.bst}{\from{rsc.dtx}{bib,angew,mc}}
}
\generate{\usepostamble\bibtexable
          \file{rscM.bst}{\from{rsc.dtx}{bib,rsc,mcp}}
          \file{angewM.bst}{\from{rsc.dtx}{bib,angew,mcp}}
          \file{rscnatM.bst}{\from{rsc.dtx}{bib,rsc,nat,mcp}}
          \file{angewnatM.bst}{\from{rsc.dtx}{bib,angew,nat,mcp}}
}
\endbatchfile
%</install>
%<*ignore>
\fi
% Will Robertson's trick
\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{42}
%
% \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{v2.1}{2007/08/05}{Moved float centring to
%  \pkg{chemscheme} package}
%\changes{v2.0}{2007/07/21}{Complete re-write of float support}
%\changes{v2.0}{2007/07/21}{General tidying of code}
%\changes{v1.0}{2006/11/08}{Initial release of packaged rsc.bst}
%\changes{v2.1a}{2007/08/24}{Fixed error in \BibTeX\ misc output}
%\changes{v2.2}{2007/10/16}{Added \textsc{url} support to
%  \texttt{Misc} field}
%\changes{v2.2}{2007/10/16}{License change to LPPL}
%\changes{v2.2}{2007/10/16}{Improved packaging}
%\changes{v2.2}{2007/10/16}{\LaTeX\ package converted to stub}
%\changes{v2.2a}{2008/01/16}{Added \pkg{mciteplus} support}
%\changes{v2.2a}{2008/01/16}{Documentation improvements}
%\changes{v2.2b}{2008/01/16}{Added combined \pkg{mciteplus} and
%  \pkg{natbib} support}
%
%\DoNotIndex{}
%
%\title{The \currpkg\ package --- \texorpdfstring{\BibTeX}{BibTeX}
%  support for Royal Society of Chemistry and Wiley style articles^^A
%  \thanks{This file describes version \fileversion, last revised
%    \filedate.}}
%\author{Joseph Wright^^A
%  \thanks{E-mail: joseph.wright@morningstar2.co.uk}}
%\date{Released \filedate}
%
%\maketitle
%
%\begin{abstract}
% The \currpkg package provides \BibTeX\ style files to produce
% bibliographies in accordance with the guidelines of the Royal
% Society of Chemistry and Wiley chemistry-related journals.  The
% style files are available in versions for the standard \LaTeX\
% citation methods and for use with \pkg{natbib}.  Versions for use
% with \pkg{mcite} and \pkg{mciteplus} are also available.
%\end{abstract}
%
%\section{Introduction}
% Although synthetic chemists do not, in the main, use \LaTeX\ for
% the preparation of journal articles, it would be nice to be able to
% use it for reports.  The package \pkg{achemso} provides for a
% \BibTeX\ style and other support for reports in the style of the
% American Chemical Society.  The aim of the \currpkg package is to
% provide similar support for the style favoured by the Royal Society
% of Chemistry.  The package also provides support for the style used
% in Wiley-published journals.
%
% The \ext{bst} files are available in a number of variations.  Those
% for RSC journals are names \file{rsc\meta{id}.bst}, those for Wiley
% journals are \file{angew\meta{id}.bst}.  The value of \meta{id} can
% be:
%\begin{itemize}
%  \item \meta{(none)} For use with standard \LaTeX\ citations (or
%    the \pkg{cite} package;
%  \item \meta{nat} \pkg{natbib}-compatible styles (which need the
%    \opt{numbers,super} options with \pkg{natbib};
%  \item \meta{M} Designed for use with the \pkg{mciteplus} package;
%  \item \meta{natM} Combine \pkg{mciteplus} and \pkg{natbib} support;
%  \item \meta{-mc} For use with the \pkg{mcite} package, and provided
%    for back-compatibility only.
%\end{itemize}
%
% For backward-compatibility the package provides the
% \file{rsc.sty} file. This has been superseded by the
% \pkg{chemstyle} package, and may be dropped in a future version of
% \pkg{rsc}.
%
%\section{Bibliography design decisions}
% Along with almost every \BibTeX\ style file, much of the \ext{bst}
% file design is inherited from the original \BibTeX\ style files
% provided by Oren Patashnik.  However, while the original styles
% were designed to be flexible, the style files here are designed to
% do a single job.  Thus much of the original flexibility has been
% stripped out to give a clearer design. This has many be achieved by
% removing unused functions.  The style files provided here are
% therefore poor examples for others to work from!
%
% Chemistry journals give only minimal guidance on the format of
% references other than for journal articles. Most of the
% other types are therefore based on current practice in
% RSC and Wiley journals. Some of this is contradictory, and so
% I have gone with I feel is most consistent.
% Please e-mail me if you feel I have got things wrong!
%
%\section{Bibliography usage information}
%\subsection{Cross-references}
% Unlike most \BibTeX\ styles, the style files provided here do not
% support cross-referencing between references. Using \opt{crossref}
% will still fill in missing information, but will not output ``see
% ref.~X''.  Chemistry references do not lend themselves to the use
% of \opt{crossref}.
%
%\subsection{Notes}
% As in \file{pccp.bst}, notes are not output for most reference
% types. The reasoning here is that it is difficult to predict how
% people will want to use notes.  In chemistry, they may be used in
% several forms, for example:
%\begin{itemize}
%   \item See for example: I. V. Gostunskaya, V. S. Petrova, A. I.
%   Leonava, V. A. Mironava, M. Abubaker, and B. Kazanski,
%   \emph{Neftekhimiya}, 1967, \textbf{7}, 3--8.
%   \item I. V. Gostunskaya, V. S. Petrova, A. I. Leonava, V. A.
%   Mironava, M. Abubaker, and B. Kazanski, \emph{Neftekhimiya}, 1967,
%   \textbf{7}, 3--8 and references therein.
%   \item I. V. Gostunskaya, V. S. Petrova, A. I. Leonava, V. A.
%   Mironava, M. Abubaker, and B. Kazanski, \emph{Neftekhimiya}, 1967,
%   \textbf{7}, 3--8 (\emph{Chem. Abs.}, 1967, \textbf{67}, 21276t).
%\end{itemize}
% This is pretty much impossible to handle automatically, especially as
% the format you want might change depending on the report you are
% writing.  So I would recommend using the |misc| type, and doing the
% formatting by hand.  If other people feel the behaviour is not the
% best solution, please e-mail me.
%
%\subsection{Multiple citations}
% By default, \BibTeX\ does not handle producing compound references.
% The \pkg{mciteplus} package solves this problem, and is highly
% recommended to users of \currpkg.  This allows you to put something
% like:
%\begin{LaTeXexample}[\typesetcodeonly]
%  \documentclass{article}
%  \usepackage{mciteplus}
%  \begin{document}
%  \cite{Ofele1968,*Abernethy2000}
%  \bibliography{example}
%  \bibliographystyle{rscM}
%  \end{document}
%\end{LaTeXexample}
% and get output of the form:
%\begin{enumerate}
%  \item (\emph{a}) K.~\"Ofele, \emph{J.~Organomet.~Chem.}, 1968,
%    \textbf{12}, P42--P43; (\emph{b}) C.~D.~Abernethy, A.~H.~Cowley
%    and R.~A.\ Jones, \emph{J.~Organomet.~Chem.}, 2000,
%    \textbf{596}, 3--5.
%\end{enumerate}
% in the bibliography.
%
% Previous versions of \currpkg recommended the \pkg{mcite} package
% for compound citations.  With the release of \pkg{mciteplus},
% \pkg{mcite} is superseded for this
% purpose.\footnote{\pkg{mciteplus} fixes a number of bugs in
% \pkg{mcite} and adds the ability to add labels to each compound
% reference.}  However, \currpkg continues to provide the
% \file{rsc-mc} and \file{angew-mc} \BibTeX\ styles for users of
% \pkg{mcite}.
%
%\subsection{\pkg{natbib} support}
% The files \file{rscnat.bst} and \file{angewnat.bst} provide support
% for the generation of bibliographies for use with the \pkg{natbib}
% package. As well as altering the \cs{bibliographystyle} command
% appropriately, you also need to load \pkg{natbib}.  The \currpkg
% package file provides the option \opt{natbib}, which loads
% \pkg{natbib} automatically (normally, \currpkg loads the \pkg{cite}
% package).
%
%\subsection{Additional entry types}
% In order to ensure compatibility with the \pkg{achemso} package,
% the non-standard entry types |remark|, |inpress| and |submitted|
% are supported.  The implementation is modelled on
% \file{achemso.bst}, but the |notes| field is not used for |inpress|
% and |submitted|.
%
%\StopEventually{}
%
% \iffalse
%<*package>
% \fi
%\section{The package code}
%\subsection{Setup code}
% First of all, the package identifies itself.
%    \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{rsc}[2008/01/16 v2.2b
  Useful chemistry functions]
%    \end{macrocode}
% A warning is given that the package has been superseded.
%    \begin{macrocode}
\PackageInfo{rsc}{The rsc package has been superseded!}
%    \end{macrocode}
% Various options from the original package have to
% be processed correctly.
%    \begin{macrocode}
\DeclareOption{floatleft}{\AtEndOfPackage{\floatcontentsleft}}
\DeclareOption{fl}{\ExecuteOptions{floatleft}}
\DeclareOption{natbib}{\AtEndOfPackage{%
  \RequirePackage[numbers,sort&compress,super]{natbib}}}
%    \end{macrocode}
% The default option is \opt{rsc}.  This loads \pkg{chemstyle} with
% the appropriate option, then alters the bibliography format and
% reports back to the user.
%    \begin{macrocode}
\DeclareOption{rsc}{%
  \PassOptionsToPackage{\CurrentOption}{chemstyle}%
  \def\@biblabel#1{#1}%
  \PackageInfo{rsc}%
    {Loading the chemstyle package with the `rsc' option}%
}
%    \end{macrocode}
% The other possible journal style is |angew|.  Once again,
% |chemstyle| is loaded and information is given.  A bit of
% re-formatting of citations is then carried out as the |chemstyle|
% package does not do this.
%    \begin{macrocode}
\DeclareOption{angew}{%
  \PassOptionsToPackage{\CurrentOption}{chemstyle}%
  \PackageInfo{rsc}%
    {Loading the chemstyle package with the `angew' option}%
  \AtBeginDocument{%
    \@ifpackageloaded{natbib}
      {\renewcommand*\NAT@open{[}\renewcommand*\NAT@close{]}}
      {\def\@citess#1{\textsuperscript{[#1]}}}
  }
}
%    \end{macrocode}
% Anything else is passed to \pkg{chemstyle}.
%    \begin{macrocode}
\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{chemstyle}}
%    \end{macrocode}
% The \currpkg option is the default.
%    \begin{macrocode}
\ExecuteOptions{rsc}
\ProcessOptions\relax
%    \end{macrocode}
% \pkg{chemstyle} can now be loaded.
%    \begin{macrocode}
\RequirePackage{chemstyle}
\floatcontentscentre
%    \end{macrocode}
% If \pkg{natbib} is not loaded, then \pkg{cite} is needed.
%    \begin{macrocode}
\AtEndOfPackage{
  \@ifpackageloaded{natbib}{}
    {\RequirePackage[super]{cite}}
}
%    \end{macrocode}
%
% \iffalse
%</package>
% \fi
%\section{The \texorpdfstring{\BibTeX}{BibTeX} style files}
% A great deal of the \BibTeX\ style file information is lifted more
% or less directly from the standard style files, the
% \pkg{custom-bib} package or \emph{Taming the BeaST}.  The rest
% consists of minor edits to obtain the correct format or support the
% \pkg{natbib}, \pkg{mcite} and \pkg{mciteplus} packages.  Only two
% functions are novel to this package, and are given here for the
% interested reader.
%
% \iffalse
%<*bib>
%    \begin{macrocode}
ENTRY
  { address
    author
    booktitle
    chapter
    doi
    edition
    editor
    howpublished
    institution
    journal
%<nat>     key
    note
    number
    organization
    pages
    publisher
    school
    series
    title
    type
    url
    volume
    year
  }
  {}
%<!nat>  { label }
%<*nat>
  { label
    extra.label
    short.list
  }
%</nat>

INTEGERS { output.state before.all mid.sentence after.sentence }
INTEGERS { after.block after.item author.or.editor }

FUNCTION {init.state.consts}
{ #0 'before.all :=
  #1 'mid.sentence :=
  #2 'after.sentence :=
  #3 'after.block :=
  #4 'after.item :=
}

FUNCTION {add.comma}
{ ", " * }

STRINGS { s t }

FUNCTION {output.nonnull}
{ 's :=
  output.state mid.sentence =
    { add.comma write$ }
    { output.state after.block =
      { add.comma write$
        newline$
        "\newblock " write$
      }
      { output.state before.all =
          'write$
          { output.state after.item =
            { " " * write$ }
            { add.period$ " " * write$ }
          if$
          }
        if$
        }
      if$
      mid.sentence 'output.state :=
    }
  if$
  s
}

FUNCTION {output}
{ duplicate$ empty$
    'pop$
    'output.nonnull
  if$
}

FUNCTION {output.check}
{ 't :=
  duplicate$ empty$
    { pop$ "Empty " t * " in " * cite$ * warning$ }
    'output.nonnull
  if$
}

%<*!nat>
FUNCTION {output.bibitem}
{ newline$
  "\bibitem{" write$
  cite$ write$
  "}" write$
  newline$
  ""
  before.all 'output.state :=
}

%</!nat>
%<*!mc&!mcp>
FUNCTION {fin.entry}
{ add.period$
  write$
  newline$
}

%</!mc&!mcp>
%<*mc>
FUNCTION {fin.entry}
{ write$
  "\relax" write$
  newline$
  "\relax" write$
}

%</mc>
%<*mcp>
INTEGERS {would.add.period.textlen}
FUNCTION {would.add.period}
{ duplicate$
  add.period$
  text.length$
  'would.add.period.textlen :=
  duplicate$
  text.length$
  would.add.period.textlen =
    { #0 }
    { #1 }
  if$
}

FUNCTION {fin.entry}
{ would.add.period
    { "\relax" * write$ newline$
      "\mciteBstWouldAddEndPuncttrue" write$ newline$
      "\mciteSetBstMidEndSepPunct{\mcitedefaultmidpunct}"
      write$ newline$
      "{\mcitedefaultendpunct}{\mcitedefaultseppunct}\relax"
    }
    { "\relax" * write$ newline$
      "\mciteBstWouldAddEndPunctfalse" write$ newline$
      "\mciteSetBstMidEndSepPunct{\mcitedefaultmidpunct}"
      write$ newline$
      "{}{\mcitedefaultseppunct}\relax"
    }
  if$
  write$
  newline$
  "\EndOfBibitem" write$
}

%</mcp>

FUNCTION {not}
{   { #0 }
    { #1 }
  if$
}

FUNCTION {and}
{   'skip$
    { pop$ #0 }
  if$
}

FUNCTION {or}
{   { pop$ #1 }
    'skip$
  if$
}

FUNCTION {field.or.null}
{ duplicate$ empty$
    { pop$ "" }
    'skip$
  if$
}

FUNCTION {emphasize}
{ duplicate$ empty$
    { pop$ "" }
    { "\emph{" swap$ * "}" * }
  if$
}

FUNCTION {boldface}
{ duplicate$ empty$
    { pop$ "" }
    { "\textbf{" swap$ * "}" * }
  if$
}

FUNCTION {paren}
{ duplicate$ empty$
    { pop$ "" }
    { "(" swap$ * ")" * }
  if$
}

FUNCTION {bbl.and}
{ "and" }

FUNCTION {bbl.chapter}
%<rsc>{ "ch." }
%<angew>{ "Chapter" }

FUNCTION {bbl.editor}
%<rsc>{ "ed." }
%<angew>{ "Ed.:" }

%<angew>FUNCTION {bbl.editors}
%<angew>{ "Eds.:" }

FUNCTION {bbl.edition}
%<rsc>{ "edn." }
%<angew>{ "ed." }

FUNCTION {bbl.etal}
{ "et~al." emphasize }

FUNCTION {bbl.in}
{ "in" }

FUNCTION {bbl.inpress}
{ "in press" }


FUNCTION {bbl.msc}
%<rsc>{ "M.Sc. thesis" }
%<angew>{ "MSc thesis" }

FUNCTION {bbl.page}
{ "p." }

FUNCTION {bbl.pages}
{ "pp." }

FUNCTION {bbl.phd}
%<rsc>{ "Ph.D. thesis" }
%<angew>{ "PhD thesis" }

FUNCTION {bbl.submitted}
{ "submitted for publication" }

FUNCTION {bbl.techreport}
{ "Technical Report" }

FUNCTION {bbl.volume}
%<rsc>{ "vol." }
%<angew>{ "Vol." }

FUNCTION {bbl.first}
{ "1st" }

FUNCTION {bbl.second}
{ "2nd" }

FUNCTION {bbl.third}
{ "3rd" }

FUNCTION {bbl.fourth}
{ "4th" }

FUNCTION {bbl.fifth}
{ "5th" }

FUNCTION {bbl.st}
{ "st" }

FUNCTION {bbl.nd}
{ "nd" }

FUNCTION {bbl.rd}
{ "rd" }

FUNCTION {bbl.th}
{ "th" }

FUNCTION {eng.ord}
{ duplicate$ "1" swap$ *
  #-2 #1 substring$ "1" =
     { bbl.th * }
     { duplicate$ #-1 #1 substring$
       duplicate$ "1" =
         { pop$ bbl.st * }
         { duplicate$ "2" =
             { pop$ bbl.nd * }
             { "3" =
                 { bbl.rd * }
                 { bbl.th * }
               if$
             }
           if$
          }
       if$
     }
   if$
}

%<*angew>
INTEGERS{ l }

FUNCTION{string.length}
{ #1 'l :=
  { duplicate$ duplicate$ #1 l substring$ = not }
    { l #1 + 'l := }
  while$
  pop$ l
}

STRINGS{replace find text}

INTEGERS{find_length}

FUNCTION{find.replace}
{ 'replace :=
  'find :=
  'text :=
  find  string.length 'find_length :=
  ""
  { text empty$ not }
    { text #1 find_length substring$ find =
      { replace *
        text #1 find_length + global.max$ substring$ 'text :=
      }
      { text #1 #1 substring$ *
        text #2 global.max$ substring$ 'text :=
      }
      if$
    }
  while$
}

%</angew>
FUNCTION{is.a.digit}
{ duplicate$ "" =
    {pop$ #0}
    {chr.to.int$ #48 - duplicate$
     #0 < swap$ #9 > or not}
  if$
}

FUNCTION{is.a.number}
{
  { duplicate$ #1 #1 substring$ is.a.digit }
    {#2 global.max$ substring$}
  while$
  "" =
}

FUNCTION {extract.num}
{ duplicate$ 't :=
  "" 's :=
  { t empty$ not }
  { t #1 #1 substring$
    t #2 global.max$ substring$ 't :=
    duplicate$ is.a.number
      { s swap$ * 's := }
      { pop$ "" 't := }
    if$
  }
  while$
  s empty$
    'skip$
    { pop$ s }
  if$
}

FUNCTION {bibinfo.check}
{ swap$
  duplicate$ missing$
    { pop$ pop$
      ""
    }
    { duplicate$ empty$
        {
          swap$ pop$
        }
        { swap$
          pop$
        }
      if$
    }
  if$
}

FUNCTION {convert.edition}
{ extract.num "l" change.case$ 's :=
  s "first" = s "1" = or
    { bbl.first 't := }
    { s "second" = s "2" = or
        { bbl.second 't := }
        { s "third" = s "3" = or
            { bbl.third 't := }
            { s "fourth" = s "4" = or
                { bbl.fourth 't := }
                { s "fifth" = s "5" = or
                    { bbl.fifth 't := }
                    { s #1 #1 substring$ is.a.number
                        { s eng.ord 't := }
                        { edition 't := }
                      if$
                    }
                  if$
                }
              if$
            }
          if$
        }
      if$
    }
  if$
  t
}

FUNCTION {tie.or.space.connect}
{ duplicate$ text.length$ #3 <
    { "~" }
    { " " }
  if$
  swap$ * *
}

FUNCTION {space.connect}
{ " " swap$ * * }

INTEGERS { nameptr namesleft numnames }

FUNCTION {format.names}
{ 's :=
  #1 'nameptr :=
  s num.names$ 'numnames :=
  numnames 'namesleft :=
    { namesleft #0 > }
      { s nameptr "{f.~}{vv~}{ll}{, jj}" format.name$ 't :=
        nameptr #1 >
          { namesleft #1 >
            { add.comma t * }
            { numnames #2 >
              { "" * }
              'skip$
            if$
            t "others" =
              { bbl.etal space.connect }
%<rsc>              { bbl.and space.connect t space.connect }
%<angew>              { add.comma t * }
            if$
            }
          if$
          }
        't
      if$
      nameptr #1 + 'nameptr :=
      namesleft #1 - 'namesleft :=
      }
  while$
}

FUNCTION {format.authors}
{ author empty$
    { "" }
    { #1 'author.or.editor :=
      author format.names }
  if$
}

%    \end{macrocode}
% \fi
% The |strip.comma| function is used to ``unwind''
% the comma added by output.nonnull, so that editors
% in brackets are easy to do.  This is needed for the |angew|
% option.
% \iffalse
%<*angew>
% \fi
%    \begin{macrocode}
FUNCTION {strip.comma}
{ duplicate$
  string.length 'find_length :=
  duplicate$
  find_length #1 - #1 substring$
  "," =
    { #1 find_length #2 - substring$
      " " *
    }
    'skip$
  if$
}

%    \end{macrocode}
% \iffalse
%</angew>
%    \begin{macrocode}
FUNCTION {format.editors}
{ editor empty$
    { "" }
    { #2 'author.or.editor :=
%<*rsc>
      bbl.editor " " * *
      editor format.names
%</rsc>
%<*angew>
      strip.comma
      editor num.names$ #1 >
        { bbl.editors }
        { bbl.editor }
      if$
      " " *
      editor format.names * paren
%</angew>
    }
  if$
}

%    \end{macrocode}
% \fi
%
% |n.separate| is given in the |custom-bib| package.  The following
% function is modified to separate out a number of any length into
% digit groups, \emph{e.g.}~12345 turns into 12\,345, 1234567 in
% 1\,234\,567 but 1234 or a12345 are left alone.
%    \begin{macrocode}
FUNCTION {n.separate.multi}
{ 't :=
  ""
  #0 'numnames :=
%    \end{macrocode}
% This is the key line: the test is that the sting is both
% at least 5 digits long and is an integer.
%    \begin{macrocode}
  t text.length$ #4 > t is.a.number and
    {
      { t empty$ not }
      { t #-1 #1 substring$ is.a.number
          { numnames #1 + 'numnames := }
          { #0 'numnames := }
        if$
        t #-1 #1 substring$ swap$ *
        t #-2 global.max$ substring$ 't :=
        numnames #4 =
          { duplicate$ #1 #1 substring$ swap$
            #2 global.max$ substring$
            "\," swap$ * *
            #1 'numnames :=
          }
          'skip$
        if$
      }
      while$
    }
    { t swap$ * }
  if$
}

%    \end{macrocode}
% \iffalse
%    \begin{macrocode}
FUNCTION {format.bvolume}
{ volume empty$
    { "" }
    { bbl.volume volume tie.or.space.connect }
  if$
}

FUNCTION {format.title.noemph}
{ 't :=
  t empty$
    { "" }
    { t }
  if$
}

FUNCTION {format.title}
{ 't :=
  t empty$
    { "" }
    { t emphasize }
  if$
}

FUNCTION {format.url}
{ url empty$
    { "" }
    { "\url{" url * "}" * }
  if$
}

%<*angew>
FUNCTION {format.title.vol}
{ 't :=
  t empty$
    { "" }
    { t emphasize }
  if$
  volume empty$
    'skip$
    { format.bvolume emphasize
      swap$ add.comma swap$ *
    }
  if$
  }

%</angew>
%<*nat>
FUNCTION {format.full.names}
{'s :=
  #1 'nameptr :=
  s num.names$ 'numnames :=
  numnames 'namesleft :=
    { namesleft #0 > }
    { s nameptr
      "{vv~}{ll}" format.name$ 't :=
      nameptr #1 >
        {
          namesleft #1 >
            { ", " * t * }
            {
              numnames #2 >
                { "," * }
                'skip$
              if$
              t "others" =
                { bbl.etal * }
                { bbl.and space.connect t space.connect }
              if$
            }
          if$
        }
        't
      if$
      nameptr #1 + 'nameptr :=
      namesleft #1 - 'namesleft :=
    }
  while$
}

FUNCTION {author.editor.full}
{ author empty$
    { editor empty$
        { "" }
        { editor format.full.names }
      if$
    }
    { author format.full.names }
  if$
}

FUNCTION {author.full}
{ author empty$
    { "" }
    { author format.full.names }
  if$
}

FUNCTION {editor.full}
{ editor empty$
    { "" }
    { editor format.full.names }
  if$
}

FUNCTION {make.full.names}
{ type$ "book" =
  type$ "inbook" =
  or
    'author.editor.full
    { type$ "proceedings" =
        'editor.full
        'author.full
      if$
    }
  if$
}

FUNCTION {output.bibitem} { newline$
  "\bibitem[" write$
  label write$
  ")" make.full.names duplicate$ short.list =
     { pop$ }
     { * }
   if$
  "]{" * write$
  cite$ write$
  "}" write$
  newline$
  ""
  before.all 'output.state :=
}

%</nat>
FUNCTION {n.dashify} { 't :=
  ""
    { t empty$ not }
    { t #1 #1 substring$ "-" =
    { t #1 #2 substring$ "--" = not
        { "--" *
          t #2 global.max$ substring$ 't :=
        }
        {   { t #1 #1 substring$ "-" = }
        { "-" *
          t #2 global.max$ substring$ 't :=
        }
          while$
        }
      if$
    }
    { t #1 #1 substring$ *
      t #2 global.max$ substring$ 't :=
    }
      if$
    }
  while$
}

FUNCTION {format.date}
{ year empty$
    { "" }
%<rsc>    'year
%<angew>    { year boldface }
  if$
}

FUNCTION {format.bdate}
{ year empty$
    { "There's no year in " cite$ * warning$ }
%<rsc>    'year
%<angew>    { year boldface }
  if$
}

FUNCTION {either.or.check}
{ empty$
    'pop$
    { "Can't use both " swap$ * " fields in " * cite$ * warning$ }
  if$
}

FUNCTION {format.edition}
{ edition duplicate$ empty$
    'skip$
    { convert.edition
      bbl.edition bibinfo.check
      " " * bbl.edition *
    }
  if$
}

INTEGERS { multiresult }

FUNCTION {multi.page.check}
{ 't :=
  #0 'multiresult :=
    { multiresult not
      t empty$ not
      and
    }
    { t #1 #1 substring$
      duplicate$ "-" =
      swap$ duplicate$ "," =
      swap$ "+" =
      or or
        { #1 'multiresult := }
        { t #2 global.max$ substring$ 't := }
      if$
    }
  while$
  multiresult
}

FUNCTION {format.pages}
{ pages empty$
    { "" }
    { pages multi.page.check
      { bbl.pages pages n.dashify tie.or.space.connect }
      { bbl.page pages tie.or.space.connect }
    if$
    }
  if$
}

FUNCTION {format.pages.required}
{ pages empty$
    { ""
      "There are no page numbers for " cite$ * warning$
      output
    }
    { pages multi.page.check
      { bbl.pages pages n.dashify tie.or.space.connect }
      { bbl.page pages tie.or.space.connect }
    if$
    }
  if$
}

FUNCTION {format.pages.nopp}
{ pages empty$
    { ""
      "There are no page numbers for " cite$ * warning$
      output
    }
    { pages multi.page.check
      { pages n.dashify space.connect }
      { pages space.connect }
    if$
    }
  if$
}

FUNCTION {format.pages.patent}
{ pages empty$
    { "There is no patent number for " cite$ * warning$ }
    { pages multi.page.check
      { pages n.dashify }
%<rsc>      { pages n.separate.multi }
%<angew>      { pages }
      if$
    }
  if$
}

FUNCTION {format.vol.pages}
%<rsc>{ volume boldface field.or.null
%<angew>{ volume emphasize field.or.null
  duplicate$ empty$
    { pop$ format.pages.required }
    { add.comma pages n.dashify * }
  if$
}

FUNCTION {format.chapter.pages}
{ chapter empty$
    'format.pages
    { type empty$
    { bbl.chapter }
    { type "l" change.case$ }
      if$
      chapter tie.or.space.connect
      pages empty$
    'skip$
    { add.comma format.pages * }
      if$
    }
  if$
}

FUNCTION {format.title.in}
{ 's :=
%<angew>  after.item 'output.state :=
  s empty$
    { "" }
    { editor empty$
      { bbl.in s format.title space.connect }
      { bbl.in s format.title space.connect
      add.comma format.editors *
      }
    if$
    }
  if$
}

%<*angew>
FUNCTION {format.title.vol.in}
{ 's :=
  after.item 'output.state :=
  s empty$
    { "" }
    { editor empty$
      { bbl.in s format.title.vol space.connect }
      { bbl.in s format.title.vol space.connect
      add.comma format.editors *
      }
    if$
    }
  if$
}

%</angew>
FUNCTION {format.pub.address}
{ publisher empty$
    { "" }
    { address empty$
        { publisher }
        { publisher add.comma address *}
      if$
    }
  if$
}

FUNCTION {empty.misc.check}
{ author empty$ title empty$ howpublished empty$
  year empty$ note empty$ url empty$
  and and and and and
    { "all relevant fields are empty in " cite$ * warning$ }
    'skip$
  if$
}

FUNCTION {empty.doi.note}
{ doi empty$ note empty$ and
    { "Need either a note or DOI for " cite$ * warning$ }
    'skip$
  if$
}

FUNCTION {format.thesis.type}
{ type empty$
    'skip$
    { pop$
      type emphasize
    }
  if$
}

FUNCTION {article}
{ output.bibitem
  format.authors "author" output.check
%<rsc>  journal emphasize "journal" output.check
%<*angew>
  journal "," "" find.replace emphasize
  "journal" output.check
  after.item 'output.state :=
%</angew>
  format.date "year" output.check
  volume empty$
  { ""
    format.pages.nopp output
  }
  { format.vol.pages output }
  if$
  fin.entry
}

FUNCTION {book}
{ output.bibitem
  author empty$
%<rsc>    { title format.title "title" output.check
%<angew>    { title format.title.vol "title" output.check
      editor empty$
        { "Need either an author or editor for " cite$ * warning$ }
        { "" format.editors * "editor" output.check }
      if$
    }
    { format.authors output
      "author and editor" editor either.or.check
%<rsc>      title format.title "title" output.check
%<angew>      title format.title.vol "title" output.check
    }
  if$
  format.pub.address "publisher" output.check
  format.edition output
  format.bdate "year" output.check
%<rsc>  format.bvolume output
  pages empty$
    'skip$
    { format.pages output }
  if$
  fin.entry
}

FUNCTION {booklet}
{ output.bibitem
  format.authors output
  title format.title "title" output.check
  howpublished output
  address output
  format.date output
  fin.entry
}

FUNCTION {inbook}
{ output.bibitem
  author empty$
%<rsc>    { title format.title "title" output.check
%<angew>    { title format.title.vol "title" output.check
      editor empty$
      { "Need at least an author or an editor for " cite$ * warning$ }
      { "" format.editors * "editor" output.check }
    if$
    }
    { format.authors output
%<rsc>      title format.title.in "title" output.check
%<angew>      title format.title.vol.in "title" output.check
    }
  if$
  format.pub.address "publisher" output.check
  format.edition output
  format.bdate "year" output.check
%<rsc>  format.bvolume output
  format.chapter.pages "chapter and pages" output.check
  fin.entry
}

FUNCTION {incollection}
{ output.bibitem
  author empty$
%<rsc>    { booktitle format.title "booktitle" output.check
%<angew>    { booktitle format.title.vol "booktitle" output.check
      editor empty$
        { "Need at least an author or an editor for " cite$ * warning$ }
        { "" format.editors * "editor" output.check }
      if$
    }
    { format.authors output
%<rsc>      booktitle format.title.in "booktitle" output.check
%<angew>      booktitle format.title.vol.in "booktitle" output.check
    }
  if$
  format.pub.address "publisher" output.check
  format.edition output
  format.bdate "year" output.check
%<rsc>  format.bvolume output
  format.chapter.pages "chapter and pages" output.check
  fin.entry
}

FUNCTION {inpress}
{ output.bibitem
  format.authors "author" output.check
  journal emphasize "journal" output.check
  bbl.inpress output
  fin.entry
}

FUNCTION {inproceedings}
{ output.bibitem
  format.authors "author" output.check
%<rsc>  booktitle format.title.noemph "booktitle" output.check
%<angew>  booktitle format.title "booktitle" output.check
  address output
  format.date "year" output.check
  pages empty$
    'skip$
    { format.pages output }
  if$
  fin.entry
}

FUNCTION {manual}
{ output.bibitem
  author empty$
    { organization empty$
      'skip$
      { organization output
        address output
      }
      if$
    }
    { format.authors output }
  if$
%<rsc>  title format.title "title" output.check
%<angew>  title format.title.noemph "title" output.check
  author empty$
    { organization empty$
      { address output }
      'skip$
    if$
    }
    { organization output
      address output
    }
  if$
  format.edition output
  format.date output
  fin.entry
}

FUNCTION {mastersthesis}
{ output.bibitem
  format.authors "author" output.check
%<rsc>  bbl.msc emphasize format.thesis.type output
%<angew>  bbl.msc format.thesis.type output
  school "school" output.check
  address output
  format.date "year" output.check
  fin.entry
}

FUNCTION {misc}
{ output.bibitem
  format.authors output
  title empty$
    'skip$
    { title format.title output }
  if$
  howpublished output
%<rsc>  year output
%<angew>  format.date output
  format.url output
  note output
  fin.entry
  empty.misc.check
}

FUNCTION {patent}
{ output.bibitem
  organization empty$
    { format.authors "author and organization" output.check }
    { author empty$
        { organization }
        {  format.authors organization paren space.connect }
      if$
      "author and organization" output.check
    }
  if$
  journal emphasize "journal" output.check
  format.pages.patent "pages" output.check
  format.date "year" output.check
  fin.entry
}

FUNCTION {phdthesis}
{ output.bibitem
  format.authors "author" output.check
%<rsc>  bbl.phd emphasize format.thesis.type output
%<angew>  bbl.phd format.thesis.type output
  school "school" output.check
  address output
  format.date "year" output.check
  fin.entry
}

FUNCTION {proceedings}
{ output.bibitem
%<rsc>  title format.title.noemph "title" output.check
%<angew>  title format.title "title" output.check
  address output
  format.date "year" output.check
  pages empty$
    'skip$
    { format.pages output }
  if$
  fin.entry
}

FUNCTION {remark}
{ output.bibitem
  note "note" output.check
  fin.entry
}

FUNCTION {submitted}
{ output.bibitem
  format.authors "author" output.check
  bbl.submitted output
  fin.entry
}

FUNCTION {techreport}
{ output.bibitem
  format.authors "author" output.check
  title format.title "title" output.check
  institution
  type empty$
    'bbl.techreport
    'type
  if$
  space.connect
  number empty$
    { "t" change.case$ }
    { number tie.or.space.connect }
  if$
  output
  format.pub.address output
  format.date "year" output.check
  fin.entry
}

FUNCTION {unpublished}
{ output.bibitem
  format.authors "author" output.check
  journal empty$
    'skip$
    { journal emphasize "journal" output.check }
  if$
  doi empty$
    {  note output }
%<*rsc>
    {  format.date output
       "DOI:" doi tie.or.space.connect output
    }
%</rsc>
%<angew>    {  "DOI" doi tie.or.space.connect output }
  if$
  fin.entry
  empty.doi.note
}

FUNCTION {conference} {inproceedings}

FUNCTION {other} {patent}

FUNCTION {default.type} {misc}

MACRO {jan} {"January"}
MACRO {feb} {"February"}
MACRO {mar} {"March"}
MACRO {apr} {"April"}
MACRO {may} {"May"}
MACRO {jun} {"June"}
MACRO {jul} {"July"}
MACRO {aug} {"August"}
MACRO {sep} {"September"}
MACRO {oct} {"October"}
MACRO {nov} {"November"}
MACRO {dec} {"December"}

READ

%<*!nat>
STRINGS { longest.label }

INTEGERS { number.label longest.label.width }

FUNCTION {initialize.longest.label}
{ "" 'longest.label :=
  #1 'number.label :=
  #0 'longest.label.width :=
}

FUNCTION {longest.label.pass}
{ number.label int.to.str$ 'label :=
  number.label #1 + 'number.label :=
  label width$ longest.label.width >
    { label 'longest.label :=
      label width$ 'longest.label.width :=
    }
    'skip$
  if$
}

EXECUTE {initialize.longest.label}

ITERATE {longest.label.pass}

%</!nat>
%<*nat>
INTEGERS { len }

FUNCTION {chop.word}
{ 's :=
  'len :=
  s #1 len substring$ =
    { s len #1 + global.max$ substring$ }
    's
  if$
}

FUNCTION {format.lab.names}
{ 's :=
  s #1 "{vv~}{ll}" format.name$
  s num.names$ duplicate$
  #2 >
    { pop$ bbl.etal space.connect }
    { #2 <
        'skip$
        { s #2 "{ff }{vv }{ll}{ jj}" format.name$ "others" =
            { bbl.etal space.connect }
            { bbl.and space.connect s #2 "{vv~}{ll}" format.name$ space.connect }
          if$
        }
      if$
    }
  if$
}

FUNCTION {author.key.label}
{ author empty$
    { key empty$
        { cite$ #1 #3 substring$ }
        'key
      if$
    }
    { author format.lab.names }
  if$
}

FUNCTION {author.editor.key.label}
{ author empty$
    { editor empty$
        { key empty$
            { cite$ #1 #3 substring$ }
            'key
          if$
        }
        { editor format.lab.names }
      if$
    }
    { author format.lab.names }
  if$
}

FUNCTION {author.key.organization.label}
{ author empty$
    { key empty$
        { organization empty$
            { cite$ #1 #3 substring$ }
            { "The " #4 organization chop.word #3 text.prefix$ }
          if$
        }
        'key
      if$
    }
    { author format.lab.names }
  if$
}

FUNCTION {editor.key.organization.label}
{ editor empty$
    { key empty$
        { organization empty$
            { cite$ #1 #3 substring$ }
            { "The " #4 organization chop.word #3 text.prefix$ }
          if$
        }
        'key
      if$
    }
    { editor format.lab.names }
  if$
}

FUNCTION {calc.short.authors}
{ type$ "book" =
  type$ "inbook" =
  or
    'author.editor.key.label
    { type$ "proceedings" =
        'editor.key.organization.label
        { type$ "manual" =
            'author.key.organization.label
            'author.key.label
          if$
        }
      if$
    }
  if$
  'short.list :=
}

FUNCTION {calc.label}
{ calc.short.authors
  short.list
  "("
  *
  year duplicate$ empty$
  short.list key field.or.null = or
     { pop$ "" }
     'skip$
  if$
  *
  'label :=
}

ITERATE {calc.label}

STRINGS { longest.label last.label next.extra }

INTEGERS { longest.label.width last.extra.num number.label }

FUNCTION {initialize.longest.label}
{ "" 'longest.label :=
  #0 int.to.chr$ 'last.label :=
  "" 'next.extra :=
  #0 'longest.label.width :=
  #0 'last.extra.num :=
  #0 'number.label :=
}

FUNCTION {forward.pass}
{ last.label label =
    { last.extra.num #1 + 'last.extra.num :=
      last.extra.num int.to.chr$ 'extra.label :=
    }
    { "a" chr.to.int$ 'last.extra.num :=
      "" 'extra.label :=
      label 'last.label :=
    }
  if$
  number.label #1 + 'number.label :=
}

EXECUTE {initialize.longest.label}

ITERATE {forward.pass}

%</nat>
%<*!mcp>
FUNCTION {begin.bib}
{ preamble$ empty$
    'skip$
    { preamble$ write$ newline$ }
  if$
  "\providecommand{\url}[1]{\texttt{#1}}"
  write$ newline$
%<!nat&!mc>  "\begin{thebibliography}{"  longest.label  * "}" * write$ newline$
%<!nat&mc>  "\begin{mcbibliography}{"  longest.label  * "}" * write$ newline$
%<nat>  "\begin{thebibliography}{" number.label int.to.str$ * "}" *
%<nat>  write$ newline$
%<nat>  "\providecommand{\natexlab}[1]{#1}"
%<nat>  write$ newline$
}

%</!mcp>
%<*mcp>
FUNCTION {begin.bib}
{ preamble$ empty$
    'skip$
    { preamble$ write$ newline$ }
  if$
  "\ifx\mcitethebibliography\mciteundefinedmacro"
  write$ newline$
%<rsc>  "\PackageError{rscM.bst}{mciteplus.sty has not been loaded}"
%<angew>  "\PackageError{angewM.bst}{mciteplus.sty has not been loaded}"
  write$ newline$
  "{This bibstyle requires the use of the mciteplus package.}\fi"
  write$ newline$
%<!nat>  "\begin{mcitethebibliography}{"  longest.label  * "}" * write$ newline$
%<nat>  "\begin{mcitethebibliography}{"  number.label int.to.str$  * "}" *
%<nat>  write$ newline$
%<nat>  "\providecommand{\natexlab}[1]{#1}"
%<nat>  write$ newline$
  "\mciteSetBstSublistMode{f}"
  write$ newline$
%<rsc>  "\mciteSetBstMaxWidthForm{subitem}{(\emph{\alph{mcitesubitemcount}})}"
%<angew>  "\mciteSetBstMaxWidthForm{subitem}{\alph{mcitesubitemcount})}"
  write$ newline$
  "\mciteSetBstSublistLabelBeginEnd{\mcitemaxwidthsubitemform\space}"
  write$ newline$
  "{\relax}{\relax}"
  write$ newline$
}

%</mcp>
EXECUTE {begin.bib}

EXECUTE {init.state.consts}

ITERATE {call.type$}

%<*!mc&!mcp>
FUNCTION {end.bib}
{ newline$
  "\end{thebibliography}" write$ newline$
}

%</!mc&!mcp>
%<*mc>
FUNCTION {end.bib}
{ newline$
  "\end{mcbibliography}" write$ newline$
}

%</mc>
%<*mcp>
FUNCTION {end.bib}
{ newline$
  "\end{mcitethebibliography}" write$ newline$
}

%</mcp>
EXECUTE {end.bib}
%    \end{macrocode}
%</bib>
%\fi
%\PrintChanges
%\Finale
%\iffalse
%<*jawltxdoc>
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{jawltxdoc}
\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,xspace}
\usepackage{upgreek,ifpdf,listings}
\ifpdf
  \usepackage{embedfile}
  \embedfile[%
    stringmethod=escape,%
    mimetype=plain/text,%
    desc={LaTeX docstrip source archive for package `\jobname'}%
    ]{\jobname.dtx}
\fi
\IfFileExists{\jobname.sty}
  {\usepackage{\jobname}}{}
\usepackage[numbered]{hypdoc}
\newlength\LaTeXwidth
\newlength\LaTeXoutdent
\newlength\LaTeXgap
\setlength\LaTeXgap{1em}
\setlength\LaTeXoutdent{-0.15\textwidth}
\newcommand*{\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}
}
\newcommand*{\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}
}
\newcommand*{\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}
}
\newcommand*{\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=3,%
    breakindent=0pt,basicstyle=\small\ttfamily,basewidth=0.51em,%
    keywordstyle=\color{blue},%
    morekeywords={% notes2bib
      niibsetup,bibnote,bibnotetext,bibnotemark,thebibnote,%
      flushnotestack,citenote,printbibnotes}}
  \lst@BeginAlsoWriteFile{\LaTeXexamplefile}
}{%
  \lst@EndWriteFile\egroup
  \setlength\LaTeXwidth{\wd\lst@samplebox}
  \typesetexample%
}
\newcommand*{\lst@sampleInput}{%
  \MakePercentComment\catcode`\^^M=10\relax
  \small%
  {\setkeys{lst}{SelectCharTable=\lst@ReplaceInput{\^\^I}%
    {\lst@ProcessTabulator}}%
    \leavevmode \input{\LaTeXexamplefile}}%
  \MakePercentIgnore%
}
\newcommand*{\pkg}[1]{\textsf{#1}}
\newcommand*{\currpkg}{\pkg{\jobname}\xspace}
\newcommand*{\opt}[1]{\texttt{#1}}
\newcommand*{\file}[1]{\texttt{#1}}
\newcommand*{\ext}[1]{\file{.#1}}
\newcommand*{\latin}[1]{\emph{#1}}
\newcommand*{\etc}{%
  \@ifnextchar.
    {\latin{etc}}
    {\latin{etc.}}
  \xspace}
\newcommand*{\eg}{%
  \@ifnextchar.
    {\latin{e.g}}
    {\latin{e.g.}}
  \xspace}
\newcommand*{\ie}{%
  \@ifnextchar.
    {\latin{i.e}}
    {\latin{i.e.}}
  \xspace}
\newcommand*{\AMS}{{\protect\usefont{OMS}{cmsy}{m}{n}%
  A\kern-.1667em\lower.5ex\hbox{M}\kern-.125emS}}
\providecommand*{\eTeX}{\ensuremath{\varepsilon}-\TeX}
\newcommand*{\XeTeX}
  {X\kern-.125em\lower.5ex\hbox{\reflectbox{E}}\kern-.1667em\TeX}
%</jawltxdoc>
%\fi
