iopart-num update (27jan09)

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

5 files changed, 132 insertions, 38 deletions

diff --git a/Master/texmf-dist/bibtex/bst/iopart-num/iopart-num.bst b/Master/texmf-dist/bibtex/bst/iopart-num/iopart-num.bst
index 4a4fd9d1987..cc46b187665 100644
--- a/Master/texmf-dist/bibtex/bst/iopart-num/iopart-num.bst
+++ b/Master/texmf-dist/bibtex/bst/iopart-num/iopart-num.bst
@@ -1,4 +1,5 @@
 % iopart-num.bst -- BibTeX style for IOP journals (Harvard-like numeric style)
+% M. A. Caprio
 %
 % DESCRIPTION
 %
@@ -6,6 +7,24 @@
 %
 %   Available from CTAN as /biblio/bibtex/contrib/iopart-num.
 %
+% COPYRIGHT/LICENSE
+%
+%   Copyright 2009 M. A. Caprio
+%
+%   This work may be distributed and/or modified under the
+%   conditions of the LaTeX Project Public License, either 
+%   version 1.3 of this license or (at your option) any later 
+%   version.  The latest version of this license is in
+%     http://www.latex-project.org/lppl.txt
+%   and version 1.3 or later is part of all distributions of 
+%   LaTeX version 2005/12/01 or later.
+%
+%   This work has the LPPL maintenance status "maintained".
+% 
+%   The Current Maintainer of this work is the author.
+%
+%   The contents of this work are listed in the README file.
+%
 % HISTORY
 % 
 % Version 1.0 (2005/07/11)
@@ -19,7 +38,7 @@
 %   -- for any series with number, number after series
 % Version 2.0 (2006/12/21)
 %   -- define section field for proper formatting of lettered journal sections 
-%      (as requested by Chris Latham)
+%      (suggested by Chris Latham)
 %   -- suppress printing of number for article, but provide issue field
 %      for periodicals with issue-based page numbering (suggested by Chris Latham)
 %   -- patch remove.dots to not strip "\." control sequence (bug reported by Kevin Bube)
@@ -29,14 +48,18 @@
 %   -- for book, inbook, and proceedings with editors but no author, fix formating of editors
 %   -- for incollection and inproceedings, put editors in correct location
 %   -- for journal: use same page formatting even if volume missing
+% Version 2.1 (2009/01/22)
+%   -- for incollection and inproceedings: support title of chapter (not appropriate 
+%      to inbook)
+%   -- for book, proceedings, etc.: support volumetitle for multivolume book
 %
 % LIMITATIONS
 %
 % Still not in IOP form: 
 %   -- for incollection and inproceedings, editors initials should preceed rather 
 %      than follow last name
