summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/natbib/natnotes.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/natbib/natnotes.tex')
-rw-r--r--Master/texmf-dist/doc/latex/natbib/natnotes.tex66
1 files changed, 37 insertions, 29 deletions
diff --git a/Master/texmf-dist/doc/latex/natbib/natnotes.tex b/Master/texmf-dist/doc/latex/natbib/natnotes.tex
index 7c789ecfb43..7c1830cf507 100644
--- a/Master/texmf-dist/doc/latex/natbib/natnotes.tex
+++ b/Master/texmf-dist/doc/latex/natbib/natnotes.tex
@@ -21,17 +21,17 @@
%%
%% For more details, LaTeX the source natbib.dtx.
%% ==============================================
-%% Copyright 1993-2006 Patrick W Daly
+%% Copyright 1993-2007 Patrick W Daly
%% Max-Planck-Institut f\"ur Sonnensystemforschung
%% Max-Planck-Str. 2
%% D-37191 Katlenburg-Lindau
%% Germany
-%% E-mail: daly@linmpi.mpg.de
+%% E-mail: daly@mps.mpg.de
\NeedsTeXFormat{LaTeX2e}
\def\DescribesFile#1 [#2 #3 #4]
{\def\filename{#1}\def\filedate{#2}\def\fileversion{#3}}
\DescribesFile{natbib}
- [2006/09/06 7.4a (PWD)]
+ [2007/02/05 8.0 (PWD)]
\documentclass{article}
\setlength{\parindent}{0pt}
@@ -138,8 +138,12 @@ results are different.
\head{Suppressed parentheses}
As an alternative form of citation, |\citealt| is the same as |\citet| but
\emph{without parentheses}. Similarly, |\citealp| is |\citep| without
-parentheses. Multiple references, notes, and the starred variants
-also exist.
+parentheses.
+
+The |\citenum| command prints the citation number, without parentheses, even
+in author--year mode, and without raising it in superscript mode. This is
+intended to be able to refer to citation numbers without superscripting them.
+
\begin{quote}
\begin{tabular}{l@{\quad$\Rightarrow$\quad}l}
|\citealt{jon90}| & Jones et al.\ 1990\\
@@ -148,6 +152,7 @@ also exist.
|\citealp*{jon90}| & Jones, Baker, and Williams, 1990\\
|\citealp{jon90,jam91}| & Jones et al., 1990; James et al., 1991\\
|\citealp[pg.~32]{jon90}| & Jones et al., 1990, pg.~32\\
+ |\citenum{jon90}| & 11\\
|\citetext{priv.\ comm.}| & (priv.\ comm.)
\end{tabular}
\end{quote}
@@ -198,30 +203,27 @@ These citation commands function much like |\citet| and |\citep|: they may
take multiple keys in the argument, may contain notes, and are marked as
hyperlinks.
\head{Selecting citation style and punctuation}
-Use the command |\bibpunct| with one optional and 6 mandatory arguments:
-\begin{enumerate}
-\item the opening bracket symbol, default = (
-\item the closing bracket symbol, default = )
-\item the punctuation between multiple citations, default = ;
-\item the letter `n' for numerical style, or `s' for numerical superscript
- style, any other letter for
- author--year, default = author--year;
-\item the punctuation that comes between the author names and the year
-\item the punctuation that comes between years or numbers when common author
- lists are suppressed (default = ,);
-\end{enumerate}
-
-The optional argument is the character preceding a post-note, default is a
-comma plus space. In redefining this character, one must include a space if
-one is wanted.
-
-Example~1, |\bibpunct{[}{]}{,}{a}{}{;}| changes the output of
+Use the command |\setcitestyle| with a list of comma-separated
+keywords (without spaces) as argument.
+\begin{quote}
+ Citation mode: |authoryear| or |numbers| or |super|\\
+ Braces: |round| or |square| or |open={|\emph{char}|},close={|\emph{char}|}|\\
+ Between citations: |semicolon| or |comma| or |citesep={|\emph{char}|}|\\
+ Between author and year: |aysep={|\emph{char}|}|\\
+ Between years with common author: |yysep={|\emph{char}|}|\\
+ Text before post-note: |notesep={|\emph{text}|}|
+\end{quote}
+Defaults are |authoryear|, |round|, |comma|, |aysep={;}|, |yysep={,}|,
+|notesep={, }|
+
+Example~1, |\setcitestyle{square,aysep={},yysep={;}}| changes the author--year
+output of
\begin{quote}
|\citep{jon90,jon91,jam92}|
\end{quote}
into [Jones et al. 1990; 1991, James et al. 1992].
-Example~2, |\bibpunct[; ]{(}{)}{,}{a}{}{;}| changes the output of
+Example~2, |\setcitestyle{notesep={; },round,aysep={},yysep={;}}| changes the output of
\begin{quote}
|\citep[and references therein]{jon90}|
\end{quote}
@@ -277,8 +279,12 @@ Every |\include|d file must contain its own
|\bibliography| command where the bibliography is to appear. The database
files listed as arguments to this command can be different in each file,
of course. However, what is not so obvious, is that each file must also
-contain a |\bibliographystyle| command, \emph{preferably with the same
-style argument}.
+contain a |\bibliographystyle| command, with possibly differing arguments.
+
+As of version~8.0, the citation style, including mode (author--year or
+numerical) may also differ between chapters. The |\setcitestyle| command
+can be issued at any point in the document, in particular in different
+chapters.
\head{Sorting and compressing citations}
Do not use the \texttt{cite} package with \thestyle; rather use one of the
options \texttt{sort}, \texttt{compress}, or \texttt{sort\&compress}.
@@ -303,9 +309,11 @@ is read in after the main package file.
\item[\ttfamily square] for square brackets;
\item[\ttfamily curly] for curly braces;
\item[\ttfamily angle] for angle brackets;
-\item[\ttfamily colon] (default) to separate multiple citations with
- colons;
-\item[\ttfamily comma] to use commas as separaters;
+\item[\ttfamily semicolon] (default) to separate multiple citations with
+ semi-colons;
+\item[\ttfamily colon] the same as \texttt{semicolon}, an earlier mistake in
+ terminology;
+\item[\ttfamily comma] to use commas as separators;
\item[\ttfamily authoryear] (default) for author--year citations;
\item[\ttfamily numbers] for numerical citations;
\item[\ttfamily super] for superscripted numerical citations, as in