From 7da0c3762d07bfc8387027a844b9372302d48f03 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 3 Feb 2009 01:27:50 +0000 Subject: natbib 83 (2feb09) git-svn-id: svn://tug.org/texlive/trunk@12056 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/natbib/natnotes.tex | 73 ++++++++++++++++++++----- 1 file changed, 58 insertions(+), 15 deletions(-) (limited to 'Master/texmf-dist/doc/latex/natbib/natnotes.tex') diff --git a/Master/texmf-dist/doc/latex/natbib/natnotes.tex b/Master/texmf-dist/doc/latex/natbib/natnotes.tex index 4d5ccedb3cb..4a3a6addd02 100644 --- a/Master/texmf-dist/doc/latex/natbib/natnotes.tex +++ b/Master/texmf-dist/doc/latex/natbib/natnotes.tex @@ -1,5 +1,5 @@ %% -%% This is file `natnotes', +%% This is file `natnotes.tex', %% generated with the docstrip utility. %% %% The original source files were: @@ -21,7 +21,7 @@ %% %% For more details, LaTeX the source natbib.dtx. %% ============================================== -%% Copyright 1993-2007 Patrick W Daly +%% Copyright 1993-2009 Patrick W Daly %% Max-Planck-Institut f\"ur Sonnensystemforschung %% Max-Planck-Str. 2 %% D-37191 Katlenburg-Lindau @@ -31,7 +31,7 @@ \def\DescribesFile#1 [#2 #3 #4] {\def\filename{#1}\def\filedate{#2}\def\fileversion{#3}} \DescribesFile{natbib} - [2007/10/30 8.1 (PWD)] + [2009/02/02 8.3 (PWD, AO)] \documentclass{article} \setlength{\parindent}{0pt} @@ -205,14 +205,26 @@ hyperlinks. \head{Selecting citation style and punctuation} 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}|}|\\ +\begin{itemize} +\item + Citation mode: |authoryear| or |numbers| or |super| + %^^A \ifNAT@numbers \ifNAT@super +\item + Braces: |round| or |square| or |open={|\emph{char}|},close={|\emph{char}|}| + %^^A \NAT@open \NAT@close +\item + Between citations: |semicolon| or |comma| or |citesep={|\emph{char}|}| + %^^A \NAT@sep +\item + Between author and year: |aysep={|\emph{char}|}| + %^^A \NAT@aysep +\item + Between years with common author: |yysep={|\emph{char}|}| + %^^A \NAT@yrsep +\item Text before post-note: |notesep={|\emph{text}|}| -\end{quote} + %^^A \NAT@cmt +\end{itemize} Defaults are |authoryear|, |round|, |comma|, |aysep={;}|, |yysep={,}|, |notesep={, }| @@ -233,13 +245,13 @@ into (Jones et al. 1990; and references therein). Redefine |\bibsection| to the desired sectioning command for introducing the list of references. This is normally |\section*| or |\chapter*|. -Define |\bibpreamble| to be any text that is to be printed after the heading but +Redefine |\bibpreamble| to be any text that is to be printed after the heading but before the actual list of references. -Define |\bibfont| to be a font declaration, e.g.\ |\small| to apply to +Redefine |\bibfont| to be a font declaration, e.g.\ |\small| to apply to the list of references. -Define |\citenumfont| to be a font declaration or command like |\itshape| +Redefine |\citenumfont| to be a font declaration or command like |\itshape| or |\textit|. Redefine |\bibnumfmt| as a command with an argument to format the numbers in @@ -292,6 +304,31 @@ options \texttt{sort}, \texttt{compress}, or \texttt{sort\&compress}. These also work with author--year citations, making multiple citations appear in their order in the reference list. + +\head{Merged Numerical References} +Do not use the \texttt{mcite} package with \thestyle; rather use the package option \texttt{merge}. + + +With this option in effect, citation keys within a multiple |\citep| command +may contain a leading * that causes them to be merged in the bibliography +together with the previous citation as a single entry with a single reference +number. For example, |\citep{feynmann,*salam,*epr}| produces a single number, +and all three references are listed in the bibliography under one entry with +that number. + +The \texttt{elide} option also activates the merging features, but also sees +to it that common parts of the merged references (e.g., authors) are not +repeated but are written only once in the single bibliography entry. + +The \texttt{mcite} option turns off the merging and eliding features, but +allows the special syntax (the * and optional inserted texts) to be ignored. + +These functions are available only to numerical-mode citations, and only when +used parenthetically, similar to the restrictions on \texttt{sort} and +\texttt{compress}. + +They also require special \texttt{.bst} files, as provided for example by the +American Physical Society for their REV\TeX\ class. \head{Long author list on first citation} Use option \texttt{longnamesfirst} to have first citation automatically give the full list of authors. @@ -333,11 +370,17 @@ is read in after the main package file. |\chapter| command; to be used with the \texttt{chapterbib} package; \item[\ttfamily nonamebreak] keeps all the authors' names in a citation on one line; causes overfull hboxes but helps with some \texttt{hyperref} - problems. + problems; +\item[\ttfamily merge] to allow the * prefix to the citation key, + and to merge such a citation's reference with that of the previous + citation; +\item[\ttfamily elide] to elide common elements of merged references, like + the authors or year; +\item[\ttfamily mcite] to recognize (and ignore) the merging syntax. \end{description} \end{document} %% %% End of Reference Sheet file %% %% -%% End of file `natnotes'. +%% End of file `natnotes.tex'. -- cgit v1.2.3