summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-12-26 22:58:14 +0000
committerKarl Berry <karl@freefriends.org>2006-12-26 22:58:14 +0000
commit3c0f8633c92bdac2228b07e937ded1ad20c654c9 (patch)
treef7bae4c15084420e0e88e774bf8874f34a3aeebd /Master/texmf-dist/doc
parent4caf9036e5da2d823e0d3910e77b58584e234349 (diff)
iopart-num update
git-svn-id: svn://tug.org/texlive/trunk@2946 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/bibtex/iopart-num/README (renamed from Master/texmf-dist/doc/latex/iopart-num/README)23
-rwxr-xr-xMaster/texmf-dist/doc/bibtex/iopart-num/iopart-num.bib156
-rwxr-xr-xMaster/texmf-dist/doc/bibtex/iopart-num/iopart-num.pdfbin0 -> 60768 bytes
-rwxr-xr-xMaster/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex152
-rw-r--r--Master/texmf-dist/doc/latex/iopart-num/example-article.pdfbin49563 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/iopart-num/example-article.tex23
-rw-r--r--Master/texmf-dist/doc/latex/iopart-num/example-iopart.tex29
7 files changed, 317 insertions, 66 deletions
diff --git a/Master/texmf-dist/doc/latex/iopart-num/README b/Master/texmf-dist/doc/bibtex/iopart-num/README
index de34868a998..d83d465dfbf 100644
--- a/Master/texmf-dist/doc/latex/iopart-num/README
+++ b/Master/texmf-dist/doc/bibtex/iopart-num/README
@@ -5,29 +5,24 @@ iopart-num -- BibTeX style for IOP journals
The iopart-num BibTeX style is intended for use with Institute of
Physics Publishing journals, including Journal of Physics. A numeric
citation style with Harvard-like formatting is provided, based upon
-the specification in "Preparing an article for publication in an
-Institute of Physics Publishing journal using LaTeX2e", by Neil
-Scriven and Romneya Robertson.
+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,
-natbib. Further instructions for use with or without natbib are given
-in comments at the start of the file iopart-num.bst.
+the natbib package.
-The distribution contains the BibTeX style file (iopart-num.bst), test
-documents for use with the article and iopart document classes
-(example-article.tex and example-iopart.tex), and the database file
-required by these documents (iopart-num-example.bib).
+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).
--------------------------------
Mark A. Caprio, Yale University
-July 11, 2005
-Version 1.0
+December 21, 2006
+Version 2.0
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. You may freely copy or distribute this
-software, but if you modify it and distribute it (even locally) you
-must change the name to avoid confusion.
+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
new file mode 100755
index 00000000000..156478cb220
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.bib
@@ -0,0 +1,156 @@
+@article{ex1,
+ author = "A. Cisneros",
+ journal = "Astrophys. Space Sci.",
+ volume = 10,
+ pages = 87,
+ year = 1971
+}
+
+@article{ex2,
+ author = "S. Carlip and R. Vera",
+ journal = "Phys. Rev. D",
+ section = "D",
+ volume = 58,
+ pages = 011345,
+ year = 1998
+}
+
+@article{ex3,
+ author = "K. Davies and G. Brown",
+ journal = "J. High Energy Phys.",
+ pages = "JHEP12(1997)002",
+ year = 1997
+}
+
+@article{ex4,
+ author = "D. Neilson and M. Choptuik",
+ journal = "Class. Quantum Grav.",
+ volume = 17,
+ pages = 761,
+ year = 2000,
+ eprint = "gr-qc/9812053"
+}
+
+@unpublished{ex5,
+ author = "M. Harrison",
+ title = "Dipheomorphism-invariant manifolds",
+ year = 1999,
+ eprint = "hep-th/9909196"
+}
+
+@inbook{ex6,
+ author = "L. I. Dorman",
+ title = "Variations of Galactic Cosmic Rays",
+ publisher = "Moscow State University Press",
+ address = "Moscow",
+ year = 1975,
+ pages = 103
+}
+
+@inbook{ex7,
+ author = "R. Caplar and P. Kulisic",
+ title = "Proc. Int. Conf. on Nuclear Physics (Munich)",
+ publisher = "North-Holland/American Elsevier",
+ address = "Amsterdam",
+ year = 1973,
+ volume = 1,
+ pages = 517
+}
+
+@incollection{ex8,
+ author = "M. Morse",
+ title = "Supersonic beam sources",
+ booktitle = "Atomic Molecular and Optical Physics",
+ editor = "F. B. Dunning and R. Hulet",
+ series = "Experimental Methods in the Physical Sciences",
+ volume = 29,
+ publisher = "Academic",
+ address = "San Diego",
+ year = 1996
+}
+
+@article{bardeen1957:bcs,
+ author = "J. Bardeen and L. N. Cooper and J. R. Schrieffer",
+ journal = "Phys. Rev.",
+ volume = 108,
+ number = 5,
+ pages = 1175,
+ year = 1957
+}
+
+@article{caprio2005:coherent,
+ author = "M. A. Caprio",
+ journal = "J. Phys. A",
+ section = "A",
+ volume = 38,
+ number = 28,
+ pages = 6385,
+ year = 2005
+}
+
+@article{zamfir2005:132te-beta-enam04,
+ author = "N. V. Zamfir and others",
+ journal = "Eur. Phys. J. A",
+ section = "A",
+ volume = 25,
+ number = "s01",
+ issue = "s01",
+ year = 2005,
+ pages = 389
+}
+
+@book{rose1957:am,
+ author = "M. E. Rose",
+ title = "Elementary Theory of Angular Momentum",
+ publisher = "Wiley",
+ address = "New York",
+ year = 1957,
+}
+
+@book{dirac1958:qm,
+ author = "P. A. M. Dirac",
+ title = "The Principles of Quantum Mechanics",
+ series = "The International Series of Monographs on Physics",
+ number = 27,
+ edition = 4,
+ publisher = "Clarendon Press",
+ address = "Oxford",
+ year = 1967
+}
+
+@book{siegbahn1965:v1,
+ editor = "K. Siegbahn",
+ title = "Alpha-, Beta-, and Gamma-Ray Spectroscopy",
+ booktitle = "Alpha-, Beta-, and Gamma-Ray Spectroscopy",
+ publisher = "North-Holland",
+ address = "Amsterdam",
+ year = 1965,
+ 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,
+ volume = 2,
+ pages = 905
+}
+
+@phdthesis{caprio2003:diss,
+ author = "M. A. Caprio",
+ school = "Yale University",
+ year = 2003,
+ eprint = "nucl-ex/0502004",
+ archive = "arXiv"
+}
+
+@misc{doePC,
+ author = "J. Doe",
+ year = 2006,
+ note = "private communication"
+}
+
diff --git a/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.pdf b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.pdf
new file mode 100755
index 00000000000..32f5f591b72
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex
new file mode 100755
index 00000000000..f24291e4db6
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex
@@ -0,0 +1,152 @@
+\documentclass[12pt]{iopart}
+
+\bibliographystyle{iopart-num}
+\usepackage{citesort}
+%% \usepackage[square,sort&compress]{natbib}
+
+\newcommand{\BibTeX}{Bib\TeX}
+\newcommand{\REVTeX}{REV\TeX}
+
+\sloppy
+
+\begin{document}
+\nocite{*}
+
+\title{The \texttt{iopart-num} \BibTeX{} style}
+
+\noindent \qquad \\[-6pt] \qquad Version 2.0\\\qquad December 21, 2006
+
+\author{M~A~Caprio}
+
+\address{Center for Theoretical Physics, Sloane Physics Laboratory,
+Yale University, New Haven, Connecticut 06520-8120, USA}
+
+\section{Introduction}
+
+The \texttt{iopart-num} \BibTeX{} style is intended for use in
+preparing manuscripts for Institute of Physics Publishing journals,
+including Journal of Physics. It provides numeric citation with
+Harvard-like formatting, based upon the specification in ``How to
+prepare and submit an article for publication in an IOP journal using
+\LaTeXe'' by Graham Douglas (2005).
+
+The \texttt{iopart-num} package is available on the Comprehensive
+\TeX{} Archive Network (CTAN) as \texttt{/biblio/bibtex/contrib/iopart-num}.
+
+\section{General instructions}
+
+To use the \texttt{iopart-num} style, include the command
+\verb+\bibliographystyle{iopart-num}+ in the
+document preamble. The reference section is then inserted into the
+document with the command \verb+\bibliography{...}+, where the names
+of the necessary \BibTeX{} database files should be listed between the
+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
+\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}
+
+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
+type after the main journal name, \textit{e.g.}, ``\textit{J.\
+Phys.\/} A''. Most existing \BibTeX{} styles do not make special
+provision for lettered sections. Therefore, typically, the section
+letter is either included as part of the journal name
+\begin{verbatim}
+ journal = "J. Phys. A",
+ volume = "38",
+\end{verbatim}
+or as part of the volume number
+\begin{verbatim}
+ journal = "J. Phys.",
+ volume = "A38",
+\end{verbatim}
+in the \BibTeX{} database entry. The \texttt{iopart-num} style
+instead introduces a new optional field \verb+section+ which can be
+used to specify a journal section letter. This section letter is set in
+roman type. Moreover, if the section letter already appears in
+\textit{any} of the usual locations in the database entry (at the end
+of the journal name, before the volume number, or after the volume
+number),
+\texttt{iopart-num} will recognize it and suppress its printing.
+Therefore, when you are creating the
+\BibTeX{} database entry for an article in a lettered journal section,
+you can still include the section letter in the \verb+journal+ or
+\verb+volume+ fields, for use with other \BibTeX{} styles,
+without adversely affecting the formatting for IOP journals. For
+example, the entry for ref.~\cite{caprio2005:coherent} can be
+generated with
+\begin{verbatim}
+ journal = "J. Phys. A",
+ section = "A",
+ volume = "38",
+\end{verbatim}
+or
+\begin{verbatim}
+ journal = "J. Phys.",
+ section = "A",
+ volume = "A38",
+\end{verbatim}
+or simply
+\begin{verbatim}
+ journal = "J. Phys.",
+ section = "A",
+ volume = "38",
+\end{verbatim}
+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'').
+
+Journal issue numbers are not customarily included in references to
+journal articles under the IOP formatting conventions.
+Therefore, the
+\texttt{iopart-num} style ignores the
+\verb+number+ field for articles.
+However, in some periodicals (such as popular magazines or certain
+journal online supplements), pagination restarts from 1 with each
+issue. For such periodicals, the issue number is an essential part of
+the bibliographic information needed to identify an article. The
+\texttt{iopart-num} style therefore supports an additional field
+\verb+issue+ in the \BibTeX{} database entry, which can be used to
+enforce printing of the issue number. If a value is specified for
+\verb+issue+, this value is included included parenthetically after the volume
+number in the reference, as in
+ref.~\cite{zamfir2005:132te-beta-enam04}.
+
+The \texttt{iopart-num} style supports several additional data fields
+(\verb+collaboration+, \verb+eid+, \verb+eprint+,
+\verb+numpages+, and \verb+url+) introduced in
+\REVTeX{}~4.
+
+
+\section{Examples}
+
+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
+\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
+from the IOP guidelines.
+
+\section*{References}
+\bibliography{iopart-num}
+
+\end{document}
+
diff --git a/Master/texmf-dist/doc/latex/iopart-num/example-article.pdf b/Master/texmf-dist/doc/latex/iopart-num/example-article.pdf
deleted file mode 100644
index 5ea1ffd1c45..00000000000
--- a/Master/texmf-dist/doc/latex/iopart-num/example-article.pdf
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/iopart-num/example-article.tex b/Master/texmf-dist/doc/latex/iopart-num/example-article.tex
deleted file mode 100644
index 5fcd57c1b62..00000000000
--- a/Master/texmf-dist/doc/latex/iopart-num/example-article.tex
+++ /dev/null
@@ -1,23 +0,0 @@
-\documentclass[10pt]{article}
-\bibliographystyle{iopart-num}
-
-\begin{document}
-
-\title{Test document for iopart-num
-with the article document class}
-
-\author{M~A~Caprio}
-
-\maketitle
-
-\section{Introduction}
-
-This file may be used to test the iopart-num BibTeX style.
-This version of the file is for use with the article document class.
-
-\nocite{*}
-
-\bibliography{iopart-num-example}
-
-\end{document}
-
diff --git a/Master/texmf-dist/doc/latex/iopart-num/example-iopart.tex b/Master/texmf-dist/doc/latex/iopart-num/example-iopart.tex
deleted file mode 100644
index 6629f4c3dac..00000000000
--- a/Master/texmf-dist/doc/latex/iopart-num/example-iopart.tex
+++ /dev/null
@@ -1,29 +0,0 @@
-\documentclass[12pt]{iopart}
-\bibliographystyle{iopart-num}
-
-\begin{document}
-
-\title{Test document for iopart-num with the iopart document class}
-
-\author{M~A~Caprio}
-
-\address{Center for Theoretical Physics, Sloane Physics Laboratory,
-Yale University, New Haven, Connecticut 06520-8120, USA}
-
-
-\begin{abstract}
-This file may be used to test the iopart-num BibTeX style.
-\end{abstract}
-
-\section{Introduction}
-
-This file may be used to test the iopart-num BibTeX style.
-This version of the file is for use with the iopart document class.
-
-\nocite{*}
-
-\section*{References}
-\bibliography{iopart-num-example}
-
-\end{document}
-