summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/revtex/auguide/whatsnew4-1.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/revtex/auguide/whatsnew4-1.tex')
-rw-r--r--Master/texmf-dist/doc/latex/revtex/auguide/whatsnew4-1.tex161
1 files changed, 161 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/revtex/auguide/whatsnew4-1.tex b/Master/texmf-dist/doc/latex/revtex/auguide/whatsnew4-1.tex
new file mode 100644
index 00000000000..502621b460c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/revtex/auguide/whatsnew4-1.tex
@@ -0,0 +1,161 @@
+%% ****** Start of file whatsnew4-1.tex ****** %
+%%
+%% This file is part of the APS files in the REVTeX 4 distribution.
+%% Version 4.1 of REVTeX, October 2009
+%%
+%% Copyright (c) 2009 The American Physical Society.
+%%
+%% See the REVTeX 4.1 README file for restrictions and more information.
+%%
+\documentclass[%
+%prl%
+%,preprint%
+,twocolumn%
+,secnumarabic%
+%,tightenlines%
+,amssymb,aps,prl,nobibnotes]{revtex4-1}
+\usepackage{docs}
+%\usepackage{acrofont}%NOTE: Comment out this line for the release version!
+%\usepackage[colorlinks=true,linkcolor=blue]{hyperref}%
+%\nofiles
+\expandafter\ifx\csname package@font\endcsname\relax\else
+ \expandafter\expandafter
+ \expandafter\usepackage
+ \expandafter\expandafter
+ \expandafter{\csname package@font\endcsname}%
+\fi
+\DeclareRobustCommand\substyle{\name@idx{document substyle}}%
+\DeclareRobustCommand\classoption{\name@idx{document class option}}%
+\DeclareRobustCommand\classname{\name@idx{document class}}%
+\def\name@idx#1#2{%
+ {\ttfamily#2}%
+ \index{#2\space#1=\string\ttt{#2}\space#1}\index{#1>#2=\string\ttt{#2}}%
+}%
+
+\DeclareRobustCommand\revtex{REV\TeX}
+\begin{document}
+\title{What's New in \revtex~4.1}%
+\author{American Physical Society}%
+%\email{revtex4@aps.org}
+\affiliation{1 Research Road, Ridge, NY 11961}
+\date{October 2009}%
+
+%\tableofcontents
+
+\begin{abstract}
+This document gives a brief summary of what's new in \revtex~4.1. The changes include bug fixes, improved functionality, and support for a wider range of journals, including those of the American Institute of Physics (AIP). \revtex~4.1 was developed jointly by APS, AIP, and Arthur Ogawa. Additional work was done by Patrick Daly to incorporate our suggested improvements into \texttt{natbib 8.3} to address many new features concerning bibliographies. \texttt{natbib 8.3} or later is required to run \revtex~4.1.
+\end{abstract}
+\maketitle
+
+\section{New Syntax and Features in \revtex~4.1}
+\revtex~4.1 introduces support for more journals, several new commands, and some new syntax. This section outlines these changes. \textbf{A document using these new features will not process under \revtex~4}. See Sec.~\ref{sec:additional} for more details about these items.
+
+\begin{itemize}
+\item \textbf{Added support for APS journal \textit{Physical Review Special Topics -- Physics Education Research}}.
+\item \textbf{Added support for AIP journals.} There is now an explicit \texttt{aip} society option along with support for AIP journals. Please see the \textit{Author's Guide to AIP Substyles for \revtex~4.1}. In addition, \revtex~4.1 provides an extensible system for the easy addition of new collections of journals.
+\item \textbf{Endnotes now ordered correctly.} Endnotes in the bibliography now appear in the correct order, interleaved with citations.
+\item \textbf{Multiple references in a single citation supported using a special starred (*) argument to the \cmd\cite\ command.} One of the major new features in 4.1 made possible by the joint work on \texttt{natbib 8.3}. Multiple Bib\TeX\ entries can be combined into a single \cmd\bibitem\ command.
+\item \textbf{Free form text can be prepended and appended to a bibliographic entry using the special starred (*) argument to the \cmd\cite\ command.} Often a citation in the bibliography will have explanatory text such as \textit{See also} or \textit{and references therein} before and after the actual citation. The new \revtex~4.1 \cmd\cite\ command allows the specification of both text to precede and follow a citation.
+\item \textbf{Structured Abstracts.} Use of the \texttt{description} environment in abstracts now provides for ``structured" abstracts.
+\item \textbf{Figures referring to videos now supported.} A ``figure" may now be labeled as a \textbf{Video} by using the \texttt{video} environment. A frame from the video may be included in the figure and a URL to link the caption's label to the online video also may be included. There is also a \cmd\listofvideos\ command.
+\item \textbf{Better support for arXiv.org in Bib\TeX\ } Three more Bib\TeX\ fields have been added: \texttt{SLACcitation}, \texttt{archivePrefix}, and \texttt{primaryClass} in addition to the existing field \texttt{eprint}.
+\end{itemize}
+
+\section{Bug Fixes in \revtex~4.1}
+One of the main goals of \revtex~4.1 is, of course, to fix the bugs that were released in \revtex~4. The following is a list of bugs that have been fixed.
+
+\begin{itemize}
+\item \textbf{Improved Bib\TeX\ \texttt{bst} files.} In addition to the new features above, numerous other improvements to the APS \texttt{bst} files have been made, including support for displaying journal article titles and many fixes for \textit{Reviews of Modern Physics}. Also, long author lists are no longer automatically truncated.
+\item \textbf{\cmd\footnote\ in \cmd\widetext\ and \texttt{table*} environments improved.} \cmd\footnote\relax s in the \cmd\widetext\ or \texttt{table*} environments are now correctly placed and formatted.
+\item \textbf{Email addresses no longer print twice on papers less than one page long.}
+\item \textbf{\texttt{eqnarray} alignment improved.}
+\item \textbf{\cmd\collaboration\ can be used with the \texttt{groupedaddress} option now.}
+\item \textbf{\texttt{letterpaper} now ensured as default paper size.}
+\item \textbf{Table of Contents formatting improved.}
+\item \textbf{Support for \texttt{longtable} package improved.}
+\item \textbf{\texttt{reftest} restored.}
+\item \textbf{Compatibility with the \texttt{geometry, lineno,} and \texttt{colortbl} packages improved.} For line numbering, rather than using \texttt{lineno.sty} directly, the \texttt{linenumbers} class option should be used (this will call in \texttt{lineno.sty} with a proper set of default parameters).
+\item \texttt{hyperref} \textbf{fixes}. Improved compatibility between footnotes and the \texttt{hyperref} package. In particular, table footnotes were fixed. More anchors for \texttt{hyperref} were also added (titlepage, abstract, and acknowledgements).
+\item \textbf{Documents can have more than 256 \cmd\cite\ commands now.}
+\item \textbf{\cmd\listoffigures\ and \cmd\listoftables\ fixed.}
+\item \textbf{Figure and table labels in captions now reflect proper APS style.}
+\item \textbf{RMP style files conform better to RMP style guidelines.}
+\item \textbf{Section heading upper-casing improved.}
+\item \textbf{Repeated characters at start of affiliation no longer disappear when using \texttt{groupedaddress} option.}
+\item \textbf{There have been many other bug fixes and improvements to the internal \texttt{ltxgrid} package as well.}
+\end{itemize}
+
+\section{\revtex~4 Backwards Compatibility}
+The vast majority of documents prepared under \revtex~4 should process correctly under \revtex~4.1. However, the formatting of the pages and, if using Bib\TeX, the references may change. Also, the behavior of some macros may be different. For instance, the \texttt{title} macro now requires the use of \texttt{protect} for fragile arguments. This may cause some documents prepared under \revtex~4 to fail under 4.1. Some macro packages that depend on the internals of \revtex~4 may also no longer work. Documents using those packages will, of course, also will not process under 4.1.
+
+\section{\label{sec:additional}Additional Details}
+
+\subsection{Multiple references in a single bibliography entry}
+One of the most frequently requested features since the release of \revtex~4 has been to allow more than one reference to appear in a single bibliography entry when using Bib\TeX. This can now be done in \revtex~4.1 by using a starred (*) argument to the \cmd\cite\ command. This requires the latest version of \texttt{natbib}, developed in conjunction with \revtex~4.1, and the new \texttt{bst} files that come with \revtex~4.1. To combine multiple references into a single \cmd\bibitem, precede the second, third, etc. citation keys in the \cmd\cite\ command with an asterisk (*). For example \verb+\cite{bethe, *feynman, *bohr}+ will combine the \cmd\bibitem\relax s with keys \texttt{bethe}, \texttt{feynman}, and \texttt{bohr} into a single entry in the bibliography separated by semicolons.
+
+\subsection{Prepending and/or appending text to a citation}
+The expanded syntax for the \cmd\cite\ command argument can also be used to specify text before and/or after a citation. For instance, a citation such as:
+\begin{verbatim}
+[19] A similar expression was derived in
+A. V. Andreev, Phys. Rev. Lett. 99, 247204
+(2007) in the context of carbon nanotube
+p-n junctions. The only difference is that no
+integration over ky is present there.
+\end{verbatim}
+may be created by the following \cmd\cite\ command:
+\begin{verbatim}
+\cite{*[{A similar expression was derived
+in }] [{ in the context of carbon nanotube
+p-n junctions. The only difference is that no
+integration over ky is present there.}]andreev2007]
+\end{verbatim}
+Please note the use of curly braces to enclose the text within the square brackets.
+\subsection{Structured Abstracts}
+A ``structured" abstract is an abstract divided into labeled sections. For instance, \textit{Physical Review C} would like authors to provide abstracts with sections summarizing the paper's \textbf{Background}, \textbf{Purpose}, \textbf{Method}, \textbf{Results}, and \textbf{Conclusions}. This can be accomplished by using the \texttt{description} environment within the \texttt{abstract} environment. For example:
+\begin{verbatim}
+\begin{abstract}
+\begin{description}
+\item[Background] This part would describe the
+context needed to understand what the paper
+is about.
+\item[Purpose] This part would state the purpose
+of the present paper.
+\item[Method] This part describe the methods
+used in the paper.
+\item[Results] This part would summarize the
+results.
+\item[Conclusions] This part would state the
+conclusions of the paper.
+\end{description}
+\end{abstract}
+\end{verbatim}
+
+\subsection{Video Environment}
+Papers often refer to multimedia videos. The \texttt{video} environment is identical to the \texttt{figure} environment, but the caption will be labeled as a \textbf{Video} (with its own counter independent of figures). A URL can also be specified so that the caption label can be linked to the online video (if using the \texttt{hyperref} package). The included graphic (using \cmd\includegraphics\ from the \texttt{graphics} or \texttt{graphicx} package) would be a representation frame from the video. A \texttt{\cmd\listofvideos} is also provided. For example:
+\begin{verbatim}
+\begin{video}
+\includegraphics{videoframe.jpg}
+\setfloatlink{http://some.video.com/fun.mov}
+\caption{\label{vid:interest}This is a video of
+something fun.}
+\end{video}
+\end{verbatim}
+
+\subsection{Better arXiv.org support in Bib\TeX\ }
+
+
+There have been substantial improvements in the \revtex\ Bib\TeX\ style files. For instance, the \texttt{.bib} entry
+\begin{verbatim}
+@Unpublished{Ginsparg:1988ui,
+ author = "Ginsparg, Paul H.",
+ title = "{APPLIED CONFORMAL FIELD THEORY}",
+ year = "1988",
+ eprint = "hep-th/9108028",
+ archivePrefix = "arXiv",
+ SLACcitation = "%%CITATION = HEP-TH/9108028;%%"
+}
+\end{verbatim}
+will include the arXiv.org e-print identifier as \texttt{arXiv:hep-th/9108028} and hyperlink it (if using \texttt{hyperref}). The newer format for arXiv identifiers with primary classificiations will produce output such as \texttt{arXiv:0905.1949 [hep-ph]}.
+
+
+\end{document}