-%   -- of the two semantically different formatting for a book in a multivolume work,
-%      only "title (series volume)" formatting is supported, not "series volume title"
+% Other:
+%   -- hyphenated first names lose hyphen
 
 %% This is file `iopart-num.bst',
 %% generated with the docstrip utility.
@@ -110,6 +133,14 @@ ENTRY
     issue
     section
     epilog
+    volumetitle
+    transjournal
+    transsection
+    transvolume
+    transnumber
+    transissue
+    transpages
+    transyear
   }
   {}
   { label }
@@ -860,6 +891,7 @@ FUNCTION {either.or.check}
 }
 FUNCTION {format.bvolume}
 { volume empty$
+    % no volume: return blank
     { "" }
 %%    { bbl.volume volume tie.or.space.prefix
 %%      "volume" bibinfo.check * *
@@ -874,7 +906,16 @@ FUNCTION {format.bvolume}
     {
       series "series" bibinfo.check
       empty$ 
-        {bbl.volume volume tie.or.space.prefix "volume" bibinfo.check * *}
+        % no series: must be multivolume book
+        {
+          bbl.volume volume tie.or.space.prefix "volume" bibinfo.check * *
+          volumetitle empty$
+            'skip$
+            % volumetitle: book volume has title
+            { " " volumetitle "volumetitle" bibinfo.check emphasize * * }
+          if$
+        }
+        % series: format as volume in series
         { 
           "(" 
           series "series" bibinfo.check emphasize *
@@ -1416,6 +1457,7 @@ FUNCTION {incollection}
   format.authors "author" output.check
   format.date "year" output.check
   date.block
+  format.title "title" output.check
   crossref missing$
     { 
       %% format.in.ed.booktitle "booktitle" output.check
@@ -1446,6 +1488,7 @@ FUNCTION {inproceedings}
   format.authors "author" output.check
   format.date "year" output.check
   date.block
+  format.title "title" output.check
   crossref missing$
     { 
 
@@ -1661,7 +1704,7 @@ FUNCTION {begin.bib}
   write$ newline$
   "\providecommand{\eprint}[2][]{\url{#2}}"
   write$ newline$
-  "% Bibliography created with iopart-num v2.0"
+  "% Bibliography created with iopart-num v2.1"
   write$ newline$
   "% /biblio/bibtex/contrib/iopart-num"
   write$ newline$
diff --git a/Master/texmf-dist/doc/bibtex/iopart-num/README b/Master/texmf-dist/doc/bibtex/iopart-num/README
index d83d465dfbf..6e4bbd99da9 100644
--- a/Master/texmf-dist/doc/bibtex/iopart-num/README
+++ b/Master/texmf-dist/doc/bibtex/iopart-num/README
@@ -8,10 +8,6 @@ citation style with Harvard-like formatting is provided, based upon
 the specification in "How to prepare and submit an article for
 publication in an IOP journal using LaTeX2e" by Graham Douglas (2005).
 
-The style is compatible with, but does not require, the iopart
-document class.  It is also compatible with, but does not require,
-the natbib package.  
-
 The distribution contains the BibTeX style file (iopart-num.bst), the
 source files for the documentation (iopart-num.tex and
 iopart-num.bib), and a PDF file of the documentation (iopart-num.pdf).
@@ -19,10 +15,8 @@ iopart-num.bib), and a PDF file of the documentation (iopart-num.pdf).
 --------------------------------
 
 Mark A. Caprio, Yale University
-December 21, 2006
-Version 2.0
+January 22, 2009
+Version 2.1
 
 This material is subject to the LaTeX Project Public License.  See
-http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for
-the details of that license.
-
+http://www.latex-project.org/lppl.txt for the details of that license.
diff --git a/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.bib b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.bib
index 156478cb220..c9b7292e474 100644
--- a/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.bib
+++ b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.bib
@@ -69,6 +69,16 @@
   year = 1996
 }
 
+@book{ex9,
+  title = "Gulf War and Health",
+  volume = 1,
+  volumetitle = "Depleted Uranium, Pyridostigmine Bromide, Sarin, and Vaccines",
+  editor = "C. E. Fulco and C. T. Liverman and H. C. Sox",
+  publisher = "The National Academies Press",
+  address = "Washington, DC",
+  year = 2000
+}
+
 @article{bardeen1957:bcs,
   author = "J. Bardeen and L. N. Cooper and J. R. Schrieffer",
   journal = "Phys. Rev.",
@@ -118,6 +128,16 @@
   year = 1967
 }
 
+@book{iachello2006:liealg,
+  author = "F. Iachello", 
+  title = "Lie Algebras and Applications",
+  publisher = "Springer",
+  series = "Lecture Notes in Physics",
+  volume = 708,
+  address = "Berlin",
+  year = 2006
+}
+
 @book{siegbahn1965:v1,
   editor = "K. Siegbahn",
   title = "Alpha-, Beta-, and Gamma-Ray Spectroscopy",
@@ -128,16 +148,14 @@
   volume = 1
 }
 
-@incollection{bell1965:coin-lifetime,
-  author = "R. E. Bell",
-  title = "Coincidence Techniques and the Measurement of Short Mean Lives",
-  editor = "K. Siegbahn",
-  booktitle = "Alpha-, Beta-, and Gamma-Ray Spectroscopy",
-  publisher = "North-Holland",
-  address = "Amsterdam",
-  year = 1965,
+@book{bohr1998:v2,
+  author = "A. Bohr and B. R. Mottelson",
+  title = "Nuclear Structure",
   volume = 2,
-  pages = 905
+  volumetitle = "Nuclear Deformations",
+  publisher = "World Scientific",
+  address = "Singapore",
+  year = "1998"
 }
 
 @phdthesis{caprio2003:diss,
diff --git a/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.pdf b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.pdf
index 32f5f591b72..6c1da21140c 100644
--- a/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.pdf
+++ b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.pdf
diff --git a/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex
index f24291e4db6..0e37c2bcf48 100644
--- a/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex
+++ b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex
@@ -14,12 +14,12 @@
 
 \title{The \texttt{iopart-num} \BibTeX{} style}
 
-\noindent \qquad \\[-6pt] \qquad Version 2.0\\\qquad December 21, 2006
+\noindent \qquad \\[-6pt] \qquad Version 2.1\\\qquad January 22, 2009
 
 \author{M~A~Caprio}
 
-\address{Center for Theoretical Physics, Sloane Physics Laboratory, 
-Yale University, New Haven, Connecticut 06520-8120, USA}
+\address{Department of Physics, University of Notre Dame,
+Notre Dame, Indiana 46556-5670, USA}
 
 \section{Introduction}
 
@@ -44,22 +44,22 @@ braces.  Further general instructions on using \BibTeX{} may be found
 in the \BibTeX{} documentation.
 
 The \texttt{iopart-num} style is compatible with, but does not
-require, the \texttt{iopart} document class.  It is also compatible
-with, but does not require, the \texttt{natbib} package.  For
-documents prepared using the \texttt{iopart} class but
+require, the \texttt{iopart} document class.
+For documents prepared \textit{with}
+the \texttt{natbib} package, 
+\texttt{natbib} should be loaded with the options \verb+square+ and \verb+sort&compress+
+to insure proper formatting of the references in the text.  If,
+instead, 
+documents are prepared using the \texttt{iopart} class but
 \textit{without} \texttt{natbib}, the section header 
 for the references must be manually inserted, with the command
 \verb+\section*{References}+, and use of the \texttt{citesort} package
 is recommended for proper formatting of the references in the text.
-For documents prepared \textit{with}
-\texttt{natbib}, the section header for the references appears automatically, 
-and use of the \texttt{citesort} package is not necessary.  The
-\texttt{natbib} package should be loaded with the options \verb+square+ and \verb+sort&compress+
-to insure proper formatting of the references in the text,
-\textit{i.e.}, with \verb+\usepackage[square,sort&compress]{natbib}+.
 
 \section{Special bibliographic data fields}
 
+\subsection{Journal sections}
+
 Under IOP style conventions, journal names should be set in italic
 type.  However, for journals with multiple lettered sections, the IOP
 convention is that the journal section letter should appear in roman
@@ -112,6 +112,8 @@ in the \BibTeX{} database entry.  Note that section names longer than a
 single letter are also supported (\textit{e.g.},
 ``\textit{Phys. Rev.\/} ST Accel. Beams'').
 
+\subsection{Journal issue numbers}
+
 Journal issue numbers are not customarily included in references to
 journal articles under the IOP formatting conventions.
 Therefore, the
@@ -128,6 +130,42 @@ enforce printing of the issue number.  If a value is specified for
 number in the reference, as in
 ref.~\cite{zamfir2005:132te-beta-enam04}.
 
+\subsection{Multivolume books}
+
+The IOP guidelines distinguish between a volume
+in a {\it series}
+and a volume of a {\it  multivolume book} or {\it set}.  For a volume in
+a series, the series title and volume number are given in parentheses
+after the book title~\cite{ex8}.
+For an individual volume in a multivolume book, the book title is
+given first, followed by the volume number and volume title~\cite{ex9}.
+
+The
+\texttt{iopart-num} style supports an additional field
+\verb+volumetitle+ in the \BibTeX{} database entry, which can be used to 
+specify the title for an individual volume of a multivolume
+book, as in refs.~\cite{ex9,bohr1998:v2}.  For example, the entry for
+ref.~\cite{bohr1998:v2} is generated with
+\begin{verbatim}
+  title = "Nuclear Structure",
+  volume = 2,
+  volumetitle = "Nuclear Deformations",
+\end{verbatim}
+in the \BibTeX{} database entry.  In contrast, most existing \BibTeX{} styles 
+allow you to reference a volume of a multivolume
+book by specifying \verb+title+ and
+\verb+volume+, as in
+refs.~\cite{ex7,siegbahn1965:v1}, but do not provide for inclusion of
+any specific title for the individual volume.  A volume in a
+series~\cite{ex8,iachello2006:liealg} is indicated in
+\texttt{iopart-num}, as in most other \BibTeX{}
+styles, 
+by specifying
+\verb+title+, \verb+volume+, and
+\verb+series+ in the \BibTeX{} database entry.  
+
+\subsection{E-prints, collaborations, and other \REVTeX{} data fields}
+
 The \texttt{iopart-num} style supports several additional data fields
 (\verb+collaboration+, \verb+eid+, \verb+eprint+, 
 \verb+numpages+, and \verb+url+) introduced in
@@ -138,11 +176,12 @@ The \texttt{iopart-num} style supports several additional data fields
 
 The entries in the reference list below provide examples of the
 formatting of various types of references, of varying complexity,
-including journal articles, books (individual, multivolume, or in a
-series), articles in books, theses, and unpublished references.  The
+including journal articles, articles in proceedings or collections,
+books (individual, multivolume, or in a series), theses, and
+unpublished references.  The
 \BibTeX{} database entries used to generate these examples can be
 found in the file \texttt{iopart-num.bib}.
-Refs.~\cite{ex1,ex2,ex3,ex4,ex5,ex6,ex7,ex8} are based upon example entries
+Refs.~\cite{ex1,ex2,ex3,ex4,ex5,ex6,ex7,ex8,ex9} are based upon example entries
 from the IOP guidelines.
 
 \section*{References}