% \iffalse meta-comment % % Copyright (C) 2006-2007 by % Joseph Wright % % 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 rsc.dtx % and the derived files rsc.ins, % rsc.sty, % rsc.pdf, % rsc.bst, % rscnat.bst, % rsc-mc.bst, % angew.bst, % angewnat.bst and % angew-mc.bst % 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 % %<*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}} } \endbatchfile % %<*ignore> \fi % Will Robertson's trick \immediate\write18{makeindex -s gglo.ist -o \jobname.gls \jobname.glo} % %<*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} % % \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 % \texttt{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} % %\DoNotIndex{} % %\title{The \texttt{rsc} package --- BibTeX support for % Royal Society of Chemistry and Wiley style articles% % \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 |rsc| package provides BibTeX style files to produce % bibliographies in accordance with the guidelines of the % Royal Society of Chemistry and Wiley chemistry-related % journals. % %\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 |achemso| provides for a BibTeX style % and other support for reports in the style of the American Chemical % Society. The aim of the |rsc| 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. % % In addition to providing the core |*.bst| files, this package also % generates |*-mc.bst|, |*nat.bst|, |rsc.sty| and |rsc.tex|. The % |*-mc.bst| files includes support for the |mcite| package, allowing % the generation of multiple references. The |*nat.bst| files allow % the use of the |natbib| package with BibTeX style files. % % \section{Bibliography design decisions} % % Along with almost every BibTeX style file, much of the |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 |crossref| % will still fill in missing information, but will not output % ``see ref.~X''. Chemistry references do not lend themselves % to the use of |crossref|. % % \subsection{Notes} % % As in |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. % Although it is not perfect, the package |mcite| allows you to % produce references of the format: % \begin{enumerate} % \item K.~\"Ofele, \emph{J.~Organomet.~Chem.}, 1968, % \textbf{12}, P42--P43; C.~D.~Abernethy, A.~H.~Cowley and R.~A.\ % Jones, \emph{J.~Organomet.~Chem.}, 2000, \textbf{596}, % 3--5. % \end{enumerate} % Although the package only requires a minor modification of the % BibTeX style file, it seems a good idea to provide one % automatically. The |*-mc.bst| are produced with the necessary % modifications made to |*.bst|. Note that this requires % |\usepackage{mcite}| in your LaTeX source. % % \subsection{\texttt{natbib} support} % % The files |rscnat.bst| and |angewnat.bst| provide support for the % generation of bibliographies for use with the |natbib| package. % As well as altering the |\bibliographystyle| command appropriately, % you also need to load |natbib|. The |rsc| package file provides % the option |natbib|, which loads |natbib| automatically (normally, % |rsc| loads the |cite| package). Note that |natbib| and |mcite| % are incompatible, so you must choose one or the other. % % \subsection{Additional entry types} % % In order to ensure compatibility with the |achemso| package, the % non-standard entry types |remark|, |inpress| and |submitted| are % supported. The implementation is modelled on |achemso.bst|, but the % |notes| field is not used for |inpress| and |submitted|. % % \section{Additional macros} % % The macros provided by |rsc.sty| have been migrated (with % improvements) to the |chemstyle| package. Users are strongly % advised to use the new package, with either %\begin{LaTeXexample}[\typesetcodeonly] % \usepackage[rsc]{chemstyle} %\end{LaTeXexample} %or %\begin{LaTeXexample}[\typesetcodeonly] % \usepackage[angew]{chemstyle} %\end{LaTeXexample} % as appropriate in place of loading the |rsc| macros. Currently, % the |rsc| package will load |chemstyle| with appropriate options. % There will be no further updates to the |rsc| LaTeX package. % % \StopEventually{} % % \iffalse %<*package> % \fi % \section{The package code} % % \subsection{Setup code} % % First of all, the package identifies itself. % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{rsc}[2007/10/16 v2.2 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 |rsc|. This loads |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 |chemstyle|. % \begin{macrocode} \DeclareOption*{\PassOptionsToPackage{\CurrentOption}{chemstyle}} % \end{macrocode} % The |rsc| option is the default. % \begin{macrocode} \ExecuteOptions{rsc} \ProcessOptions\relax % \end{macrocode} % |chemstyle| can now be loaded. % \begin{macrocode} \RequirePackage{chemstyle} \floatcontentscentre % \end{macrocode} % If |natbib| is not loaded, then |cite| is needed. % \begin{macrocode} \AtEndOfPackage{ \@ifpackageloaded{natbib}{} {\RequirePackage[super]{cite}} } % \end{macrocode} % % \iffalse % % \fi % \section{The BibTeX style files} % % A great deal of the BibTeX style file information is lifted % more or less directly from the standard style files, the % |custom-bib| package or \emph{Taming the BeaST}. The rest % consists of minor edits to obtain the correct format or support % the |natbib| and |mcite| 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 % key note number organization pages publisher school series title type url volume year } {} % { label } %<*nat> { label extra.label short.list } % 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 := } % FUNCTION {fin.entry} %<*!mc> { add.period$ write$ newline$ } % %<*mc> { write$ "\relax" write$ newline$ "\relax" write$ } % 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} %{ "ch." } %{ "Chapter" } FUNCTION {bbl.editor} %{ "ed." } %{ "Ed.:" } %FUNCTION {bbl.editors} %{ "Eds.:" } FUNCTION {bbl.edition} %{ "edn." } %{ "ed." } FUNCTION {bbl.etal} { "et~al." emphasize } FUNCTION {bbl.in} { "in" } FUNCTION {bbl.inpress} { "in press" } FUNCTION {bbl.msc} %{ "M.Sc. thesis" } %{ "MSc thesis" } FUNCTION {bbl.page} { "p." } FUNCTION {bbl.pages} { "pp." } FUNCTION {bbl.phd} %{ "Ph.D. thesis" } %{ "PhD thesis" } FUNCTION {bbl.submitted} { "submitted for publication" } FUNCTION {bbl.techreport} { "Technical Report" } FUNCTION {bbl.volume} %{ "vol." } %{ "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$ } % 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 } % { bbl.and space.connect t space.connect } % { 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 % % \begin{macrocode} FUNCTION {format.editors} { editor empty$ { "" } { #2 'author.or.editor := %<*rsc> bbl.editor " " * * editor format.names % %<*angew> strip.comma editor num.names$ #1 > { bbl.editors } { bbl.editor } if$ " " * editor format.names * paren % } 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$ } % %<*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 := } % 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$ { "" } % 'year % { year boldface } if$ } FUNCTION {format.bdate} { year empty$ { "There's no year in " cite$ * warning$ } % 'year % { 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 } % { pages n.separate.multi } % { pages } if$ } if$ } FUNCTION {format.vol.pages} %{ volume boldface field.or.null %{ 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 := % 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$ } % 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 % journal emphasize "journal" output.check %<*angew> journal "," "" find.replace emphasize "journal" output.check after.item 'output.state := % format.date "year" output.check volume empty$ { "" format.pages.nopp output } { format.vol.pages output } if$ fin.entry } FUNCTION {book} { output.bibitem author empty$ % { title format.title "title" output.check % { 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 % title format.title "title" output.check % title format.title.vol "title" output.check } if$ format.pub.address "publisher" output.check format.edition output format.bdate "year" output.check % 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$ % { title format.title "title" output.check % { 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 % title format.title.in "title" output.check % title format.title.vol.in "title" output.check } if$ format.pub.address "publisher" output.check format.edition output format.bdate "year" output.check % format.bvolume output format.chapter.pages "chapter and pages" output.check fin.entry } FUNCTION {incollection} { output.bibitem author empty$ % { booktitle format.title "booktitle" output.check % { 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 % booktitle format.title.in "booktitle" output.check % booktitle format.title.vol.in "booktitle" output.check } if$ format.pub.address "publisher" output.check format.edition output format.bdate "year" output.check % 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 % booktitle format.title.noemph "booktitle" output.check % 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$ % title format.title "title" output.check % 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 % bbl.msc emphasize format.thesis.type output % 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 % year output % 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 % bbl.phd emphasize format.thesis.type output % bbl.phd format.thesis.type output school "school" output.check address output format.date "year" output.check fin.entry } FUNCTION {proceedings} { output.bibitem % title format.title.noemph "title" output.check % 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 } % % { "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> 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} % %<*!mc&!nat> FUNCTION {begin.bib} { preamble$ empty$ 'skip$ { preamble$ write$ newline$ } if$ "\providecommand{\url}[1]{\texttt{#1}}" write$ newline$ "\begin{thebibliography}{" longest.label * "}" * write$ newline$ } % %<*!mc&nat> FUNCTION {begin.bib} { preamble$ empty$ 'skip$ { preamble$ write$ newline$ } if$ "\providecommand{\url}[1]{\texttt{#1}}" write$ newline$ "\begin{thebibliography}{" number.label int.to.str$ * "}" * write$ newline$ "\providecommand{\natexlab}[1]{#1}" write$ newline$ } % %<*mc> FUNCTION {begin.bib} { preamble$ empty$ 'skip$ { preamble$ write$ newline$ } if$ "\providecommand{\url}[1]{\texttt{#1}}" write$ newline$ "\begin{mcbibliography}{" longest.label * "}" * write$ newline$ } % EXECUTE {begin.bib} EXECUTE {init.state.consts} ITERATE {call.type$} %<*!mc> FUNCTION {end.bib} { newline$ "\end{thebibliography}" write$ newline$ } % %<*mc> FUNCTION {end.bib} { newline$ "\end{mcbibliography}" write$ newline$ } % EXECUTE {end.bib} % \end{macrocode} % %\fi %\PrintChanges %\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} % %\fi