From 0ea7446c8635d5d43c7e3b08d8fbb673ca926534 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 19 Aug 2006 23:36:17 +0000 Subject: natbib 74 (19aug06) git-svn-id: svn://tug.org/texlive/trunk@1988 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/natbib/README.v73 | 410 ----------------------- Master/texmf-dist/doc/latex/natbib/README.v74 | 410 +++++++++++++++++++++++ Master/texmf-dist/doc/latex/natbib/natbib.pdf | Bin 184770 -> 181842 bytes Master/texmf-dist/doc/latex/natbib/natnotes.tex | 2 +- Master/texmf-dist/source/latex/natbib/natbib.drv | 2 +- Master/texmf-dist/source/latex/natbib/natbib.dtx | 8 +- Master/texmf-dist/tex/latex/natbib/natbib.sty | 4 +- Master/texmf-dist/tpm/natbib.tpm | 12 +- Master/texmf/lists/natbib | 2 +- 9 files changed, 426 insertions(+), 424 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/natbib/README.v73 create mode 100644 Master/texmf-dist/doc/latex/natbib/README.v74 (limited to 'Master') diff --git a/Master/texmf-dist/doc/latex/natbib/README.v73 b/Master/texmf-dist/doc/latex/natbib/README.v73 deleted file mode 100644 index 7a9b3228e0e..00000000000 --- a/Master/texmf-dist/doc/latex/natbib/README.v73 +++ /dev/null @@ -1,410 +0,0 @@ - NATBIB Package -Version 7.3 Revised user's manual. - -Version 7.2 (See list of changes below) - Allow numerical cite compression without sorting - Hyperref package does not suppress compression - Compatibility with citeref package - -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.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.v74 b/Master/texmf-dist/doc/latex/natbib/README.v74 new file mode 100644 index 00000000000..729f2c17d97 --- /dev/null +++ b/Master/texmf-dist/doc/latex/natbib/README.v74 @@ -0,0 +1,410 @@ + NATBIB Package + (See list of changes below) +Version 7.4 Minor fix + +Version 7.3 Revised user's manual. + +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.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 abefe38c5b0..60bb01bc957 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.tex b/Master/texmf-dist/doc/latex/natbib/natnotes.tex index 76ee1b099d4..99e5c5da718 100644 --- a/Master/texmf-dist/doc/latex/natbib/natnotes.tex +++ b/Master/texmf-dist/doc/latex/natbib/natnotes.tex @@ -31,7 +31,7 @@ \def\DescribesFile#1 [#2 #3 #4] {\def\filename{#1}\def\filedate{#2}\def\fileversion{#3}} \DescribesFile{natbib} - [2006/03/22 7.3 (PWD)] + [2006/08/18 7.4 (PWD)] \documentclass{article} \setlength{\parindent}{0pt} diff --git a/Master/texmf-dist/source/latex/natbib/natbib.drv b/Master/texmf-dist/source/latex/natbib/natbib.drv index f6fb11e578f..7366d65206d 100644 --- a/Master/texmf-dist/source/latex/natbib/natbib.drv +++ b/Master/texmf-dist/source/latex/natbib/natbib.drv @@ -19,7 +19,7 @@ %% E-mail: daly@linmpi.mpg.de \NeedsTeXFormat{LaTeX2e} \ProvidesFile{natbib.drv} - [2006/03/22 7.3 (PWD)] + [2006/08/18 7.4 (PWD)] \documentclass{ltxdoc} %\documentclass[twoside]{ltxdoc} %\documentclass[a4paper]{ltxdoc} diff --git a/Master/texmf-dist/source/latex/natbib/natbib.dtx b/Master/texmf-dist/source/latex/natbib/natbib.dtx index df12988d3b5..d5c0a2f6d8b 100644 --- a/Master/texmf-dist/source/latex/natbib/natbib.dtx +++ b/Master/texmf-dist/source/latex/natbib/natbib.dtx @@ -68,7 +68,7 @@ % *** The DATE, VERSION, and other INFO %\fi %\ProvidesFile{natbib} - [2006/03/22 7.3 (PWD)] + [2006/08/18 7.4 (PWD)] % \changes{4.0}{1993 Aug 19}{First documented release} % \changes{4.1}{1993 Oct 4}{Simplification of \cs{@citeapalk}} % \changes{4.1a}{1993 Oct 14}{Add \texttt{rev} option for reversed comments @@ -178,8 +178,9 @@ % \changes{7.2}{2006 Jan 12}{Add compression without sorting} % \changes{7.2}{2006 Jan 12}{Add compatibility with \texttt{citeref} package} % \changes{7.3}{2006 Mar 22}{Revise and update the manual documentation} +% \changes{7.4}{2006 Aug 18}{Add \cs{NAT@nmfmt} to names in \cs{NAT@test}} % -% \CheckSum{2420} +% \CheckSum{2421} % \CharacterTable % {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z % Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z @@ -2704,12 +2705,13 @@ is read in after the main package file. % % \begin{macro}{\NAT@test} % \changes{6.6}{1997 May 29}{Add macro} +% \changes{7.4}{2006 Aug 18}{Fix bug by adding \cs{NAT@nmfmt}} % For numerical mode, need to test if there really is a name or date; if a % numerical \texttt{.bst} file is being used, there will not be any names or % dates. This macro tests and writes |\NAT@nm| or |\NAT@date| according to % its argument being 1 or 2. % \begin{macrocode} -\newcommand\NAT@test[1]{\ifnum#1=1 \ifx\NAT@nm\NAT@noname +\newcommand\NAT@test[1]{\ifnum#1=1 \ifx\NAT@nmfmt{\NAT@nm}\NAT@noname %<209> {\reset@font\bf(author?)}\@warning % {\reset@font\bfseries(author?)}\PackageWarning{natbib} {Author undefined for citation`\@citeb' diff --git a/Master/texmf-dist/tex/latex/natbib/natbib.sty b/Master/texmf-dist/tex/latex/natbib/natbib.sty index 3a355adf7fe..e934abaaf78 100644 --- a/Master/texmf-dist/tex/latex/natbib/natbib.sty +++ b/Master/texmf-dist/tex/latex/natbib/natbib.sty @@ -27,7 +27,7 @@ %% E-mail: daly@linmpi.mpg.de \NeedsTeXFormat{LaTeX2e}[1995/06/01] \ProvidesPackage{natbib} - [2006/03/22 7.3 (PWD)] + [2006/08/18 7.4 (PWD)] % This package reimplements the LaTeX \cite command to be used for various % citation styles, both author-year and numerical. It accepts BibTeX % output intended for many other packages, and therefore acts as a @@ -361,7 +361,7 @@ \ifnum\NAT@cmprs>0\relax\NAT@last@yr\fi \ifNAT@swa\else\ifnum\NAT@ctype=0\if*#2*\else \NAT@cmt#2\fi \NAT@@close\fi\fi}{#1}{#2}} -\newcommand\NAT@test[1]{\ifnum#1=1 \ifx\NAT@nm\NAT@noname +\newcommand\NAT@test[1]{\ifnum#1=1 \ifx\NAT@nmfmt{\NAT@nm}\NAT@noname {\reset@font\bfseries(author?)}\PackageWarning{natbib} {Author undefined for citation`\@citeb' \MessageBreak diff --git a/Master/texmf-dist/tpm/natbib.tpm b/Master/texmf-dist/tpm/natbib.tpm index 1196effd1d2..5aa767496e3 100644 --- a/Master/texmf-dist/tpm/natbib.tpm +++ b/Master/texmf-dist/tpm/natbib.tpm @@ -3,7 +3,7 @@ natbib Package - 2006/07/15 20:53:14 + 2006/08/19 23:36:02 rahtz Flexible bibliography support. @@ -17,9 +17,9 @@ designed from the start to be compatible with natbib. [description copied from TeX Catalogue] Patrick W. Daly - 380771 + 571360 - + texmf-dist/bibtex/bst/natbib/abbrvnat.bst texmf-dist/bibtex/bst/natbib/plainnat.bst texmf-dist/bibtex/bst/natbib/unsrtnat.bst @@ -27,13 +27,13 @@ texmf-dist/tex/latex/natbib/bibentry.sty texmf-dist/tex/latex/natbib/natbib.sty texmf-dist/tpm/natbib.tpm - + texmf-dist/doc/latex/natbib/README.1st -texmf-dist/doc/latex/natbib/README.v73 +texmf-dist/doc/latex/natbib/README.v74 texmf-dist/doc/latex/natbib/natbib.pdf texmf-dist/doc/latex/natbib/natnotes.tex - + texmf-dist/source/latex/natbib/bibentry.drv texmf-dist/source/latex/natbib/bibentry.dtx texmf-dist/source/latex/natbib/bibentry.ins diff --git a/Master/texmf/lists/natbib b/Master/texmf/lists/natbib index 8d1ae200542..661bd27d7b4 100644 --- a/Master/texmf/lists/natbib +++ b/Master/texmf/lists/natbib @@ -1,5 +1,5 @@ texmf-dist/doc/latex/natbib/README.1st -texmf-dist/doc/latex/natbib/README.v73 +texmf-dist/doc/latex/natbib/README.v74 texmf-dist/doc/latex/natbib/natbib.pdf texmf-dist/doc/latex/natbib/natnotes.tex texmf-dist/source/latex/natbib/bibentry.drv -- cgit v1.2.3