From d8d07e14b624ecf502b5130140ad9ad2f4d60bcb Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 9 Feb 2007 23:21:48 +0000 Subject: natbib 8.0 since a mac user noticed already git-svn-id: svn://tug.org/texlive/trunk@3963 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/natbib/README.v74a | 411 ---------------------- Master/texmf-dist/doc/latex/natbib/README.v80 | 445 ++++++++++++++++++++++++ Master/texmf-dist/doc/latex/natbib/natbib.pdf | Bin 181842 -> 175447 bytes Master/texmf-dist/doc/latex/natbib/natnotes.pdf | Bin 0 -> 88587 bytes Master/texmf-dist/doc/latex/natbib/natnotes.tex | 66 ++-- 5 files changed, 482 insertions(+), 440 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/natbib/README.v74a create mode 100644 Master/texmf-dist/doc/latex/natbib/README.v80 create mode 100644 Master/texmf-dist/doc/latex/natbib/natnotes.pdf (limited to 'Master/texmf-dist/doc/latex/natbib') diff --git a/Master/texmf-dist/doc/latex/natbib/README.v74a b/Master/texmf-dist/doc/latex/natbib/README.v74a deleted file mode 100644 index 031aa07805e..00000000000 --- a/Master/texmf-dist/doc/latex/natbib/README.v74a +++ /dev/null @@ -1,411 +0,0 @@ - NATBIB Package -Current Version: 7.4a from 2006/09/06 - -See list of changes below - -This is the natbib package for handling both author-year and numerical -BibTeX styles. It contains the following files: - natbib.dtx -- Documented source file that may be LaTeXed to get the - detailed description and/or coding documentation; needs - ltxdoc class distributed with LaTeX2e. - - May be docstripped with option `package,all' to get the - natbib.sty package file. - - natbib.ins -- A docstrip batch job to extract natbib.sty and natnotes.tex - from the source file natbib.dtx. - Simply TeX or LaTeX this file. - - This file can be extracted from natbib.dtx when it is - LaTeXed and natbib.ins does not already exist. - - plainnat.bst -- Replacements for plain.bst, abbrv.bst, unsrt.bst, the - abbrvnat.bst standard BibTeX bib style files. These replacements - unsrtnat.bst permit both numerical and author-year citations - - bibentry.dtx -- Documented source file for the bibentry package, defines - \bibentry{key} command that place the bibliography entry - in the text. Useful for descriptive bibliographies. - - bibentry.ins -- The installation file for bibentry. Just TeX or LaTeX it. - -Installation:- Simply run TeX or LaTeX on natbib.ins, which extracts -~~~~~~~~~~~~~~ natbib.sty from the documented source natbib.dtx. You - may first edit natbib.ins if you want natbib209.sty and/or - natbib.drv, the configurable documentation driver. If - natbib.ins has been lost, it may be regenerated by running - LaTeX on natbib.dtx. - - Natbib.ins also extracts the reference sheet source - file, natnotes.tex. - - For the bibentry package, TeX or LaTeX bibentry.ins, - which extracts bibentry.sty. - -Documentation:- Run LaTeX on natbib.dtx or natbib.drv. The latter may be -~~~~~~~~~~~~~~~ edited as needed to conform to local requirements (paper - size, duplex or not, with or without entire coding). - Alternatively, a ltxdoc.cfg file can contain local - configurations. - - Similarly for bibentry: LaTeX the bibentry.dtx file. - -Reference Sheet:- Run LaTeX on natnotes.tex (extracted from natbib.dtx when -~~~~~~~~~~~~~~~~~ natbib.dtx was processed). This is a 5 page summary of - the main natbib features. - -The package will accept BibTeX output in the forms: - \bibitem{key} (standard numerical format) - -or the following author-year formats: - \bibitem[Jones et al.(1990)]{key}... (native natbib style) - \bibitem[Jones et al.(1990)Jones, Baker, and Williams]{key}... - (extended natbib 5.3 style) - - \bibitem[Jones et al., 1990]{key}... (apalike style) - \bibitem[\protect\citeauthoryear{Jones, Baker, and Williams}{Jones - et al.}{1990}]{key}... (newapa or chicago styles) - \bibitem[\protect\citeauthoryear{Jones et al.}{1990}]{key}... (named style) - \bibitem[\protect\astroncite{Jones et al.}{1990}]{key}... (astron style) - \bibitem[\protect\citename{Jones et al., }1990]{key}... (authordate style) - \harvarditem[Jones et al.]{Jones, Baker, and Williams}{1990}{key}... - (harvard style) - -These are all the existing interfaces for author-year format that I could -find. Natbib.sty accepts them all, and converts them into its own system. - -Use \citet for in-text form and \citep for parenthetical citations: - \citet{key} ==>> Jones et al. (1990) (in-text form) - \citep{key} ==>> (Jones et al., 1990) (parenthetical form) - - \citep{key1,key2} ==>> (Jones et al., 1990, 1992) - (multiple citations; common authors suppressed) - \citep[chap. 2]{key} ==>> (Jones et al., 1990, chap. 2) - \citep[see][]{key} ==>> (see Jones et al., 1990) - \citep[see][chap. 2]{key} ==>> (see Jones et al., 1990, chap. 2) - -All \cite's may also take a starred version to print the full -author list, if that is supported by the bib style file. - \citet*{key} ==>> Jones, Baker, and Williams (1990) - -Other citing commands - \citeauthor{key} ==>> Jones et al. - \citeauthor*{key} ==>> Jones, Baker, and Williams - \citeyear{key} ==>> 1990 - \citeyearpar{key} ==>> (1990) - -With numerical citations, - \citep{key} ==>> [23] like standard \cite command - \citet{key} ==>> Jones et al. [23] - -For a name like von Braun or della Robbia, coming at the start of a sentence, -use \Citet for Von Braun and Della Robbia. Also \Citep, \Citeauthor exist. - -Citation aliasing, - \defcitealias{key}{text} - \citetalias{key} ==>> text - \citepalias{key} ==>> (text) -(With the hyperref package, these will be proper links to the reference list) - -Punctuation may be altered with \bibpunct command (see comments and - examples in natbib.sty and natbib.dtx) - -Or may be specified with options to the \usepackage{natbib} command. - -Punctuation styles may be set for given .bst file and then invoked by the -\bibliographystyle command. This requires making a simple (and legitimate) -addition to natbib.sty, or creating a local configuration file natbib.cfg to -contain the additions. - -For full details, print out the documentation in natbib.dtx by LaTeXing it. - -------------------------------------------------------------------------- -List of changes - v7.4a Fix bug in the compression option that occurs with hyperref and dvips. - - v7.4 Fix so nonamebreak option works with numerical citations too. - - v7.3 Go over the manual documentation and update it for 2006 rather than 1993. - No changes to code. - - v7.2 Allow numerical cite compression without sorting (option compress) - Hyperref package no longer suppresses compression - Compatibility with citeref package - Superscript citations may have braces, defined in \bibpunct - - v7.1 Add warning when multiple citations with common authors and year - are missing distinguishing extra letter. - - Modify plainnat.bst et al to include new fields: - doi (Digital Object Identifier) - eid (Electronic Identifier) - The eid is the article sequence number used in place of page numbers - for the print version of electronic journals, such as Phys. Rev. - - v7.0b Fix superscript bug - - v7.0a Fix bug in \citenumfont so it works with \textit as well as \it - Fix bug with the index.sty package which caused vertical shifts - under certain circumstances. - - v7.0 Fix bug with \bibpunct and all the predefined citation styles - that use it; blank was missing after post-note punctuation. - - Add \citenumfont and \bibnumfmt to format the citation numbers and - numbers in the reference list, respectively. - - Support for authorless works: replace the author in \bibitem with and - code and leave the date blank, as - \bibitem[ABC98()]{wxyz98} - Then \citet{wxyz98} ==>> ABC98 - \citep{wxyz98) ==>> (ABC98) - ie, not only is the date left off, but the punctuation and (for - \citet) the braces as well. - - Most author-year bst files insert the text of the KEY field in place - of the author if there is no author or editor. The (revised) natbib - bst's do this too, but also leave off the date. Thus the KEY text - becomes the replacement for author-year. - - \Citet, \Citep, \Citealp, \Citealt, \Citeauthor capitalize first - letter of first author's name in case it begins with von or de and - comes at the start of a sentence. - - With amsbook, now uses \chapter* instead of erroneous \section*. - - v6.9a Fix bugs with babel 3.6t (earlier versions of babel will not work - well with this natbib version). Order of loading is unimportant. - - Add \bibpreamble to allow user to define a preamble to the list of - references. - - Fix bug that occurred when optional notes to \cite's began with a - command like \S. - - v6.9 The \makeindex can be issued before \usepackage{natbib} - - Add \defcitealias, \citetalias, \citepalias to define and print - some identifying code text for the citation: - \defcitealias{key}{TEXT} then \citepalias{key} => (TEXT) - - The character coming between the citation and following note is - specified by the optional argument to \bibpunct; this must now - include a space if that is wanted. The default is now {, } where it - was previously {,}. - - Copyright notices in all files (even .bst's) conform to LaTeX Project - Public Licence. - - v6.8c Exclude notes, punctuation, both braces from the hyperref link text. - - Add nonamebreak option to prevent line breaks within author names. - - v6.8b Add chapterbib compatibility for hyperref and backref packages - (in arrangement with Sebastian Rahtz) - - With hyperref, links are broken between author name and date, to - prevent some possible pdftex problems. - - v6.8a Fix some problems with redefinition of \@biblabel - - v6.8 Allow user to be able to redefine \@biblabel for numerical mode - - Fix bug with hyperref package; previously failed with \citep and - multiple citations with repeated authors - - Allow cites within cites, as \citep[cited in \citealp{xx}]{yy} - (previously these clashed and final brace was missing) - - \citealp and \citealt suppress parenthese in numerical mode too - - Add \citetext{..} to produce citations manually, with help - of \citealp, such as - \citetext{see \citealp{AA}, or better \citealp{BB}} - - v6.7 Option `longnamesfirst' causes first citation of any reference to use - the full author list. - - In numerical mode, \citet with multiple citations suppresses - repeated authors, Jones et al. [21, 22]. - - A bug is fixed that caused problems with the showkeys package and - its `final' option. - - A clash with babel's active characters is fixed up. - - A reference sheet is available, consisting (mainly) of selected text - from the main documentation. Source file is natnotes.tex, extracted - from natbib.dtx with option `notes'. - - v6.6 Options `sort' and `sort&compress' order multiple citations in one - \citep or \citet command to be in the sequence in which they appear - in the list of references; this is normally ordered alphabetically - and then by year. - - Fix functionality with showkeys and hyperref packages - - Fix \nocite so that warning messages are not always printed with - chapterbib package - - All \cite... commands coded from a basic one so that they all have the - same syntax: notes and multiple citations always possible, but may not - always be meaningful. - - Add \citeyearpar to print year in parentheses; add \citeauthor* to - be equivalent to \citefullauthor. - - Package showkeys must be loaded after natbib (this is not an improvement, - but seems unavoidable). - - v6.5 Made compatible with KOMA scripts by adding \bib@heading to the - definition of thebibliography environment - - change documentation to stress \citet and \citep instead of old - syntax with \cite and \cite[]; now both these commands can also - take optional arguments for notes, before and after ref. - - v6.4 Made compatible with the chapterbib package of Donald Arseneau - which allows multiple bibliographies in one document - - Contains modified coding from Arseneau's cite package to allow - numerical citations to be sorted and compressed - - Made compatible with the hyperref package of Sebastian Rahtz and - Yannis Haralambous, for use with HyperTeX - - Multiple superscript citations have no space between them - - v6.3 The package `showkeys' used to have some problems when loaded - before natbib; this is now repaired - - The supplied .bst files have a bug fixed so that the extra letters - added to the dates function properly; they are now added when the - abbreviated author list and date are the same for more than one - reference (previously the full author list and date determined this, - which is incorrect) - - With numerical citations, the extra letters are superfluous; these can - now be suppressed with the supplied .bst files - - v6.2 Adds \citet for textual citations in both author-year and numerical - modes. - - Adds \bibsep as a length that goes between lines of the reference list - Can be changed with \setlength - - Fixes the superscript style of numerical references so that the - numbers are the proper (smaller) size - - Fixes a clash with the classes amsart and amsbook - - v6.1 The LaTeX update of December 1995 contains some changes to internal - command which natbib has used. Natbib needs to be altered accordingly. - In fact, it has been made far more robust against any such future - interal changes, although not 100%. - - There are no changes to the user interface. - - V6.0 New method for parsing the author and year parts, which is now done - before writing the information to the auxiliary file. This allows - numerical citations to be used even with author-year bst files. - (Numerical bst files can NEVER generate author-year citations!) - Now provide replacements for standard BibTeX bst files so that - they may be used for both numerical and author-year. - - Note: the bib style file provided in previous releases (natbib.bst) - is no longer provided, since it only meant to be an example. It is now - replaced by plainnat.bst and others. - - Citation styles (punctuation, brackets, etc) can be selected in - various ways: an improved priority system has now been introduced. - For example, any punctuation selection through an option to - \usepackage has priority over any prestored citation style. - - \bibpunct can now take a 7th optional argument (at the start of - the list) for the punctuation that comes before a post-note. - - It is possible to have all citations and entries in the list of - references automatically entered in an index, either with the standard - makeidx package or the contributed index package of David M. Jones. - - V5.5: some fixed bugs - - Many internal names have been changed to recommended style, ie with - the prefix \NAT@... For example, \@citebegin and \@citeend are - now \NAT@open and \NAT@close (these contain the opening and closing - brackets). - - Where possible, \def has been replaced by \(re)newcommand. - - Selection of citation format (numerical, superscript, author-year) is - coded better; previously, if numerical were ever selected, it was - impossible to switch back to author-year. - -** As a result: ALL CITATION CUSTOMIZATIONS (\bibpunct, \citestyle) MUST -** BE ISSUED BEFORE \begin{document}!!!!! This differs from the -** situation in earlier versions, but is in fact much more logical. - - Add \citep{key} and \citep*{key} as shorthands for - \cite[]{key} and \cite*[]{key}, ie for parenthetical citations - (this was requested) - - Add \citealt{key} and \citealt*{key} that function like \cite{key} and - \cite*{key}, but without brackets. These are textual citations of - the form Jones et al. 1990. (Also a requested feature.) - - The amount of hanging indentation in the list of references can be - redefined via the length command \bibhang. Change with e.g. - \setlength{\bibhang}{2em} %Default is 1em - - V5.4: a few bugs fixed - - add superscript citation style to \bibpunct, as `s' (in place of - `n' for numerical or `a' for author-year; improve superscript coding - - add \citestyle command to be able to invoke a preprogrammed citation - style that is different from that given in \bibliographystyle - - for (Jones et al, 1994a; Jones et al, 1994b) print instead - (Jones et al, 1994a,b) - [up until now, it would have printed (Jones et al, 1994a, 1994b) ] - - V5.3: support the new release of harvard.sty, so that natbib will work with - those bib styles that are designed for it (agms,dcu,kluwer) This means - adding \harvardand, \harvardurl, and some others - - provide \citefullauthor to list all authors for those bib styles that - support this: harvard, chicago - - extend the native format of \bibitem to support full author citations - too; add starred form of \cite to print full author list, if present. - - fix up a bug that caused accents in citations (not references) to be - ignored. - - - V5.2: \citeauthor and \citeyear make auxiliary file entries so BibTeX - can see them; also, any font changes in the author (like {\it Smith}) - will be localized (in 5.0, the brackets were removed, so all following - text was italicized.) - - Internal definition of \cite made to be like that of LaTeX2e, so that - multiple citations may have spaces after commas, as \cite{a, b, c} - - A local configuration file natbib.cfg will be read in (2e only) that - may contain local \bibstyle@xxx commands. - - V5.1: pure LaTeX2e, not mixed as v5.0 was. Fixes up problems of font - commands in the citation labels (like {\em et al.} that caused - terrible problems and had a poor ad hoc solution. - -Changes from previous (4.x) versions: - \cite now takes two optional arguments for text before and after citation - \citeyear and \citeauthor have been added - Under LaTeX2e, punctuation can be selected with options in \usepackage - -------------------------------------------------------------------------- -2006 Jan 12 -Patrick W. Daly -Max-Planck-Institut f\"ur Sonnensystemforschung -D-37191 Katlenburg-Lindau, Germany -E-mail: daly@mps.mpg.de diff --git a/Master/texmf-dist/doc/latex/natbib/README.v80 b/Master/texmf-dist/doc/latex/natbib/README.v80 new file mode 100644 index 00000000000..2a171d7bde2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/natbib/README.v80 @@ -0,0 +1,445 @@ + NATBIB Package +Current Version: 8.0 from 2007/02/05 + +See list of changes below + +This is the natbib package for handling both author-year and numerical +BibTeX styles. It contains the following files: + natbib.dtx -- Documented source file that may be LaTeXed to get the + detailed description and/or coding documentation; needs + ltxdoc class distributed with LaTeX2e. + + May be docstripped with option `package,all' to get the + natbib.sty package file. + + natbib.ins -- A docstrip batch job to extract natbib.sty and natnotes.tex + from the source file natbib.dtx. + Simply TeX or LaTeX this file. + + This file can be extracted from natbib.dtx when it is + LaTeXed and natbib.ins does not already exist. + + plainnat.bst -- Replacements for plain.bst, abbrv.bst, unsrt.bst, the + abbrvnat.bst standard BibTeX bib style files. These replacements + unsrtnat.bst permit both numerical and author-year citations + + bibentry.dtx -- Documented source file for the bibentry package, defines + \bibentry{key} command that place the bibliography entry + in the text. Useful for descriptive bibliographies. + + bibentry.ins -- The installation file for bibentry. Just TeX or LaTeX it. + +Installation:- Simply run TeX or LaTeX on natbib.ins, which extracts +~~~~~~~~~~~~~~ natbib.sty from the documented source natbib.dtx. You + may first edit natbib.ins if you want natbib209.sty and/or + natbib.drv, the configurable documentation driver. If + natbib.ins has been lost, it may be regenerated by running + LaTeX on natbib.dtx. + + Natbib.ins also extracts the reference sheet source + file, natnotes.tex. + + For the bibentry package, TeX or LaTeX bibentry.ins, + which extracts bibentry.sty. + +Documentation:- Run LaTeX on natbib.dtx or natbib.drv. The latter may be +~~~~~~~~~~~~~~~ edited as needed to conform to local requirements (paper + size, duplex or not, with or without entire coding). + Alternatively, a ltxdoc.cfg file can contain local + configurations. + + Similarly for bibentry: LaTeX the bibentry.dtx file. + +Reference Sheet:- Run LaTeX on natnotes.tex (extracted from natbib.dtx when +~~~~~~~~~~~~~~~~~ natbib.dtx was processed). This is a 5 page summary of + the main natbib features. + +The package will accept BibTeX output in the forms: + \bibitem{key} (standard numerical format) + +or the following author-year formats: + \bibitem[Jones et al.(1990)]{key}... (native natbib style) + \bibitem[Jones et al.(1990)Jones, Baker, and Williams]{key}... + (extended natbib 5.3 style) + + \bibitem[Jones et al., 1990]{key}... (apalike style) + \bibitem[\protect\citeauthoryear{Jones, Baker, and Williams}{Jones + et al.}{1990}]{key}... (newapa or chicago styles) + \bibitem[\protect\citeauthoryear{Jones et al.}{1990}]{key}... (named style) + \bibitem[\protect\astroncite{Jones et al.}{1990}]{key}... (astron style) + \bibitem[\protect\citename{Jones et al., }1990]{key}... (authordate style) + \harvarditem[Jones et al.]{Jones, Baker, and Williams}{1990}{key}... + (harvard style) + +These are all the existing interfaces for author-year format that I could +find. Natbib.sty accepts them all, and converts them into its own system. + +Use \citet for in-text form and \citep for parenthetical citations: + \citet{key} ==>> Jones et al. (1990) (in-text form) + \citep{key} ==>> (Jones et al., 1990) (parenthetical form) + + \citep{key1,key2} ==>> (Jones et al., 1990, 1992) + (multiple citations; common authors suppressed) + \citep[chap. 2]{key} ==>> (Jones et al., 1990, chap. 2) + \citep[see][]{key} ==>> (see Jones et al., 1990) + \citep[see][chap. 2]{key} ==>> (see Jones et al., 1990, chap. 2) + +All \cite's may also take a starred version to print the full +author list, if that is supported by the bib style file. + \citet*{key} ==>> Jones, Baker, and Williams (1990) + +Other citing commands + \citeauthor{key} ==>> Jones et al. + \citeauthor*{key} ==>> Jones, Baker, and Williams + \citeyear{key} ==>> 1990 + \citeyearpar{key} ==>> (1990) + +With numerical citations, + \citep{key} ==>> [23] like standard \cite command + \citet{key} ==>> Jones et al. [23] + +For a name like von Braun or della Robbia, coming at the start of a sentence, +use \Citet for Von Braun and Della Robbia. Also \Citep, \Citeauthor exist. + +Citation aliasing, + \defcitealias{key}{text} + \citetalias{key} ==>> text + \citepalias{key} ==>> (text) +(With the hyperref package, these will be proper links to the reference list) + +Punctuation may be altered with \bibpunct command (see comments and + examples in natbib.sty and natbib.dtx) + +Or may be specified with options to the \usepackage{natbib} command. + +Punctuation styles may be set for given .bst file and then invoked by the +\bibliographystyle command. This requires making a simple (and legitimate) +addition to natbib.sty, or creating a local configuration file natbib.cfg to +contain the additions. + +For full details, print out the documentation in natbib.dtx by LaTeXing it. + +------------------------------------------------------------------------- +List of changes + v8.0 Add \setcitestyle to simplify changing citation punctuation; is to replace + \bibpunct, which is retained for compatibility. + + Citation style commands (\setcitestyle, \citestyle, \bibpunct) are no longer + limited to the preamble; in particular they may be issued in different chapters + with the chapterbib package; even the author--year or numerical mode can + be switched and the bibliography is adjusted accordingly. (This has long + been requested by several users.) The docstrip option 'nopreonly' is therefore + removed, since it is now always active. + + Support for LaTeX 2.09 is removed; I no longer can test it and it only + complicates the source file. + + Package option 'colon' always meant putting a semi-colon between multiple + citations. This seems odd to me, but I probably thought 'semicolon' was + too long. I now have 'semicolon' to be explicit, but 'colon' is still + retained (as semi-colon). + + v7.5 (Never released, it is the preliminary 8.0) + Superscript citations: if braces specified, they are also superscripted + in both in-text and parenthetical citations. Any optional notes are + printed before and after as regular text. + + Add \citenum{key} to print the number, even in author-year mode. And + without superscripting and without parentheses. This is so + superscripted citations can be referred to in-text as regular numbers. + + In-text numerical citations with notes: the notes are now outside the parentheses + as this appears more logical. For parenthetical citations, notes are still + inside. + + The indexing of citations now has the default format Author [num] in numerical mode. + Previously it was Author [date] in both. + + v7.4a Fix bug in the compression option that occurs with hyperref and dvips. + + v7.4 Fix so nonamebreak option works with numerical citations too. + + v7.3 Go over the manual documentation and update it for 2006 rather than 1993. + No changes to code. + + v7.2 Allow numerical cite compression without sorting (option compress) + Hyperref package no longer suppresses compression + Compatibility with citeref package + Superscript citations may have braces, defined in \bibpunct + + v7.1 Add warning when multiple citations with common authors and year + are missing distinguishing extra letter. + + Modify plainnat.bst et al to include new fields: + doi (Digital Object Identifier) + eid (Electronic Identifier) + The eid is the article sequence number used in place of page numbers + for the print version of electronic journals, such as Phys. Rev. + + v7.0b Fix superscript bug + + v7.0a Fix bug in \citenumfont so it works with \textit as well as \it + Fix bug with the index.sty package which caused vertical shifts + under certain circumstances. + + v7.0 Fix bug with \bibpunct and all the predefined citation styles + that use it; blank was missing after post-note punctuation. + + Add \citenumfont and \bibnumfmt to format the citation numbers and + numbers in the reference list, respectively. + + Support for authorless works: replace the author in \bibitem with and + code and leave the date blank, as + \bibitem[ABC98()]{wxyz98} + Then \citet{wxyz98} ==>> ABC98 + \citep{wxyz98) ==>> (ABC98) + ie, not only is the date left off, but the punctuation and (for + \citet) the braces as well. + + Most author-year bst files insert the text of the KEY field in place + of the author if there is no author or editor. The (revised) natbib + bst's do this too, but also leave off the date. Thus the KEY text + becomes the replacement for author-year. + + \Citet, \Citep, \Citealp, \Citealt, \Citeauthor capitalize first + letter of first author's name in case it begins with von or de and + comes at the start of a sentence. + + With amsbook, now uses \chapter* instead of erroneous \section*. + + v6.9a Fix bugs with babel 3.6t (earlier versions of babel will not work + well with this natbib version). Order of loading is unimportant. + + Add \bibpreamble to allow user to define a preamble to the list of + references. + + Fix bug that occurred when optional notes to \cite's began with a + command like \S. + + v6.9 The \makeindex can be issued before \usepackage{natbib} + + Add \defcitealias, \citetalias, \citepalias to define and print + some identifying code text for the citation: + \defcitealias{key}{TEXT} then \citepalias{key} => (TEXT) + + The character coming between the citation and following note is + specified by the optional argument to \bibpunct; this must now + include a space if that is wanted. The default is now {, } where it + was previously {,}. + + Copyright notices in all files (even .bst's) conform to LaTeX Project + Public Licence. + + v6.8c Exclude notes, punctuation, both braces from the hyperref link text. + + Add nonamebreak option to prevent line breaks within author names. + + v6.8b Add chapterbib compatibility for hyperref and backref packages + (in arrangement with Sebastian Rahtz) + + With hyperref, links are broken between author name and date, to + prevent some possible pdftex problems. + + v6.8a Fix some problems with redefinition of \@biblabel + + v6.8 Allow user to be able to redefine \@biblabel for numerical mode + + Fix bug with hyperref package; previously failed with \citep and + multiple citations with repeated authors + + Allow cites within cites, as \citep[cited in \citealp{xx}]{yy} + (previously these clashed and final brace was missing) + + \citealp and \citealt suppress parenthese in numerical mode too + + Add \citetext{..} to produce citations manually, with help + of \citealp, such as + \citetext{see \citealp{AA}, or better \citealp{BB}} + + v6.7 Option `longnamesfirst' causes first citation of any reference to use + the full author list. + + In numerical mode, \citet with multiple citations suppresses + repeated authors, Jones et al. [21, 22]. + + A bug is fixed that caused problems with the showkeys package and + its `final' option. + + A clash with babel's active characters is fixed up. + + A reference sheet is available, consisting (mainly) of selected text + from the main documentation. Source file is natnotes.tex, extracted + from natbib.dtx with option `notes'. + + v6.6 Options `sort' and `sort&compress' order multiple citations in one + \citep or \citet command to be in the sequence in which they appear + in the list of references; this is normally ordered alphabetically + and then by year. + + Fix functionality with showkeys and hyperref packages + + Fix \nocite so that warning messages are not always printed with + chapterbib package + + All \cite... commands coded from a basic one so that they all have the + same syntax: notes and multiple citations always possible, but may not + always be meaningful. + + Add \citeyearpar to print year in parentheses; add \citeauthor* to + be equivalent to \citefullauthor. + + Package showkeys must be loaded after natbib (this is not an improvement, + but seems unavoidable). + + v6.5 Made compatible with KOMA scripts by adding \bib@heading to the + definition of thebibliography environment + + change documentation to stress \citet and \citep instead of old + syntax with \cite and \cite[]; now both these commands can also + take optional arguments for notes, before and after ref. + + v6.4 Made compatible with the chapterbib package of Donald Arseneau + which allows multiple bibliographies in one document + + Contains modified coding from Arseneau's cite package to allow + numerical citations to be sorted and compressed + + Made compatible with the hyperref package of Sebastian Rahtz and + Yannis Haralambous, for use with HyperTeX + + Multiple superscript citations have no space between them + + v6.3 The package `showkeys' used to have some problems when loaded + before natbib; this is now repaired + + The supplied .bst files have a bug fixed so that the extra letters + added to the dates function properly; they are now added when the + abbreviated author list and date are the same for more than one + reference (previously the full author list and date determined this, + which is incorrect) + + With numerical citations, the extra letters are superfluous; these can + now be suppressed with the supplied .bst files + + v6.2 Adds \citet for textual citations in both author-year and numerical + modes. + + Adds \bibsep as a length that goes between lines of the reference list + Can be changed with \setlength + + Fixes the superscript style of numerical references so that the + numbers are the proper (smaller) size + + Fixes a clash with the classes amsart and amsbook + + v6.1 The LaTeX update of December 1995 contains some changes to internal + command which natbib has used. Natbib needs to be altered accordingly. + In fact, it has been made far more robust against any such future + interal changes, although not 100%. + + There are no changes to the user interface. + + V6.0 New method for parsing the author and year parts, which is now done + before writing the information to the auxiliary file. This allows + numerical citations to be used even with author-year bst files. + (Numerical bst files can NEVER generate author-year citations!) + Now provide replacements for standard BibTeX bst files so that + they may be used for both numerical and author-year. + + Note: the bib style file provided in previous releases (natbib.bst) + is no longer provided, since it only meant to be an example. It is now + replaced by plainnat.bst and others. + + Citation styles (punctuation, brackets, etc) can be selected in + various ways: an improved priority system has now been introduced. + For example, any punctuation selection through an option to + \usepackage has priority over any prestored citation style. + + \bibpunct can now take a 7th optional argument (at the start of + the list) for the punctuation that comes before a post-note. + + It is possible to have all citations and entries in the list of + references automatically entered in an index, either with the standard + makeidx package or the contributed index package of David M. Jones. + + V5.5: some fixed bugs + + Many internal names have been changed to recommended style, ie with + the prefix \NAT@... For example, \@citebegin and \@citeend are + now \NAT@open and \NAT@close (these contain the opening and closing + brackets). + + Where possible, \def has been replaced by \(re)newcommand. + + Selection of citation format (numerical, superscript, author-year) is + coded better; previously, if numerical were ever selected, it was + impossible to switch back to author-year. + +** As a result: ALL CITATION CUSTOMIZATIONS (\bibpunct, \citestyle) MUST +** BE ISSUED BEFORE \begin{document}!!!!! This differs from the +** situation in earlier versions, but is in fact much more logical. + + Add \citep{key} and \citep*{key} as shorthands for + \cite[]{key} and \cite*[]{key}, ie for parenthetical citations + (this was requested) + + Add \citealt{key} and \citealt*{key} that function like \cite{key} and + \cite*{key}, but without brackets. These are textual citations of + the form Jones et al. 1990. (Also a requested feature.) + + The amount of hanging indentation in the list of references can be + redefined via the length command \bibhang. Change with e.g. + \setlength{\bibhang}{2em} %Default is 1em + + V5.4: a few bugs fixed + + add superscript citation style to \bibpunct, as `s' (in place of + `n' for numerical or `a' for author-year; improve superscript coding + + add \citestyle command to be able to invoke a preprogrammed citation + style that is different from that given in \bibliographystyle + + for (Jones et al, 1994a; Jones et al, 1994b) print instead + (Jones et al, 1994a,b) + [up until now, it would have printed (Jones et al, 1994a, 1994b) ] + + V5.3: support the new release of harvard.sty, so that natbib will work with + those bib styles that are designed for it (agms,dcu,kluwer) This means + adding \harvardand, \harvardurl, and some others + + provide \citefullauthor to list all authors for those bib styles that + support this: harvard, chicago + + extend the native format of \bibitem to support full author citations + too; add starred form of \cite to print full author list, if present. + + fix up a bug that caused accents in citations (not references) to be + ignored. + + + V5.2: \citeauthor and \citeyear make auxiliary file entries so BibTeX + can see them; also, any font changes in the author (like {\it Smith}) + will be localized (in 5.0, the brackets were removed, so all following + text was italicized.) + + Internal definition of \cite made to be like that of LaTeX2e, so that + multiple citations may have spaces after commas, as \cite{a, b, c} + + A local configuration file natbib.cfg will be read in (2e only) that + may contain local \bibstyle@xxx commands. + + V5.1: pure LaTeX2e, not mixed as v5.0 was. Fixes up problems of font + commands in the citation labels (like {\em et al.} that caused + terrible problems and had a poor ad hoc solution. + +Changes from previous (4.x) versions: + \cite now takes two optional arguments for text before and after citation + \citeyear and \citeauthor have been added + Under LaTeX2e, punctuation can be selected with options in \usepackage + +------------------------------------------------------------------------- +2006 Jan 12 +Patrick W. Daly +Max-Planck-Institut f\"ur Sonnensystemforschung +D-37191 Katlenburg-Lindau, Germany +E-mail: daly@mps.mpg.de diff --git a/Master/texmf-dist/doc/latex/natbib/natbib.pdf b/Master/texmf-dist/doc/latex/natbib/natbib.pdf index 60bb01bc957..2141249751f 100644 Binary files a/Master/texmf-dist/doc/latex/natbib/natbib.pdf and b/Master/texmf-dist/doc/latex/natbib/natbib.pdf differ diff --git a/Master/texmf-dist/doc/latex/natbib/natnotes.pdf b/Master/texmf-dist/doc/latex/natbib/natnotes.pdf new file mode 100644 index 00000000000..2dcd957d10a Binary files /dev/null and b/Master/texmf-dist/doc/latex/natbib/natnotes.pdf differ 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 -- cgit v1.2.3