summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/natbib/natnotes.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-02-03 01:27:50 +0000
committerKarl Berry <karl@freefriends.org>2009-02-03 01:27:50 +0000
commit7da0c3762d07bfc8387027a844b9372302d48f03 (patch)
tree64ce00c41d51e48dcbfa6a737cb710aaf6566d69 /Master/texmf-dist/doc/latex/natbib/natnotes.tex
parentb396e9795f300708e4296019397ba084a1a37ace (diff)
natbib 83 (2feb09)
git-svn-id: svn://tug.org/texlive/trunk@12056 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/natbib/natnotes.tex')
-rw-r--r--Master/texmf-dist/doc/latex/natbib/natnotes.tex73
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'.