~chris-rogers/maus/emr_mc_digitization

« back to all changes in this revision

Viewing changes to doc/doc_src/detectors/tracker/01-Current/99-Styles/revtex4-1/revtex4-1-tds/doc/latex/revtex/auguide/whatsnew4-1.tex

  • Committer: Chris Rogers
  • Date: 2014-04-16 11:48:45 UTC
  • mfrom: (707 merge)
  • mto: This revision was merged to the branch mainline in revision 711.
  • Revision ID: chris.rogers@stfc.ac.uk-20140416114845-h3u3q7pdcxkxvovs
Update to trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
%% ****** Start of file whatsnew4-1.tex ****** %
2
 
%%
3
 
%%   This file is part of the APS files in the REVTeX 4 distribution.
4
 
%%   Version 4.1r of REVTeX, August, 2010
5
 
%%
6
 
%%   Copyright (c) 2009, 2010 The American Physical Society.
7
 
%%
8
 
%%   See the REVTeX 4.1 README file for restrictions and more information.
9
 
%%
10
 
\documentclass[%
11
 
%prl%
12
 
%,preprint%
13
 
,twocolumn%
14
 
,secnumarabic%
15
 
%,tightenlines%
16
 
,amssymb,aps,pra,nobibnotes]{revtex4-1}
17
 
\usepackage{docs}
18
 
%\usepackage{acrofont}%NOTE: Comment out this line for the release version!
19
 
%\usepackage[colorlinks=true,linkcolor=blue]{hyperref}%
20
 
%\nofiles
21
 
\expandafter\ifx\csname package@font\endcsname\relax\else
22
 
 \expandafter\expandafter
23
 
 \expandafter\usepackage
24
 
 \expandafter\expandafter
25
 
 \expandafter{\csname package@font\endcsname}%
26
 
\fi
27
 
\DeclareRobustCommand\substyle{\name@idx{document substyle}}%
28
 
\DeclareRobustCommand\classoption{\name@idx{document class option}}%
29
 
\DeclareRobustCommand\classname{\name@idx{document class}}%
30
 
\def\name@idx#1#2{%
31
 
 {\ttfamily#2}%
32
 
 \index{#2\space#1=\string\ttt{#2}\space#1}\index{#1>#2=\string\ttt{#2}}%
33
 
}%
34
 
 
35
 
\DeclareRobustCommand\revtex{REV\TeX}
36
 
\begin{document}
37
 
\title{What's New in  \revtex~4.1}%
38
 
\author{American Physical Society}%
39
 
%\email{revtex4@aps.org}
40
 
\affiliation{1 Research Road, Ridge, NY 11961}
41
 
\date{August 2010}%
42
 
 
43
 
%\tableofcontents
44
 
 
45
 
\begin{abstract}
46
 
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.31a} or later is required to run \revtex~4.1.
47
 
\end{abstract}
48
 
\maketitle
49
 
 
50
 
\section{New Syntax and Features in \revtex~4.1}
51
 
\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.
52
 
 
53
 
\begin{itemize}
54
 
\item \textbf{Added support for APS journal \textit{Physical Review Special Topics -- Physics Education Research}}.
55
 
\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.
56
 
\item \textbf{Endnotes now ordered correctly.} Endnotes in the bibliography now appear in the correct order, interleaved with citations.
57
 
\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.
58
 
\item \textbf{Bib\TeX\ style files can now display journal article titles in the bibliography.} Use the \texttt{longbibliography} class option.
59
 
\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.
60
 
\item \textbf{Structured Abstracts.} Use of the \texttt{description} environment in abstracts now provides for ``structured" abstracts.
61
 
\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.
62
 
\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}. 
63
 
\end{itemize}
64
 
 
65
 
\section{Bug Fixes in \revtex~4.1}
66
 
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.
67
 
 
68
 
\begin{itemize}
69
 
\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.
70
 
\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.
71
 
\item \textbf{Email addresses no longer print twice on papers less than one page long.}
72
 
\item \textbf{\texttt{eqnarray} alignment improved.}
73
 
\item \textbf{\cmd\collaboration\ can be used with the \texttt{groupedaddress} option now.}
74
 
\item \textbf{\texttt{letterpaper} now ensured as default paper size.} 
75
 
\item \textbf{Table of Contents formatting improved.}
76
 
\item \textbf{Support for \texttt{longtable} and \texttt{lscape} packages improved.}
77
 
