2 %% This is file `natbib.sty',
\r
3 %% generated with the docstrip utility.
\r
5 %% The original source files were:
\r
7 %% natbib.dtx (with options: `package,all')
\r
8 %% =============================================
\r
11 %% This program can be redistributed and/or modified under the terms
\r
12 %% of the LaTeX Project Public License Distributed from CTAN
\r
13 %% archives in directory macros/latex/base/lppl.txt; either
\r
14 %% version 1 of the License, or any later version.
\r
16 %% This is a generated file.
\r
17 %% It may not be distributed without the original source file natbib.dtx.
\r
19 %% Full documentation can be obtained by LaTeXing that original file.
\r
20 %% Only a few abbreviated comments remain here to describe the usage.
\r
21 %% =============================================
\r
22 %% Copyright 1993-2010 Patrick W Daly
\r
23 %% Max-Planck-Institut f\"ur Sonnensystemforschung
\r
24 %% Max-Planck-Str. 2
\r
25 %% D-37191 Katlenburg-Lindau
\r
27 %% E-mail: daly@mps.mpg.de
\r
28 \NeedsTeXFormat{LaTeX2e}[1995/06/01]
\r
29 \ProvidesPackage{natbib}
\r
30 [2010/09/13 8.31b (PWD, AO)]
\r
32 % This package reimplements the LaTeX \cite command to be used for various
\r
33 % citation styles, both author-year and numerical. It accepts BibTeX
\r
34 % output intended for many other packages, and therefore acts as a
\r
35 % general, all-purpose citation-style interface.
\r
37 % With standard numerical .bst files, only numerical citations are
\r
38 % possible. With an author-year .bst file, both numerical and
\r
39 % author-year citations are possible.
\r
41 % If author-year citations are selected, \bibitem must have one of the
\r
43 % \bibitem[Jones et al.(1990)]{key}...
\r
44 % \bibitem[Jones et al.(1990)Jones, Baker, and Williams]{key}...
\r
45 % \bibitem[Jones et al., 1990]{key}...
\r
46 % \bibitem[\protect\citeauthoryear{Jones, Baker, and Williams}{Jones
\r
47 % et al.}{1990}]{key}...
\r
48 % \bibitem[\protect\citeauthoryear{Jones et al.}{1990}]{key}...
\r
49 % \bibitem[\protect\astroncite{Jones et al.}{1990}]{key}...
\r
50 % \bibitem[\protect\citename{Jones et al., }1990]{key}...
\r
51 % \harvarditem[Jones et al.]{Jones, Baker, and Williams}{1990}{key}...
\r
53 % This is either to be made up manually, or to be generated by an
\r
54 % appropriate .bst file with BibTeX.
\r
55 % Author-year mode || Numerical mode
\r
56 % Then, \citet{key} ==>> Jones et al. (1990) || Jones et al. [21]
\r
57 % \citep{key} ==>> (Jones et al., 1990) || [21]
\r
58 % Multiple citations as normal:
\r
59 % \citep{key1,key2} ==>> (Jones et al., 1990; Smith, 1989) || [21,24]
\r
60 % or (Jones et al., 1990, 1991) || [21,24]
\r
61 % or (Jones et al., 1990a,b) || [21,24]
\r
62 % \cite{key} is the equivalent of \citet{key} in author-year mode
\r
63 % and of \citep{key} in numerical mode
\r
64 % Full author lists may be forced with \citet* or \citep*, e.g.
\r
65 % \citep*{key} ==>> (Jones, Baker, and Williams, 1990)
\r
66 % Optional notes as:
\r
67 % \citep[chap. 2]{key} ==>> (Jones et al., 1990, chap. 2)
\r
68 % \citep[e.g.,][]{key} ==>> (e.g., Jones et al., 1990)
\r
69 % \citep[see][pg. 34]{key}==>> (see Jones et al., 1990, pg. 34)
\r
70 % (Note: in standard LaTeX, only one note is allowed, after the ref.
\r
71 % Here, one note is like the standard, two make pre- and post-notes.)
\r
72 % \citealt{key} ==>> Jones et al. 1990
\r
73 % \citealt*{key} ==>> Jones, Baker, and Williams 1990
\r
74 % \citealp{key} ==>> Jones et al., 1990
\r
75 % \citealp*{key} ==>> Jones, Baker, and Williams, 1990
\r
76 % Additional citation possibilities (both author-year and numerical modes)
\r
77 % \citeauthor{key} ==>> Jones et al.
\r
78 % \citeauthor*{key} ==>> Jones, Baker, and Williams
\r
79 % \citeyear{key} ==>> 1990
\r
80 % \citeyearpar{key} ==>> (1990)
\r
81 % \citetext{priv. comm.} ==>> (priv. comm.)
\r
82 % \citenum{key} ==>> 11 [non-superscripted]
\r
83 % Note: full author lists depends on whether the bib style supports them;
\r
84 % if not, the abbreviated list is printed even when full requested.
\r
86 % For names like della Robbia at the start of a sentence, use
\r
87 % \Citet{dRob98} ==>> Della Robbia (1998)
\r
88 % \Citep{dRob98} ==>> (Della Robbia, 1998)
\r
89 % \Citeauthor{dRob98} ==>> Della Robbia
\r
92 % Citation aliasing is achieved with
\r
93 % \defcitealias{key}{text}
\r
94 % \citetalias{key} ==>> text
\r
95 % \citepalias{key} ==>> (text)
\r
97 % Defining the citation mode and punctual (citation style)
\r
98 % \setcitestyle{<comma-separated list of keywords, same
\r
99 % as the package options>}
\r
100 % Example: \setcitestyle{square,semicolon}
\r
102 % Use \bibpunct with 6 mandatory arguments:
\r
103 % 1. opening bracket for citation
\r
104 % 2. closing bracket
\r
105 % 3. citation separator (for multiple citations in one \cite)
\r
106 % 4. the letter n for numerical styles, s for superscripts
\r
107 % else anything for author-year
\r
108 % 5. punctuation between authors and date
\r
109 % 6. punctuation between years (or numbers) when common authors missing
\r
110 % One optional argument is the character coming before post-notes. It
\r
111 % appears in square braces before all other arguments. May be left off.
\r
112 % Example (and default) \bibpunct[, ]{(}{)}{;}{a}{,}{,}
\r
114 % To make this automatic for a given bib style, named newbib, say, make
\r
115 % a local configuration file, natbib.cfg, with the definition
\r
116 % \newcommand{\bibstyle@newbib}{\bibpunct...}
\r
117 % Then the \bibliographystyle{newbib} will cause \bibstyle@newbib to
\r
118 % be called on THE NEXT LATEX RUN (via the aux file).
\r
120 % Such preprogrammed definitions may be invoked anywhere in the text
\r
121 % by calling \citestyle{newbib}. This is only useful if the style specified
\r
122 % differs from that in \bibliographystyle.
\r
124 % With \citeindextrue and \citeindexfalse, one can control whether the
\r
125 % \cite commands make an automatic entry of the citation in the .idx
\r
126 % indexing file. For this, \makeindex must also be given in the preamble.
\r
128 % Package Options: (for selecting punctuation)
\r
129 % round - round parentheses are used (default)
\r
130 % square - square brackets are used [option]
\r
131 % curly - curly braces are used {option}
\r
132 % angle - angle brackets are used <option>
\r
133 % semicolon - multiple citations separated by semi-colon (default)
\r
134 % colon - same as semicolon, an earlier confusion
\r
135 % comma - separated by comma
\r
136 % authoryear - selects author-year citations (default)
\r
137 % numbers- selects numerical citations
\r
138 % super - numerical citations as superscripts
\r
139 % sort - sorts multiple citations according to order in ref. list
\r
140 % sort&compress - like sort, but also compresses numerical citations
\r
141 % compress - compresses without sorting
\r
142 % longnamesfirst - makes first citation full author list
\r
143 % sectionbib - puts bibliography in a \section* instead of \chapter*
\r
144 % merge - allows the citation key to have a * prefix,
\r
145 % signifying to merge its reference with that of the previous citation.
\r
146 % elide - if references are merged, repeated portions of later ones may be removed.
\r
147 % mcite - recognizes and ignores the * prefix for merging.
\r
148 % Punctuation so selected dominates over any predefined ones.
\r
149 % Package options are called as, e.g.
\r
150 % \usepackage[square,comma]{natbib}
\r
151 % LaTeX the source file natbib.dtx to obtain more details
\r
152 % or the file natnotes.tex for a brief reference sheet.
\r
153 %-----------------------------------------------------------
\r
154 \providecommand\@ifxundefined[1]{%
\r
155 \ifx#1\@undefined\expandafter\@firstoftwo\else\expandafter\@secondoftwo\fi
\r
157 \providecommand\@ifnum[1]{%
\r
158 \ifnum#1\expandafter\@firstoftwo\else\expandafter\@secondoftwo\fi
\r
160 \providecommand\@ifx[1]{%
\r
161 \ifx#1\expandafter\@firstoftwo\else\expandafter\@secondoftwo\fi
\r
163 \providecommand\appdef[2]{%
\r
164 \toks@\expandafter{#1}\@temptokena{#2}%
\r
165 \edef#1{\the\toks@\the\@temptokena}%
\r
167 \@ifclassloaded{agu2001}{\PackageError{natbib}
\r
168 {The agu2001 class already includes natbib coding,\MessageBreak
\r
169 so you should not add it explicitly}
\r
170 {Type <Return> for now, but then later remove\MessageBreak
\r
171 the command \protect\usepackage{natbib} from the document}
\r
173 \@ifclassloaded{agutex}{\PackageError{natbib}
\r
174 {The AGUTeX class already includes natbib coding,\MessageBreak
\r
175 so you should not add it explicitly}
\r
176 {Type <Return> for now, but then later remove\MessageBreak
\r
177 the command \protect\usepackage{natbib} from the document}
\r
179 \@ifclassloaded{aguplus}{\PackageError{natbib}
\r
180 {The aguplus class already includes natbib coding,\MessageBreak
\r
181 so you should not add it explicitly}
\r
182 {Type <Return> for now, but then later remove\MessageBreak
\r
183 the command \protect\usepackage{natbib} from the document}
\r
185 \@ifclassloaded{nlinproc}{\PackageError{natbib}
\r
186 {The nlinproc class already includes natbib coding,\MessageBreak
\r
187 so you should not add it explicitly}
\r
188 {Type <Return> for now, but then later remove\MessageBreak
\r
189 the command \protect\usepackage{natbib} from the document}
\r
191 \@ifclassloaded{egs}{\PackageError{natbib}
\r
192 {The egs class already includes natbib coding,\MessageBreak
\r
193 so you should not add it explicitly}
\r
194 {Type <Return> for now, but then later remove\MessageBreak
\r
195 the command \protect\usepackage{natbib} from the document}
\r
197 \@ifclassloaded{egu}{\PackageError{natbib}
\r
198 {The egu class already includes natbib coding,\MessageBreak
\r
199 so you should not add it explicitly}
\r
200 {Type <Return> for now, but then later remove\MessageBreak
\r
201 the command \protect\usepackage{natbib} from the document}
\r
203 % Define citation punctuation for some author-year styles
\r
204 % One may add and delete at this point
\r
205 % Or put additions into local configuration file natbib.cfg
\r
206 \newcommand\bibstyle@chicago{\bibpunct{(}{)}{;}{a}{,}{,}}
\r
207 \newcommand\bibstyle@named{\bibpunct{[}{]}{;}{a}{,}{,}}
\r
208 \newcommand\bibstyle@agu{\bibpunct{[}{]}{;}{a}{,}{,~}}%Amer. Geophys. Union
\r
209 \newcommand\bibstyle@copernicus{\bibpunct{(}{)}{;}{a}{,}{,}}%Copernicus Publications
\r
210 \let\bibstyle@egu=\bibstyle@copernicus
\r
211 \let\bibstyle@egs=\bibstyle@copernicus
\r
212 \newcommand\bibstyle@agsm{\bibpunct{(}{)}{,}{a}{}{,}\gdef\harvardand{\&}}
\r
213 \newcommand\bibstyle@kluwer{\bibpunct{(}{)}{,}{a}{}{,}\gdef\harvardand{\&}}
\r
214 \newcommand\bibstyle@dcu{\bibpunct{(}{)}{;}{a}{;}{,}\gdef\harvardand{and}}
\r
215 \newcommand\bibstyle@aa{\bibpunct{(}{)}{;}{a}{}{,}} %Astronomy & Astrophysics
\r
216 \newcommand\bibstyle@pass{\bibpunct{(}{)}{;}{a}{,}{,}}%Planet. & Space Sci
\r
217 \newcommand\bibstyle@anngeo{\bibpunct{(}{)}{;}{a}{,}{,}}%Annales Geophysicae
\r
218 \newcommand\bibstyle@nlinproc{\bibpunct{(}{)}{;}{a}{,}{,}}%Nonlin.Proc.Geophys.
\r
219 % Define citation punctuation for some numerical styles
\r
220 \newcommand\bibstyle@cospar{\bibpunct{/}{/}{,}{n}{}{}%
\r
221 \gdef\bibnumfmt##1{##1.}}
\r
222 \newcommand\bibstyle@esa{\bibpunct{(Ref.~}{)}{,}{n}{}{}%
\r
223 \gdef\bibnumfmt##1{##1.\hspace{1em}}}
\r
224 \newcommand\bibstyle@nature{\bibpunct{}{}{,}{s}{}{\textsuperscript{,}}%
\r
225 \gdef\bibnumfmt##1{##1.}}
\r
226 % The standard LaTeX styles
\r
227 \newcommand\bibstyle@plain{\bibpunct{[}{]}{,}{n}{}{,}}
\r
228 \let\bibstyle@alpha=\bibstyle@plain
\r
229 \let\bibstyle@abbrv=\bibstyle@plain
\r
230 \let\bibstyle@unsrt=\bibstyle@plain
\r
231 % The author-year modifications of the standard styles
\r
232 \newcommand\bibstyle@plainnat{\bibpunct{[}{]}{,}{a}{,}{,}}
\r
233 \let\bibstyle@abbrvnat=\bibstyle@plainnat
\r
234 \let\bibstyle@unsrtnat=\bibstyle@plainnat
\r
235 \newif\ifNAT@numbers \NAT@numbersfalse
\r
236 \newif\ifNAT@super \NAT@superfalse
\r
238 \DeclareOption{numbers}{\NAT@numberstrue
\r
239 \ExecuteOptions{square,comma,nobibstyle}}
\r
240 \DeclareOption{super}{\NAT@supertrue\NAT@numberstrue
\r
241 \renewcommand\NAT@open{}\renewcommand\NAT@close{}
\r
242 \ExecuteOptions{nobibstyle}}
\r
243 \DeclareOption{authoryear}{\NAT@numbersfalse
\r
244 \ExecuteOptions{round,semicolon,bibstyle}}
\r
245 \DeclareOption{round}{%
\r
246 \renewcommand\NAT@open{(} \renewcommand\NAT@close{)}
\r
247 \ExecuteOptions{nobibstyle}}
\r
248 \DeclareOption{square}{%
\r
249 \renewcommand\NAT@open{[} \renewcommand\NAT@close{]}
\r
250 \ExecuteOptions{nobibstyle}}
\r
251 \DeclareOption{angle}{%
\r
252 \renewcommand\NAT@open{$<$} \renewcommand\NAT@close{$>$}
\r
253 \ExecuteOptions{nobibstyle}}
\r
254 \DeclareOption{curly}{%
\r
255 \renewcommand\NAT@open{\{} \renewcommand\NAT@close{\}}
\r
256 \ExecuteOptions{nobibstyle}}
\r
257 \DeclareOption{comma}{\renewcommand\NAT@sep{,}
\r
258 \ExecuteOptions{nobibstyle}}
\r
259 \DeclareOption{semicolon}{\renewcommand\NAT@sep{;}
\r
260 \ExecuteOptions{nobibstyle}}
\r
261 \DeclareOption{colon}{\ExecuteOptions{semicolon}}
\r
262 \DeclareOption{nobibstyle}{\let\bibstyle=\@gobble}
\r
263 \DeclareOption{bibstyle}{\let\bibstyle=\@citestyle}
\r
264 \newif\ifNAT@openbib \NAT@openbibfalse
\r
265 \DeclareOption{openbib}{\NAT@openbibtrue}
\r
266 \DeclareOption{sectionbib}{\def\NAT@sectionbib{on}}
\r
268 \def\NAT@cmprs{\z@}
\r
269 \DeclareOption{sort}{\def\NAT@sort{\@ne}}
\r
270 \DeclareOption{compress}{\def\NAT@cmprs{\@ne}}
\r
271 \DeclareOption{sort&compress}{\def\NAT@sort{\@ne}\def\NAT@cmprs{\@ne}}
\r
272 \DeclareOption{mcite}{\let\NAT@merge\@ne}
\r
273 \DeclareOption{merge}{\@ifnum{\NAT@merge<\tw@}{\let\NAT@merge\tw@}{}}
\r
274 \DeclareOption{elide}{\@ifnum{\NAT@merge<\thr@@}{\let\NAT@merge\thr@@}{}}
\r
275 \@ifpackageloaded{cite}{\PackageWarningNoLine{natbib}
\r
276 {The `cite' package should not be used\MessageBreak
\r
277 with natbib. Use option `sort' instead}\ExecuteOptions{sort}}{}
\r
278 \@ifpackageloaded{mcite}{\PackageWarningNoLine{natbib}
\r
279 {The `mcite' package should not be used\MessageBreak
\r
280 with natbib. Use option `merge' instead}\ExecuteOptions{merge}}{}
\r
281 \@ifpackageloaded{citeref}{\PackageError{natbib}
\r
282 {The `citeref' package must be loaded after natbib}%
\r
283 {Move \protect\usepackage{citeref} to after \string\usepackage{natbib}}}{}
\r
284 \newif\ifNAT@longnames\NAT@longnamesfalse
\r
285 \DeclareOption{longnamesfirst}{\NAT@longnamestrue}
\r
286 \DeclareOption{nonamebreak}{\def\NAT@nmfmt#1{\mbox{\NAT@up#1}}}
\r
287 \def\NAT@nmfmt#1{{\NAT@up#1}}
\r
288 \renewcommand\bibstyle[1]{\csname bibstyle@#1\endcsname}
\r
289 \AtBeginDocument{\global\let\bibstyle=\@gobble}
\r
290 \let\@citestyle\bibstyle
\r
291 \newcommand\citestyle[1]{\@citestyle{#1}\let\bibstyle\@gobble}
\r
292 \newcommand\bibpunct[7][, ]%
\r
293 {\gdef\NAT@open{#2}\gdef\NAT@close{#3}\gdef
\r
294 \NAT@sep{#4}\global\NAT@numbersfalse
\r
295 \ifx #5n\global\NAT@numberstrue\global\NAT@superfalse
\r
297 \ifx #5s\global\NAT@numberstrue\global\NAT@supertrue
\r
299 \gdef\NAT@aysep{#6}\gdef\NAT@yrsep{#7}%
\r
303 \newcommand\setcitestyle[1]{
\r
304 \@for\@tempa:=#1\do
\r
305 {\def\@tempb{round}\ifx\@tempa\@tempb
\r
306 \renewcommand\NAT@open{(}\renewcommand\NAT@close{)}\fi
\r
307 \def\@tempb{square}\ifx\@tempa\@tempb
\r
308 \renewcommand\NAT@open{[}\renewcommand\NAT@close{]}\fi
\r
309 \def\@tempb{angle}\ifx\@tempa\@tempb
\r
310 \renewcommand\NAT@open{$<$}\renewcommand\NAT@close{$>$}\fi
\r
311 \def\@tempb{curly}\ifx\@tempa\@tempb
\r
312 \renewcommand\NAT@open{\{}\renewcommand\NAT@close{\}}\fi
\r
313 \def\@tempb{semicolon}\ifx\@tempa\@tempb
\r
314 \renewcommand\NAT@sep{;}\fi
\r
315 \def\@tempb{colon}\ifx\@tempa\@tempb
\r
316 \renewcommand\NAT@sep{;}\fi
\r
317 \def\@tempb{comma}\ifx\@tempa\@tempb
\r
318 \renewcommand\NAT@sep{,}\fi
\r
319 \def\@tempb{authoryear}\ifx\@tempa\@tempb
\r
320 \NAT@numbersfalse\fi
\r
321 \def\@tempb{numbers}\ifx\@tempa\@tempb
\r
322 \NAT@numberstrue\NAT@superfalse\fi
\r
323 \def\@tempb{super}\ifx\@tempa\@tempb
\r
324 \NAT@numberstrue\NAT@supertrue\fi
\r
325 \expandafter\NAT@find@eq\@tempa=\relax\@nil
\r
326 \if\@tempc\relax\else
\r
327 \expandafter\NAT@rem@eq\@tempc
\r
328 \def\@tempb{open}\ifx\@tempa\@tempb
\r
329 \xdef\NAT@open{\@tempc}\fi
\r
330 \def\@tempb{close}\ifx\@tempa\@tempb
\r
331 \xdef\NAT@close{\@tempc}\fi
\r
332 \def\@tempb{aysep}\ifx\@tempa\@tempb
\r
333 \xdef\NAT@aysep{\@tempc}\fi
\r
334 \def\@tempb{yysep}\ifx\@tempa\@tempb
\r
335 \xdef\NAT@yrsep{\@tempc}\fi
\r
336 \def\@tempb{notesep}\ifx\@tempa\@tempb
\r
337 \xdef\NAT@cmt{\@tempc}\fi
\r
338 \def\@tempb{citesep}\ifx\@tempa\@tempb
\r
339 \xdef\NAT@sep{\@tempc}\fi
\r
344 \def\NAT@find@eq#1=#2\@nil{\def\@tempa{#1}\def\@tempc{#2}}
\r
345 \def\NAT@rem@eq#1={\def\@tempc{#1}}
\r
346 \def\NAT@@setcites{\global\let\bibstyle\@gobble}
\r
347 \AtBeginDocument{\let\NAT@@setcites\NAT@set@cites}
\r
348 \newcommand\NAT@open{(} \newcommand\NAT@close{)}
\r
349 \newcommand\NAT@sep{;}
\r
351 \newcommand\NAT@aysep{,} \newcommand\NAT@yrsep{,}
\r
352 \newcommand\NAT@cmt{, }
\r
353 \newcommand\NAT@cite%
\r
354 [3]{\ifNAT@swa\NAT@@open\if*#2*\else#2\NAT@spacechar\fi
\r
355 #1\if*#3*\else\NAT@cmt#3\fi\NAT@@close\else#1\fi\endgroup}
\r
356 \newcommand\NAT@citenum%
\r
357 [3]{\ifNAT@swa\NAT@@open\if*#2*\else#2\NAT@spacechar\fi
\r
358 #1\if*#3*\else\NAT@cmt#3\fi\NAT@@close\else#1\fi\endgroup}
\r
359 \newcommand\NAT@citesuper[3]{\ifNAT@swa
\r
360 \if*#2*\else#2\NAT@spacechar\fi
\r
361 \unskip\kern\p@\textsuperscript{\NAT@@open#1\NAT@@close}%
\r
362 \if*#3*\else\NAT@spacechar#3\fi\else #1\fi\endgroup}
\r
363 \providecommand\textsuperscript[1]{\mbox{$^{\mbox{\scriptsize#1}}$}}
\r
364 \begingroup \catcode`\_=8
\r
365 \gdef\NAT@ifcat@num#1{%
\r
366 \ifcat_\ifnum\z@<0#1_\else A\fi
\r
367 \expandafter\@firstoftwo
\r
369 \expandafter\@secondoftwo
\r
373 \providecommand\@firstofone[1]{#1}
\r
374 \newcommand\NAT@citexnum{}
\r
375 \def\NAT@citexnum[#1][#2]#3{%
\r
377 \NAT@sort@cites{#3}%
\r
379 \@cite{\def\NAT@num{-1}\let\NAT@last@yr\relax\let\NAT@nm\@empty
\r
380 \@for\@citeb:=\NAT@cite@list\do
\r
381 {\@safe@activestrue
\r
382 \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}%
\r
383 \@safe@activesfalse
\r
384 \@ifundefined{b@\@citeb\@extra@b@citeb}{%
\r
385 {\reset@font\bfseries?}
\r
386 \NAT@citeundefined\PackageWarning{natbib}%
\r
387 {Citation `\@citeb' on page \thepage \space undefined}}%
\r
388 {\let\NAT@last@num\NAT@num\let\NAT@last@nm\NAT@nm
\r
389 \NAT@parse{\@citeb}%
\r
390 \ifNAT@longnames\@ifundefined{bv@\@citeb\@extra@b@citeb}{%
\r
391 \let\NAT@name=\NAT@all@names
\r
392 \global\@namedef{bv@\@citeb\@extra@b@citeb}{}}{}%
\r
394 \ifNAT@full\let\NAT@nm\NAT@all@names\else
\r
395 \let\NAT@nm\NAT@name\fi
\r
397 \@ifnum{\NAT@ctype>\@ne}{%
\r
399 \NAT@hyper@{\@ifnum{\NAT@ctype=\tw@}{\NAT@test{\NAT@ctype}}{\NAT@alias}}%
\r
401 \@ifnum{\NAT@cmprs>\z@}{%
\r
402 \NAT@ifcat@num\NAT@num
\r
403 {\let\NAT@nm=\NAT@num}%
\r
405 \NAT@ifcat@num\NAT@last@num
\r
406 {\@tempcnta=\NAT@last@num\relax}%
\r
408 \@ifnum{\NAT@nm=\@tempcnta}{%
\r
409 \@ifnum{\NAT@merge>\@ne}{}{\NAT@last@yr@mbox}%
\r
411 \advance\@tempcnta by\@ne
\r
412 \@ifnum{\NAT@nm=\@tempcnta}{%
\r
413 \ifx\NAT@last@yr\relax
\r
414 \def@NAT@last@yr{\@citea}%
\r
416 \def@NAT@last@yr{--\NAT@penalty}%
\r
424 \@ifnum{\NAT@merge>\@ne}{\@ifnum{\NAT@last@num=\NAT@num\relax}{\@tempswafalse}{}}{}%
\r
425 \if@tempswa\NAT@citea@mbox\fi
\r
431 \ifx\NAT@last@nm\NAT@nm \NAT@yrsep\NAT@penalty\NAT@space\else
\r
432 \@citea \NAT@test{\@ne}\NAT@spacechar\NAT@mbox{\NAT@super@kern\NAT@@open}%
\r
434 \if*#1*\else#1\NAT@spacechar\fi
\r
435 \NAT@mbox{\NAT@hyper@{{\citenumfont{\NAT@num}}}}%
\r
438 \NAT@hyper@citea@space{\NAT@test{\NAT@ctype}}%
\r
440 \NAT@hyper@citea@space{\NAT@test{\NAT@ctype}}%
\r
442 \NAT@hyper@citea@space\NAT@alias
\r
447 \@ifnum{\NAT@cmprs>\z@}{\NAT@last@yr}{}%
\r
449 \@ifnum{\NAT@ctype=\z@}{%
\r
450 \if*#2*\else\NAT@cmt#2\fi
\r
452 \NAT@mbox{\NAT@@close}%
\r
456 \def\NAT@citea@mbox{%
\r
457 \@citea\mbox{\NAT@hyper@{{\citenumfont{\NAT@num}}}}%
\r
459 \def\NAT@hyper@#1{%
\r
460 \hyper@natlinkstart{\@citeb\@extra@b@citeb}#1\hyper@natlinkend
\r
462 \def\NAT@hyper@citea#1{%
\r
467 \def\NAT@hyper@citea@space#1{%
\r
470 \NAT@def@citea@space
\r
472 \def\def@NAT@last@yr#1{%
\r
473 \protected@edef\NAT@last@yr{%
\r
476 \noexpand\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
\r
477 {\noexpand\citenumfont{\NAT@num}}%
\r
478 \noexpand\hyper@natlinkend
\r
482 \def\NAT@last@yr@mbox{%
\r
483 \NAT@last@yr\let\NAT@last@yr\relax
\r
486 \newcommand\NAT@test[1]{%
\r
488 \ifx\NAT@nm\NAT@noname
\r
489 \begingroup\reset@font\bfseries(author?)\endgroup
\r
490 \PackageWarning{natbib}{%
\r
491 Author undefined for citation`\@citeb' \MessageBreak on page \thepage%
\r
496 \if\relax\NAT@date\relax
\r
497 \begingroup\reset@font\bfseries(year?)\endgroup
\r
498 \PackageWarning{natbib}{%
\r
499 Year undefined for citation`\@citeb' \MessageBreak on page \thepage%
\r
505 \let\citenumfont=\@empty
\r
506 \newcommand\NAT@citex{}
\r
510 \NAT@sort@cites{#3}%
\r
512 \@cite{\let\NAT@nm\@empty\let\NAT@year\@empty
\r
513 \@for\@citeb:=\NAT@cite@list\do
\r
514 {\@safe@activestrue
\r
515 \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}%
\r
516 \@safe@activesfalse
\r
517 \@ifundefined{b@\@citeb\@extra@b@citeb}{\@citea%
\r
518 {\reset@font\bfseries ?}\NAT@citeundefined
\r
519 \PackageWarning{natbib}%
\r
520 {Citation `\@citeb' on page \thepage \space undefined}\def\NAT@date{}}%
\r
521 {\let\NAT@last@nm=\NAT@nm\let\NAT@last@yr=\NAT@year
\r
522 \NAT@parse{\@citeb}%
\r
523 \ifNAT@longnames\@ifundefined{bv@\@citeb\@extra@b@citeb}{%
\r
524 \let\NAT@name=\NAT@all@names
\r
525 \global\@namedef{bv@\@citeb\@extra@b@citeb}{}}{}%
\r
527 \ifNAT@full\let\NAT@nm\NAT@all@names\else
\r
528 \let\NAT@nm\NAT@name\fi
\r
529 \ifNAT@swa\ifcase\NAT@ctype
\r
530 \if\relax\NAT@date\relax
\r
531 \@citea\NAT@hyper@{\NAT@nmfmt{\NAT@nm}\NAT@date}%
\r
533 \ifx\NAT@last@nm\NAT@nm\NAT@yrsep
\r
534 \ifx\NAT@last@yr\NAT@year
\r
535 \def\NAT@temp{{?}}%
\r
536 \ifx\NAT@temp\NAT@exlab\PackageWarningNoLine{natbib}%
\r
537 {Multiple citation on page \thepage: same authors and
\r
538 year\MessageBreak without distinguishing extra
\r
539 letter,\MessageBreak appears as question mark}\fi
\r
540 \NAT@hyper@{\NAT@exlab}%
\r
541 \else\unskip\NAT@spacechar
\r
542 \NAT@hyper@{\NAT@date}%
\r
545 \@citea\NAT@hyper@{%
\r
546 \NAT@nmfmt{\NAT@nm}%
\r
547 \hyper@natlinkbreak{%
\r
548 \NAT@aysep\NAT@spacechar}{\@citeb\@extra@b@citeb
\r
554 \or\@citea\NAT@hyper@{\NAT@nmfmt{\NAT@nm}}%
\r
555 \or\@citea\NAT@hyper@{\NAT@date}%
\r
556 \or\@citea\NAT@hyper@{\NAT@alias}%
\r
560 \if\relax\NAT@date\relax
\r
561 \@citea\NAT@hyper@{\NAT@nmfmt{\NAT@nm}}%
\r
563 \ifx\NAT@last@nm\NAT@nm\NAT@yrsep
\r
564 \ifx\NAT@last@yr\NAT@year
\r
565 \def\NAT@temp{{?}}%
\r
566 \ifx\NAT@temp\NAT@exlab\PackageWarningNoLine{natbib}%
\r
567 {Multiple citation on page \thepage: same authors and
\r
568 year\MessageBreak without distinguishing extra
\r
569 letter,\MessageBreak appears as question mark}\fi
\r
570 \NAT@hyper@{\NAT@exlab}%
\r
572 \unskip\NAT@spacechar
\r
573 \NAT@hyper@{\NAT@date}%
\r
576 \@citea\NAT@hyper@{%
\r
577 \NAT@nmfmt{\NAT@nm}%
\r
578 \hyper@natlinkbreak{\NAT@spacechar\NAT@@open\if*#1*\else#1\NAT@spacechar\fi}%
\r
579 {\@citeb\@extra@b@citeb}%
\r
584 \or\@citea\NAT@hyper@{\NAT@nmfmt{\NAT@nm}}%
\r
585 \or\@citea\NAT@hyper@{\NAT@date}%
\r
586 \or\@citea\NAT@hyper@{\NAT@alias}%
\r
588 \if\relax\NAT@date\relax
\r
591 \NAT@def@citea@close
\r
594 }}\ifNAT@swa\else\if*#2*\else\NAT@cmt#2\fi
\r
595 \if\relax\NAT@date\relax\else\NAT@@close\fi\fi}{#1}{#2}}
\r
596 \def\NAT@spacechar{\ }%
\r
597 \def\NAT@separator{\NAT@sep\NAT@penalty}%
\r
598 \def\NAT@reset@citea{\c@NAT@ctr\@ne\let\@citea\@empty}%
\r
599 \def\NAT@def@citea{\def\@citea{\NAT@separator\NAT@space}}%
\r
600 \def\NAT@def@citea@space{\def\@citea{\NAT@separator\NAT@spacechar}}%
\r
601 \def\NAT@def@citea@close{\def\@citea{\NAT@@close\NAT@separator\NAT@space}}%
\r
602 \def\NAT@def@citea@box{\def\@citea{\NAT@mbox{\NAT@@close}\NAT@separator\NAT@spacechar}}%
\r
603 \newif\ifNAT@par \NAT@partrue
\r
604 \newcommand\NAT@@open{\ifNAT@par\NAT@open\fi}
\r
605 \newcommand\NAT@@close{\ifNAT@par\NAT@close\fi}
\r
606 \newcommand\NAT@alias{\@ifundefined{al@\@citeb\@extra@b@citeb}{%
\r
607 {\reset@font\bfseries(alias?)}\PackageWarning{natbib}
\r
608 {Alias undefined for citation `\@citeb'
\r
609 \MessageBreak on page \thepage}}{\@nameuse{al@\@citeb\@extra@b@citeb}}}
\r
611 \newcommand\NAT@Up[1]{{\let\protect\@unexpandable@protect\let~\relax
\r
612 \expandafter\NAT@deftemp#1}\expandafter\NAT@UP\NAT@temp}
\r
613 \newcommand\NAT@deftemp[1]{\xdef\NAT@temp{#1}}
\r
614 \newcommand\NAT@UP[1]{\let\@tempa\NAT@UP\ifcat a#1\MakeUppercase{#1}%
\r
615 \let\@tempa\relax\else#1\fi\@tempa}
\r
616 \newcommand\shortcites[1]{%
\r
617 \@bsphack\@for\@citeb:=#1\do
\r
618 {\@safe@activestrue
\r
619 \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}%
\r
620 \@safe@activesfalse
\r
621 \global\@namedef{bv@\@citeb\@extra@b@citeb}{}}\@esphack}
\r
622 \newcommand\NAT@biblabel[1]{\hfill}
\r
623 \newcommand\NAT@biblabelnum[1]{\bibnumfmt{#1}}
\r
624 \let\bibnumfmt\@empty
\r
625 \providecommand\@biblabel[1]{[#1]}
\r
626 \AtBeginDocument{\ifx\bibnumfmt\@empty\let\bibnumfmt\@biblabel\fi}
\r
627 \newcommand\NAT@bibsetnum[1]{\settowidth\labelwidth{\@biblabel{#1}}%
\r
628 \setlength{\leftmargin}{\labelwidth}\addtolength{\leftmargin}{\labelsep}%
\r
629 \setlength{\itemsep}{\bibsep}\setlength{\parsep}{\z@}%
\r
631 \addtolength{\leftmargin}{\bibindent}%
\r
632 \setlength{\itemindent}{-\bibindent}%
\r
633 \setlength{\listparindent}{\itemindent}%
\r
634 \setlength{\parsep}{0pt}%
\r
637 \newlength{\bibhang}
\r
638 \setlength{\bibhang}{1em}
\r
639 \newlength{\bibsep}
\r
640 {\@listi \global\bibsep\itemsep \global\advance\bibsep by\parsep}
\r
642 \newcommand\NAT@bibsetup%
\r
643 [1]{\setlength{\leftmargin}{\bibhang}\setlength{\itemindent}{-\leftmargin}%
\r
644 \setlength{\itemsep}{\bibsep}\setlength{\parsep}{\z@}}
\r
645 \newcommand\NAT@set@cites{%
\r
647 \ifNAT@super \let\@cite\NAT@citesuper
\r
648 \def\NAT@mbox##1{\unskip\nobreak\textsuperscript{##1}}%
\r
649 \let\citeyearpar=\citeyear
\r
650 \let\NAT@space\relax
\r
651 \def\NAT@super@kern{\kern\p@}%
\r
653 \let\NAT@mbox=\mbox
\r
654 \let\@cite\NAT@citenum
\r
655 \let\NAT@space\NAT@spacechar
\r
656 \let\NAT@super@kern\relax
\r
658 \let\@citex\NAT@citexnum
\r
659 \let\@biblabel\NAT@biblabelnum
\r
660 \let\@bibsetup\NAT@bibsetnum
\r
661 \renewcommand\NAT@idxtxt{\NAT@name\NAT@spacechar\NAT@open\NAT@num\NAT@close}%
\r
662 \def\natexlab##1{}%
\r
663 \def\NAT@penalty{\penalty\@m}%
\r
665 \let\@cite\NAT@cite
\r
666 \let\@citex\NAT@citex
\r
667 \let\@biblabel\NAT@biblabel
\r
668 \let\@bibsetup\NAT@bibsetup
\r
669 \let\NAT@space\NAT@spacechar
\r
670 \let\NAT@penalty\@empty
\r
671 \renewcommand\NAT@idxtxt{\NAT@name\NAT@spacechar\NAT@open\NAT@date\NAT@close}%
\r
672 \def\natexlab##1{##1}%
\r
674 \AtBeginDocument{\NAT@set@cites}
\r
675 \AtBeginDocument{\ifx\SK@def\@undefined\else
\r
676 \ifx\SK@cite\@empty\else
\r
677 \SK@def\@citex[#1][#2]#3{\SK@\SK@@ref{#3}\SK@@citex[#1][#2]{#3}}\fi
\r
678 \ifx\SK@citeauthor\@undefined\def\HAR@checkdef{}\else
\r
679 \let\citeauthor\SK@citeauthor
\r
680 \let\citefullauthor\SK@citefullauthor
\r
681 \let\citeyear\SK@citeyear\fi
\r
683 \newif\ifNAT@full\NAT@fullfalse
\r
685 \DeclareRobustCommand\citet
\r
686 {\begingroup\NAT@swafalse\let\NAT@ctype\z@\NAT@partrue
\r
687 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
688 \newcommand\NAT@citetp{\@ifnextchar[{\NAT@@citetp}{\NAT@@citetp[]}}
\r
689 \newcommand\NAT@@citetp{}
\r
690 \def\NAT@@citetp[#1]{\@ifnextchar[{\@citex[#1]}{\@citex[][#1]}}
\r
691 \DeclareRobustCommand\citep
\r
692 {\begingroup\NAT@swatrue\let\NAT@ctype\z@\NAT@partrue
\r
693 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
694 \DeclareRobustCommand\cite
\r
695 {\begingroup\let\NAT@ctype\z@\NAT@partrue\NAT@swatrue
\r
696 \@ifstar{\NAT@fulltrue\NAT@cites}{\NAT@fullfalse\NAT@cites}}
\r
697 \newcommand\NAT@cites{\@ifnextchar [{\NAT@@citetp}{%
\r
698 \ifNAT@numbers\else
\r
702 \DeclareRobustCommand\citealt
\r
703 {\begingroup\NAT@swafalse\let\NAT@ctype\z@\NAT@parfalse
\r
704 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
705 \DeclareRobustCommand\citealp
\r
706 {\begingroup\NAT@swatrue\let\NAT@ctype\z@\NAT@parfalse
\r
707 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
708 \DeclareRobustCommand\citenum
\r
710 \NAT@swatrue\let\NAT@ctype\z@\NAT@parfalse\let\textsuperscript\NAT@spacechar
\r
712 \DeclareRobustCommand\citeauthor
\r
713 {\begingroup\NAT@swafalse\let\NAT@ctype\@ne\NAT@parfalse
\r
714 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
715 \DeclareRobustCommand\Citet
\r
716 {\begingroup\NAT@swafalse\let\NAT@ctype\z@\NAT@partrue
\r
718 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
719 \DeclareRobustCommand\Citep
\r
720 {\begingroup\NAT@swatrue\let\NAT@ctype\z@\NAT@partrue
\r
722 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
723 \DeclareRobustCommand\Citealt
\r
724 {\begingroup\NAT@swafalse\let\NAT@ctype\z@\NAT@parfalse
\r
726 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
727 \DeclareRobustCommand\Citealp
\r
728 {\begingroup\NAT@swatrue\let\NAT@ctype\z@\NAT@parfalse
\r
730 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
731 \DeclareRobustCommand\Citeauthor
\r
732 {\begingroup\NAT@swafalse\let\NAT@ctype\@ne\NAT@parfalse
\r
734 \@ifstar{\NAT@fulltrue\NAT@citetp}{\NAT@fullfalse\NAT@citetp}}
\r
735 \DeclareRobustCommand\citeyear
\r
736 {\begingroup\NAT@swafalse\let\NAT@ctype\tw@\NAT@parfalse\NAT@citetp}
\r
737 \DeclareRobustCommand\citeyearpar
\r
738 {\begingroup\NAT@swatrue\let\NAT@ctype\tw@\NAT@partrue\NAT@citetp}
\r
739 \newcommand\citetext[1]{\NAT@open#1\NAT@close}
\r
740 \DeclareRobustCommand\citefullauthor
\r
742 \newcommand\defcitealias[2]{%
\r
743 \@ifundefined{al@#1\@extra@b@citeb}{}
\r
744 {\PackageWarning{natbib}{Overwriting existing alias for citation #1}}
\r
745 \@namedef{al@#1\@extra@b@citeb}{#2}}
\r
746 \DeclareRobustCommand\citetalias{\begingroup
\r
747 \NAT@swafalse\let\NAT@ctype\thr@@\NAT@parfalse\NAT@citetp}
\r
748 \DeclareRobustCommand\citepalias{\begingroup
\r
749 \NAT@swatrue\let\NAT@ctype\thr@@\NAT@partrue\NAT@citetp}
\r
750 \renewcommand\nocite[1]{\@bsphack
\r
751 \@for\@citeb:=#1\do{%
\r
753 \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}%
\r
754 \@safe@activesfalse
\r
755 \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi
\r
757 \@ifundefined{b@\@citeb\@extra@b@citeb}{%
\r
758 \NAT@citeundefined \PackageWarning{natbib}%
\r
759 {Citation `\@citeb' undefined}}{}\fi}%
\r
761 \newcommand\NAT@parse[1]{%
\r
763 \let\protect=\@unexpandable@protect
\r
765 \let\active@prefix=\@gobble
\r
766 \edef\NAT@temp{\csname b@#1\@extra@b@citeb\endcsname}%
\r
767 \aftergroup\NAT@split
\r
770 \NAT@temp{}{}{}{}{}@@%
\r
771 \expandafter\NAT@parse@date\NAT@date??????@@%
\r
772 \ifciteindex\NAT@index\fi
\r
774 \def\NAT@split#1#2#3#4#5@@{%
\r
775 \gdef\NAT@num{#1}\gdef\NAT@name{#3}\gdef\NAT@date{#2}%
\r
776 \gdef\NAT@all@names{#4}%
\r
777 \ifx\NAT@num\@empty\gdef\NAT@num{0}\fi
\r
778 \ifx\NAT@noname\NAT@all@names \gdef\NAT@all@names{#3}\fi
\r
780 \def\NAT@reset@parser{%
\r
781 \global\let\NAT@num\@empty
\r
782 \global\let\NAT@name\@empty
\r
783 \global\let\NAT@date\@empty
\r
784 \global\let\NAT@all@names\@empty
\r
786 \newcommand\NAT@parse@date{}
\r
787 \def\NAT@parse@date#1#2#3#4#5#6@@{%
\r
788 \ifnum\the\catcode`#1=11\def\NAT@year{}\def\NAT@exlab{#1}\else
\r
789 \ifnum\the\catcode`#2=11\def\NAT@year{#1}\def\NAT@exlab{#2}\else
\r
790 \ifnum\the\catcode`#3=11\def\NAT@year{#1#2}\def\NAT@exlab{#3}\else
\r
791 \ifnum\the\catcode`#4=11\def\NAT@year{#1#2#3}\def\NAT@exlab{#4}\else
\r
792 \def\NAT@year{#1#2#3#4}\def\NAT@exlab{{#5}}\fi\fi\fi\fi}
\r
793 \newcommand\NAT@index{}
\r
794 \let\NAT@makeindex=\makeindex
\r
795 \renewcommand\makeindex{\NAT@makeindex
\r
796 \renewcommand\NAT@index{\@bsphack\begingroup
\r
797 \def~{\string~}\@wrindex{\NAT@idxtxt}}}
\r
798 \newcommand\NAT@idxtxt{\NAT@name\NAT@spacechar\NAT@open\NAT@date\NAT@close}
\r
799 \@ifxundefined\@indexfile{}{\let\NAT@makeindex\relax\makeindex}
\r
800 \newif\ifciteindex \citeindexfalse
\r
801 \newcommand\citeindextype{default}
\r
802 \newcommand\NAT@index@alt{{\let\protect=\noexpand\let~\relax
\r
803 \xdef\NAT@temp{\NAT@idxtxt}}\expandafter\NAT@exp\NAT@temp\@nil}
\r
804 \newcommand\NAT@exp{}
\r
805 \def\NAT@exp#1\@nil{\index[\citeindextype]{#1}}
\r
808 \@ifpackageloaded{index}{\let\NAT@index=\NAT@index@alt}{}}
\r
809 \newcommand\NAT@ifcmd{\futurelet\NAT@temp\NAT@ifxcmd}
\r
810 \newcommand\NAT@ifxcmd{\ifx\NAT@temp\relax\else\expandafter\NAT@bare\fi}
\r
811 \def\NAT@bare#1(#2)#3(@)#4\@nil#5{%
\r
813 \expandafter\NAT@apalk#1, , \@nil{#5}%
\r
815 \NAT@wrout{\the\c@NAT@ctr}{#2}{#1}{#3}{#5}%
\r
818 \newcommand\NAT@wrout[5]{%
\r
820 {\let\protect\noexpand\let~\relax
\r
822 \write\@auxout{\string\bibcite{#5}{{#1}{#2}{{#3}}{{#4}}}}}\fi
\r
824 \def\NAT@noname{{}}
\r
825 \renewcommand\bibitem{\@ifnextchar[{\@lbibitem}{\@lbibitem[]}}%
\r
826 \let\NAT@bibitem@first@sw\@secondoftwo
\r
827 \def\@lbibitem[#1]#2{%
\r
828 \if\relax\@extra@b@citeb\relax\else
\r
829 \@ifundefined{br@#2\@extra@b@citeb}{}{%
\r
830 \@namedef{br@#2}{\@nameuse{br@#2\@extra@b@citeb}}%
\r
833 \@ifundefined{b@#2\@extra@b@citeb}{%
\r
839 \expandafter\let\expandafter\bibitemOpen\csname NAT@b@open@#2\endcsname
\r
840 \expandafter\let\expandafter\bibitemShut\csname NAT@b@shut@#2\endcsname
\r
841 \@ifnum{\NAT@merge>\@ne}{%
\r
842 \NAT@bibitem@first@sw{%
\r
845 \@ifundefined{NAT@b*@#2}{%
\r
848 \expandafter\def\expandafter\NAT@num\expandafter{\the\c@NAT@ctr}%
\r
856 \global\advance\c@NAT@ctr\@ne
\r
857 \@ifx{\NAT@tmp\@empty}{\@firstoftwo}{%
\r
861 \expandafter\def\expandafter\NAT@num\expandafter{\the\c@NAT@ctr}%
\r
862 \global\NAT@stdbsttrue
\r
865 \item[\hfil\NAT@anchor{#2}{\NAT@num}]%
\r
866 \global\let\NAT@bibitem@first@sw\@secondoftwo
\r
874 \@ifx{\NAT@tmp\@empty}{%
\r
875 \NAT@wrout{\the\c@NAT@ctr}{}{}{}{#2}%
\r
877 \expandafter\NAT@ifcmd\NAT@tmp(@)(@)\@nil{#2}%
\r
881 \@ifxundefined\@bibstop{}{\csname bibitem@\@bibstop\endcsname}%
\r
883 \def\NAT@bibitem@init{%
\r
884 \let\@bibstop\@undefined
\r
886 \def\NAT@bibitem@cont{%
\r
887 \let\bibitem@Stop\bibitemContinue
\r
888 \let\bibitem@NoStop\bibitemContinue
\r
893 \def\BibitemShut#1{%
\r
895 \let\bibitem@Stop\bibitemStop
\r
896 \let\bibitem@NoStop\bibitemNoStop
\r
897 \@ifx{\bibitemShut\relax}{\let\@bibitemShut\@empty}{%
\r
898 \expandafter\def\expandafter\@bibitemShut\expandafter{\bibitemShut}%
\r
901 \def\@bibitemShut{}%
\r
902 \def\bibitemStop{\@bibitemShut}%
\r
903 \def\bibitemNoStop{%
\r
904 \@ifx{\@empty\@bibitemShut}{.\spacefactor\@mmm\space}{\@bibitemShut}%
\r
906 \def\bibitemContinue{%
\r
907 \@ifx{\@empty\@bibitemShut}{;\spacefactor\@mmm\space}{\@bibitemShut}%
\r
909 \mathchardef\@mmm=3000 %
\r
910 \let\bibitemOpen\relax
\r
911 \let\bibitemShut\relax
\r
912 \@ifnum{\NAT@merge>\@ne}{%
\r
913 \providecommand{\bibAnnote}[3]{%
\r
915 \def\@tempa{#3}\@ifx{\@tempa\@empty}{}{%
\r
916 \begin{quotation}\noindent
\r
917 \textsc{Key:}\ #2\\\textsc{Annotation:}\ \@tempa
\r
922 \providecommand{\bibAnnoteFile}[2]{%
\r
923 \IfFileExists{#2}{%
\r
924 \bibAnnote{#1}{#2}{\input{#2}}%
\r
926 \bibAnnote{#1}{#2}{}%
\r
930 \def\bibfield{\@ifnum{\NAT@merge>\tw@}{\@bibfield}{\@secondoftwo}}%
\r
931 \def\@bibfield#1#2{%
\r
935 \let\restore@protect\@empty
\r
936 \protected@edef\@tempa{#2}%
\r
937 \aftergroup\def\aftergroup\@tempa
\r
938 \expandafter\endgroup\expandafter{\@tempa}%
\r
939 \expandafter\@ifx\expandafter{\csname @bib#1\endcsname\@tempa}{%
\r
940 \expandafter\let\expandafter\@tempa\csname @bib@X#1\endcsname
\r
942 \expandafter\let\csname @bib#1\endcsname\@tempa
\r
943 \expandafter\let\expandafter\@tempa\csname @bib@Y#1\endcsname
\r
945 \@ifx{\@tempa\relax}{\let\@tempa\@firstofone}{}%
\r
949 \expandafter\let\expandafter\@tempa\csname bibinfo@X@#1\endcsname
\r
950 \@ifx{\@tempa\relax}{\@firstofone}{\@tempa}%
\r
952 \def\@bib@Xauthor#1{\let\@bib@Xjournal\@gobble}%
\r
953 \def\@bib@Xjournal#1{\begingroup\let\bibinfo@X@journal\@bib@Z@journal#1\endgroup}%
\r
954 \def\@bibibid@#1{\textit{ibid}.}%
\r
955 \appdef\NAT@bibitem@init{%
\r
956 \let\@bibauthor \@empty
\r
957 \let\@bibjournal \@empty
\r
958 \let\@bib@Z@journal\@bibibid@
\r
960 \ifx\SK@lbibitem\@undefined\else
\r
961 \let\SK@lbibitem\@lbibitem
\r
962 \def\@lbibitem[#1]#2{%
\r
963 \SK@lbibitem[#1]{#2}\SK@\SK@@label{#2}\ignorespaces}\fi
\r
964 \newif\ifNAT@stdbst \NAT@stdbstfalse
\r
967 \ifNAT@stdbst\if@filesw
\r
968 \immediate\write\@auxout{%
\r
969 \string\providecommand\string\NAT@force@numbers{}%
\r
970 \string\NAT@force@numbers
\r
974 \newcommand\NAT@force@numbers{%
\r
975 \ifNAT@numbers\else
\r
976 \PackageError{natbib}{Bibliography not compatible with author-year
\r
977 citations.\MessageBreak
\r
978 Press <return> to continue in numerical citation style}
\r
979 {Check the bibliography entries for non-compliant syntax,\MessageBreak
\r
980 or select author-year BibTeX style, e.g. plainnat}%
\r
981 \global\NAT@numberstrue\fi}
\r
983 \providecommand\bibcite{}
\r
984 \renewcommand\bibcite[2]{%
\r
985 \@ifundefined{b@#1\@extra@binfo}{\relax}{%
\r
987 \PackageWarningNoLine{natbib}{Citation `#1' multiply defined}%
\r
989 \global\@namedef{b@#1\@extra@binfo}{#2}%
\r
991 \AtEndDocument{\NAT@swatrue\let\bibcite\NAT@testdef}
\r
992 \newcommand\NAT@testdef[2]{%
\r
994 \expandafter \ifx \csname b@#1\@extra@binfo\endcsname\NAT@temp
\r
996 \ifNAT@swa \NAT@swafalse
\r
997 \PackageWarningNoLine{natbib}{%
\r
998 Citation(s) may have changed.\MessageBreak
\r
999 Rerun to get citations correct%
\r
1004 \newcommand\NAT@apalk{}
\r
1005 \def\NAT@apalk#1, #2, #3\@nil#4{%
\r
1007 \global\NAT@stdbsttrue
\r
1008 \NAT@wrout{#1}{}{}{}{#4}%
\r
1010 \NAT@wrout{\the\c@NAT@ctr}{#2}{#1}{}{#4}%
\r
1013 \newcommand\citeauthoryear{}
\r
1014 \def\citeauthoryear#1#2#3(@)(@)\@nil#4{%
\r
1016 \NAT@wrout{\the\c@NAT@ctr}{#2}{#1}{}{#4}%
\r
1018 \NAT@wrout{\the\c@NAT@ctr}{#3}{#2}{#1}{#4}%
\r
1021 \newcommand\citestarts{\NAT@open}%
\r
1022 \newcommand\citeends{\NAT@close}%
\r
1023 \newcommand\betweenauthors{and}%
\r
1024 \newcommand\astroncite{}
\r
1025 \def\astroncite#1#2(@)(@)\@nil#3{%
\r
1026 \NAT@wrout{\the\c@NAT@ctr}{#2}{#1}{}{#3}%
\r
1028 \newcommand\citename{}
\r
1029 \def\citename#1#2(@)(@)\@nil#3{\expandafter\NAT@apalk#1#2, \@nil{#3}}
\r
1030 \newcommand\harvarditem[4][]{%
\r
1032 \bibitem[#2(#3)]{#4}%
\r
1034 \bibitem[#1(#3)#2]{#4}%
\r
1037 \newcommand\harvardleft{\NAT@open}
\r
1038 \newcommand\harvardright{\NAT@close}
\r
1039 \newcommand\harvardyearleft{\NAT@open}
\r
1040 \newcommand\harvardyearright{\NAT@close}
\r
1041 \AtBeginDocument{\providecommand{\harvardand}{and}}
\r
1042 \newcommand\harvardurl[1]{\textbf{URL:} \textit{#1}}
\r
1043 \providecommand\bibsection{}
\r
1044 \@ifundefined{chapter}{%
\r
1045 \renewcommand\bibsection{%
\r
1046 \section*{\refname\@mkboth{\MakeUppercase{\refname}}{\MakeUppercase{\refname}}}%
\r
1049 \@ifxundefined\NAT@sectionbib{%
\r
1050 \renewcommand\bibsection{%
\r
1051 \chapter*{\bibname\@mkboth{\MakeUppercase{\bibname}}{\MakeUppercase{\bibname}}}%
\r
1054 \renewcommand\bibsection{%
\r
1055 \section*{\bibname\ifx\@mkboth\@gobbletwo\else\markright{\MakeUppercase{\bibname}}\fi}%
\r
1059 \@ifclassloaded{amsart}{\renewcommand\bibsection{\section*{\refname}}}{}%
\r
1060 \@ifclassloaded{amsbook}{\renewcommand\bibsection{\chapter*{\bibname}}}{}%
\r
1061 \@ifxundefined\bib@heading{}{\let\bibsection\bib@heading}%
\r
1062 \newcounter{NAT@ctr}
\r
1063 \renewenvironment{thebibliography}[1]{%
\r
1068 \list{\@biblabel{\the\c@NAT@ctr}}{\@bibsetup{#1}\global\c@NAT@ctr\z@}%
\r
1070 \renewcommand\newblock{\par}%
\r
1072 \renewcommand\newblock{\hskip .11em \@plus.33em \@minus.07em}%
\r
1074 \sloppy\clubpenalty4000\widowpenalty4000
\r
1076 \let\NAT@bibitem@first@sw\@firstoftwo
\r
1077 \let\citeN\cite \let\shortcite\cite
\r
1078 \let\citeasnoun\cite
\r
1083 \PackageWarning{natbib}{Empty `thebibliography' environment}%
\r
1088 \let\bibfont\@empty
\r
1089 \let\bibpreamble\@empty
\r
1090 \let\bibpostamble\@empty
\r
1091 \def\bibcleanup{\vskip-\lastskip}%
\r
1092 \providecommand\reset@font{\relax}
\r
1093 \providecommand\bibname{Bibliography}
\r
1094 \providecommand\refname{References}
\r
1095 \newcommand\NAT@citeundefined{\gdef \NAT@undefined {%
\r
1096 \PackageWarningNoLine{natbib}{There were undefined citations}}}
\r
1097 \let \NAT@undefined \relax
\r
1098 \newcommand\NAT@citemultiple{\gdef \NAT@multiple {%
\r
1099 \PackageWarningNoLine{natbib}{There were multiply defined citations}}}
\r
1100 \let \NAT@multiple \relax
\r
1101 \AtEndDocument{\NAT@undefined\NAT@multiple}
\r
1102 \providecommand\@mkboth[2]{}
\r
1103 \providecommand\MakeUppercase{\uppercase}
\r
1104 \providecommand{\@extra@b@citeb}{}
\r
1105 \gdef\@extra@binfo{}
\r
1106 \def\NAT@anchor#1#2{%
\r
1107 \hyper@natanchorstart{#1\@extra@b@citeb}%
\r
1108 \def\@tempa{#2}\@ifx{\@tempa\@empty}{}{\@biblabel{#2}}%
\r
1109 \hyper@natanchorend
\r
1111 \providecommand\hyper@natanchorstart[1]{}%
\r
1112 \providecommand\hyper@natanchorend{}%
\r
1113 \providecommand\hyper@natlinkstart[1]{}%
\r
1114 \providecommand\hyper@natlinkend{}%
\r
1115 \providecommand\hyper@natlinkbreak[2]{#1}%
\r
1116 \AtBeginDocument{%
\r
1117 \@ifpackageloaded{babel}{%
\r
1118 \let\org@@citex\@citex}{}}
\r
1119 \providecommand\@safe@activestrue{}%
\r
1120 \providecommand\@safe@activesfalse{}%
\r
1122 \newcommand\NAT@sort@cites[1]{%
\r
1123 \let\NAT@cite@list\@empty
\r
1124 \@for\@citeb:=#1\do{\expandafter\NAT@star@cite\@citeb\@@}%
\r
1126 \expandafter\immediate\expandafter\write\expandafter\@auxout
\r
1127 \expandafter{\expandafter\string\expandafter\citation\expandafter{\NAT@cite@list}}%
\r
1129 \@ifnum{\NAT@sort>\z@}{%
\r
1130 \expandafter\NAT@sort@cites@\expandafter{\NAT@cite@list}%
\r
1133 \def\NAT@star@cite{%
\r
1134 \let\NAT@star@sw\@secondoftwo
\r
1135 \@ifnum{\NAT@merge>\z@}{%
\r
1137 \let\NAT@star@sw\@firstoftwo
\r
1138 \NAT@star@cite@star
\r
1140 \NAT@star@cite@nostar
\r
1143 \NAT@star@cite@noextension
\r
1146 \def\NAT@star@cite@star*{%
\r
1147 \NAT@star@cite@nostar
\r
1149 \def\NAT@star@cite@nostar{%
\r
1150 \let\nat@keyopt@open\@empty
\r
1151 \let\nat@keyopt@shut\@empty
\r
1152 \@ifnextchar[{\NAT@star@cite@pre}{\NAT@star@cite@pre[]}%
\r
1154 \def\NAT@star@cite@pre[#1]{%
\r
1155 \def\nat@keyopt@open{#1}%
\r
1156 \@ifnextchar[{\NAT@star@cite@post}{\NAT@star@cite@post[]}%
\r
1158 \def\NAT@star@cite@post[#1]#2\@@{%
\r
1159 \def\nat@keyopt@shut{#1}%
\r
1160 \NAT@star@sw{\expandafter\global\expandafter\let\csname NAT@b*@#2\endcsname\@empty}{}%
\r
1161 \NAT@cite@list@append{#2}%
\r
1163 \def\NAT@star@cite@noextension#1\@@{%
\r
1164 \let\nat@keyopt@open\@empty
\r
1165 \let\nat@keyopt@shut\@empty
\r
1166 \NAT@cite@list@append{#1}%
\r
1168 \def\NAT@cite@list@append#1{%
\r
1169 \edef\@citeb{\@firstofone#1\@empty}%
\r
1170 \if@filesw\@ifxundefined\@cprwrite{}{\expandafter\@cprwrite\@citeb=}\fi
\r
1171 \if\relax\nat@keyopt@open\relax\else
\r
1172 \global\expandafter\let\csname NAT@b@open@\@citeb\endcsname\nat@keyopt@open
\r
1174 \if\relax\nat@keyopt@shut\relax\else
\r
1175 \global\expandafter\let\csname NAT@b@shut@\@citeb\endcsname\nat@keyopt@shut
\r
1177 \toks@\expandafter{\NAT@cite@list}%
\r
1178 \ifx\NAT@cite@list\@empty
\r
1179 \@temptokena\expandafter{\@citeb}%
\r
1181 \@temptokena\expandafter{\expandafter,\@citeb}%
\r
1183 \edef\NAT@cite@list{\the\toks@\the\@temptokena}%
\r
1185 \newcommand\NAT@sort@cites@[1]{%
\r
1188 \let\@celt\delimiter
\r
1189 \def\NAT@num@list{}%
\r
1190 \let\NAT@cite@list\@empty
\r
1191 \let\NAT@nonsort@list\@empty
\r
1192 \@for \@citeb:=#1\do{\NAT@make@cite@list}%
\r
1193 \ifx\NAT@nonsort@list\@empty\else
\r
1194 \protected@edef\NAT@cite@list{\NAT@cite@list\NAT@nonsort@list}%
\r
1196 \ifx\NAT@cite@list\@empty\else
\r
1197 \protected@edef\NAT@cite@list{\expandafter\NAT@xcom\NAT@cite@list @@}%
\r
1200 \def\NAT@make@cite@list{%
\r
1201 \advance\count@\@ne
\r
1202 \@safe@activestrue
\r
1203 \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}%
\r
1204 \@safe@activesfalse
\r
1205 \@ifundefined{b@\@citeb\@extra@b@citeb}%
\r
1206 {\def\NAT@num{A}}%
\r
1207 {\NAT@parse{\@citeb}}%
\r
1208 \NAT@ifcat@num\NAT@num
\r
1209 {\@tempcnta\NAT@num \relax
\r
1210 \@ifnum{\@tempcnta<\@tempcntb}{%
\r
1211 \let\NAT@@cite@list=\NAT@cite@list
\r
1212 \let\NAT@cite@list\@empty
\r
1213 \begingroup\let\@celt=\NAT@celt\NAT@num@list\endgroup
\r
1214 \protected@edef\NAT@num@list{%
\r
1215 \expandafter\NAT@num@celt \NAT@num@list \@gobble @%
\r
1218 \protected@edef\NAT@num@list{\NAT@num@list \@celt{\NAT@num}}%
\r
1219 \protected@edef\NAT@cite@list{\NAT@cite@list\@citeb,}%
\r
1220 \@tempcntb\@tempcnta
\r
1223 {\protected@edef\NAT@nonsort@list{\NAT@nonsort@list\@citeb,}}%
\r
1226 \@ifnum{#1>\@tempcnta}{%
\r
1227 \xdef\NAT@cite@list{\NAT@cite@list\@citeb,\NAT@@cite@list}%
\r
1228 \let\@celt\@gobble
\r
1230 \expandafter\def@NAT@cite@lists\NAT@@cite@list\@@
\r
1233 \def\NAT@num@celt#1#2{%
\r
1235 \@ifnum{#2>\@tempcnta}{%
\r
1236 \@celt{\number\@tempcnta}%
\r
1240 \expandafter\NAT@num@celt
\r
1244 \def\def@NAT@cite@lists#1,#2\@@{%
\r
1245 \xdef\NAT@cite@list{\NAT@cite@list#1,}%
\r
1246 \xdef\NAT@@cite@list{#2}%
\r
1248 \def\NAT@nextc#1,#2@@{#1,}
\r
1249 \def\NAT@restc#1,#2{#2}
\r
1250 \def\NAT@xcom#1,@@{#1}
\r
1251 \InputIfFileExists{natbib.cfg}
\r
1252 {\typeout{Local config file natbib.cfg used}}{}
\r
1254 %% <<<<< End of generated file <<<<<<
\r
1256 %% End of file `natbib.sty'.
\r
