%% %% This is file `natbib.sty', %% generated with the docstrip utility. %% %% The original source files were: %% %% natbib.dtx (with options: `package,all') %% %% Full documentation can be obtained by LaTeXing the source file: %% natbib.dtx. %% %% Only a few abbreviated comments remain here to describe the usage. %% \NeedsTeXFormat{LaTeX2e}[1994/06/01] \ProvidesPackage{natbib} [1998/02/19 6.8 (PWD)] %%------------------------------------------------------------------- %% NOTICE: %% This file may be used for non-profit purposes. %% It may not be distributed in exchange for money, %% other than distribution costs. %% %% The author provides it `as is' and does not guarantee it in any way. %% %% Natbib coding copyright (C) 1994--1998 Patrick W. Daly %% Max-Planck-Institut f\"ur Aeronomie %% Max-Planck-Str. 2 %% D-37191 Katlenburg-Lindau %% Germany %% %% E-mail: daly@linmpi.mpg.de %%----------------------------------------------------------- % This package reimplements the LaTeX \cite command to be used for various % citation styles, both author-year and numerical. It accepts BibTeX % output intended for many other packages, and therefore acts as a % general, all-purpose citation-style interface. % % With standard numerical .bst files, only numerical citations are % possible. With an author-year .bst file, both numerical and % author-year citations are possible. % % If author-year citations are selected, \bibitem must have one of the % following forms: % \bibitem[Jones et al.(1990)]{key}... % \bibitem[Jones et al.(1990)Jones, Baker, and Williams]{key}... % \bibitem[Jones et al., 1990]{key}... % \bibitem[\protect\citeauthoryear{Jones, Baker, and Williams}{Jones % et al.}{1990}]{key}... % \bibitem[\protect\citeauthoryear{Jones et al.}{1990}]{key}... % \bibitem[\protect\astroncite{Jones et al.}{1990}]{key}... % \bibitem[\protect\citename{Jones et al., }1990]{key}... % \harvarditem[Jones et al.]{Jones, Baker, and Williams}{1990}{key}... % % This is either to be made up manually, or to be generated by an % appropriate .bst file with BibTeX. % Author-year mode || Numerical mode % Then, \citet{key} ==>> Jones et al. (1990) || Jones et al. [21] % \citep{key} ==>> (Jones et al., 1990) || [21] % Multiple citations as normal: % \citep{key1,key2} ==>> (Jones et al., 1990; Smith, 1989) || [21,24] % or (Jones et al., 1990, 1991) || [21,24] % or (Jones et al., 1990a,b) || [21,24] % \cite{key} is the equivalent of \citet{key} in author-year mode % and of \citep{key} in numerical mode % Full author lists may be forced with \citet* or \citep*, e.g. % \citep*{key} ==>> (Jones, Baker, and Williams, 1990) % Optional notes as: % \citep[chap. 2]{key} ==>> (Jones et al., 1990, chap. 2) % \citep[e.g.,][]{key} ==>> (e.g., Jones et al., 1990) % \citep[see][pg. 34]{key}==>> (see Jones et al., 1990, pg. 34) % (Note: in standard LaTeX, only one note is allowed, after the ref. % Here, one note is like the standard, two make pre- and post-notes.) % \citealt{key} ==>> Jones et al. 1990 % \citealt*{key} ==>> Jones, Baker, and Williams 1990 % \citealp{key} ==>> Jones et al., 1990 % \citealp*{key} ==>> Jones, Baker, and Williams, 1990 % Additional citation possibilities (both author-year and numerical modes) % \citeauthor{key} ==>> Jones et al. % \citeauthor*{key} ==>> Jones, Baker, and Williams % \citeyear{key} ==>> 1990 % \citeyearpar{key} ==>> (1990) % \citetext{priv. comm.} ==>> (priv. comm.) % Note: full author lists depends on whether the bib style supports them; % if not, the abbreviated list is printed even when full requested. % % Defining the citation style of a given bib style: % Use \bibpunct (in the preamble only) with 6 mandatory arguments: % 1. opening bracket for citation % 2. closing bracket % 3. citation separator (for multiple citations in one \cite) % 4. the letter n for numerical styles, s for superscripts % else anything for author-year % 5. punctuation between authors and date % 6. punctuation between years (or numbers) when common authors missing % One optional argument is the character coming before post-notes. It % appears in square braces before all other arguments. May be left off. % Example (and default) \bibpunct[,]{(}{)}{;}{a}{,}{,} % % To make this automatic for a given bib style, named newbib, say, make % a local configuration file, natbib.cfg, with the definition % \newcommand{\bibstyle@newbib}{\bibpunct...} % Then the \bibliographystyle{newbib} will cause \bibstyle@newbib to % be called on THE NEXT LATEX RUN (via the aux file). % % Such preprogrammed definitions may be invoked in the text (preamble only) % by calling \citestyle{newbib}. This is only useful if the style specified % differs from that in \bibliographystyle. % % With \citeindextrue and \citeindexfalse, one can control whether the % \cite commands make an automatic entry of the citation in the .idx % indexing file. For this, \makeindex must also be given in the preamble. % % LaTeX2e Options: (for selecting punctuation) % round - round parentheses are used (default) % square - square brackets are used [option] % curly - curly braces are used {option} % angle - angle brackets are used