\item \textbf{\texttt{reftest} restored.}
78
 
\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).
79
 
\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).
80
 
\item \textbf{Documents can have more than 256 \cmd\cite\ commands now.}
81
 
\item \textbf{\cmd\listoffigures\ and \cmd\listoftables\ fixed.}
82
 
\item \textbf{Figure and table labels in captions now reflect proper APS style.}
83
 
\item \textbf{RMP style files conform better to RMP style guidelines.}
84
 
\item \textbf{Section heading upper-casing improved.}
85
 
\item \textbf{Repeated characters at start of affiliation no longer disappear when using \texttt{groupedaddress} option.}
86
 
\item \textbf{There have been many other bug fixes and improvements to the internal \texttt{ltxgrid} package as well.}
87
 
\end{itemize}
88
 
 
89
 
\section{\revtex~4 Backwards Compatibility}
90
 
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.
91
 
 
92
 
\section{\label{sec:additional}Additional Details}
93
 
 
94
 
\subsection{Multiple references in a single bibliography entry}
95
 
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.
96
 
 
97
 
\subsection{Prepending and/or appending text to a citation}
98
 
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:
99
 
\begin{verbatim}
100
 
[19] A similar expression was derived in
101
 
A. V. Andreev, Phys. Rev. Lett. 99, 247204
102
 
(2007) in the context of carbon nanotube
103
 
p-n junctions. The only difference is that no
104
 
integration over ky is present there.
105
 
\end{verbatim}
106
 
may be created by the following \cmd\cite\ command:
107
 
\begin{verbatim}
108
 
\cite{*[{A similar expression was derived
109
 
in }] [{ in the context of carbon nanotube
110
 
p-n junctions. The only difference is that no
111
 
integration over ky is present there.}]andreev2007]
112
 
\end{verbatim}
113
 
Please note the use of curly braces to enclose the text within the square brackets.
114
 
\subsection{Structured Abstracts}
115
 
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:
116
 
\begin{verbatim}
117
 
\begin{abstract}
118
 
\begin{description}
119
 
\item[Background] This part would describe the
120
 
context needed to understand what the paper
121
 
is about.
122
 
\item[Purpose] This part would state the purpose
123
 
of the present paper.
124
 
\item[Method] This part describe the methods
125
 
used in the paper.
126
 
\item[Results] This part would summarize the
127
 
results.
128
 
\item[Conclusions] This part would state the
129
 
conclusions of the paper.
130
 
\end{description}
131
 
\end{abstract}
132
 
\end{verbatim}
133
 
 
134
 
\subsection{Video Environment}
135
 
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:
136
 
\begin{verbatim}
137
 
\begin{video}
138
 
\includegraphics{videoframe.jpg}
139
 
\setfloatlink{http://some.video.com/fun.mov}
140
 
\caption{\label{vid:interest}This is a video of
141
 
something fun.}
142
 
\end{video}
143
 
\end{verbatim}
144
 
 
145
 
\subsection{Better arXiv.org support in Bib\TeX\ }
146
 
 
147
 
 
148
 
There have been substantial improvements in the \revtex\ Bib\TeX\ style files. For instance, the \texttt{.bib} entry
149
 
\begin{verbatim}
150
 
@Unpublished{Ginsparg:1988ui,
151
 
     author    = "Ginsparg, Paul H.",
152
 
     title     = "{APPLIED CONFORMAL FIELD THEORY}",
153
 
     year      = "1988",
154
 
     eprint    = "hep-th/9108028",
155
 
     archivePrefix = "arXiv",
156
 
     SLACcitation  = "%%CITATION = HEP-TH/9108028;%%"
157
 
}
158
 
\end{verbatim}
159
 
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]}.
160
 
 
161
 
 
162
 
\begin{acknowledgments}
163
 
The development of  \revtex~4.1 was managed by Mark Doyle (APS). The development of the new AIP style files and their accompanying documentation was managed by Susan Joy (AIP) with the help of Chris McMahon (AIP) and Rich O'Keeffe (AIP). Testing and  evaluation were done by Michele Hake (APS), Liz Belmont (AIP), Brian Goss (AIP), Alison Waldron (AIP),  and Phil Robertson (AIP). Additional detailed testing and feedback were provided by Lev Bishop (Yale).
164
 
\end{acknowledgments}
165
 
 
166
 
\end{document}