natbib 83 (2feb09)

git-svn-id: svn://tug.org/texlive/trunk@12056 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 58 insertions, 15 deletions

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'.