1 | %% ****** Start of file authguide.tex ****** % |
---|
2 | %% |
---|
3 | %% This file is part of the APS files in the REVTeX 4 distribution. |
---|
4 | %% Version 4.0 of REVTeX, August 2001 |
---|
5 | %% |
---|
6 | %% Copyright (c) 2000, 2001 The American Physical Society. |
---|
7 | %% |
---|
8 | %% See the REVTeX 4 README file for restrictions and more information. |
---|
9 | %% |
---|
10 | \documentclass[% |
---|
11 | %prl% |
---|
12 | %,preprint% |
---|
13 | ,twocolumn% |
---|
14 | ,secnumarabic% |
---|
15 | %,tightenlines% |
---|
16 | ,amssymb,aps,prl,nobibnotes]{revtex4} |
---|
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{Differences between \revtex~4 and \revtex~3}% |
---|
38 | \author{American Physical Society}% |
---|
39 | \email{revtex4@aps.org} |
---|
40 | \affiliation{1 Research Road, Ridge, NY 11961} |
---|
41 | \date{August 2001}% |
---|
42 | \maketitle |
---|
43 | \tableofcontents |
---|
44 | |
---|
45 | \section{Introduction} |
---|
46 | This document gives a brief summary of how \revtex~4 is different from |
---|
47 | what authors may already be familiar with. The two primary design |
---|
48 | goals for \revtex~4 are to 1) move to \LaTeXe\ and 2) improve the |
---|
49 | markup so that infomation can be more reliably extracted for the |
---|
50 | editorial and production processes. Both of these goals require that |
---|
51 | authors comfortable with earlier versions of \revtex\ change their |
---|
52 | habits. In addition, authors may already be familiar with the standard |
---|
53 | \classname{article.cls} in \LaTeXe. \revtex~4 differs in some |
---|
54 | important ways from this class as well. For more complete |
---|
55 | documentation on \revtex~4, see the main \textit{\revtex~4 Author's |
---|
56 | Guide}. The most important changes are in the markup of the front |
---|
57 | matter (title, authors, affiliations, abstract, etc.). Please see |
---|
58 | Sec.~\ref{sec:front}. |
---|
59 | |
---|
60 | \section{Version of \LaTeX} |
---|
61 | The most obvious difference between \revtex~4 and \revtex~3 is that |
---|
62 | \revtex~4 works solely with \LaTeXe; it is not useable as a \LaTeX2.09 package. |
---|
63 | Furthermore, \revtex~4 requires an up-to-date \LaTeX\ installation |
---|
64 | (1996/06/01 or later); its use under older versions is not supported. |
---|
65 | |
---|
66 | \section{Class Options and Defaults} |
---|
67 | Many of the class options in \revtex~3 have been retained in |
---|
68 | \revtex~4. However, the default behavior for these options can be |
---|
69 | different than in \revtex~3. Currently, there is only one society |
---|
70 | option, \classoption{aps}, and this is the default. Furthermore, the |
---|
71 | selection of a journal (such as \classoption{prl}) will automatically |
---|
72 | set the society as well (this will be true even after other societies |
---|
73 | are added). |
---|
74 | |
---|
75 | In \revtex~3, it was necessary to invoke the \classoption{floats}, but |
---|
76 | this is the default for \classoption{aps} journal in |
---|
77 | \revtex~4. \revtex~4 introduces two new class options, |
---|
78 | \classoption{endfloats} and \classoption{endfloats*} for moving floats |
---|
79 | to the end of the paper. |
---|
80 | |
---|
81 | The preamble commands \cmd{\draft} and \cmd{\tighten} have been replaced |
---|
82 | with new class options \classoption{draft} and |
---|
83 | \classoption{tightenlines}, respectively. The \cmd{\preprint} command |
---|
84 | is now used only for specifying institutional report numbers (typeset |
---|
85 | in the upper-righthand corner of the first page); it no longer |
---|
86 | influences whether PACS numbers are displayed below the abstract. PACS |
---|
87 | display is controlled by the \classoption{showpacs} and |
---|
88 | \classoption{noshowpacs} (default) class options. |
---|
89 | |
---|
90 | Paper size options (\classoption{letter}, \classoption{a4paper}, etc.) |
---|
91 | work in \revtex~4. The text ``Typeset by \revtex'' no longer appears |
---|
92 | by default - the option \classoption{byrevtex} will place this text in |
---|
93 | the lower-lefthand corner of the first page. |
---|
94 | |
---|
95 | \section{One- and Two-column formatting} |
---|
96 | |
---|
97 | \revtex~4 has excellent support for achieving the two-column |
---|
98 | formatting in the \textit{Physical~Review} and \textit{Reviews of |
---|
99 | Modern Physics} styles. It will balance the columns |
---|
100 | automatically. Whereas \revtex~3 had the \cmd{\widetext} and |
---|
101 | \cmd{\narrowtext} commands for switching between one- and two-cloumn |
---|
102 | modes, \revtex~4 simply has a \env{widetext} environment, |
---|
103 | \envb{widetext} \dots \enve{widetext}. One-column formatting can be |
---|
104 | specified by choosing either the \classoption{onecolumn} or |
---|
105 | \classoption{preprint} class option (the \revtex~3 option |
---|
106 | \classoption{manuscript} no longer exists). Two-column formatting is |
---|
107 | the default for most journal styles, but can be specified with the |
---|
108 | \classoption{twocolumn} option. Note that the spacing for |
---|
109 | \classoption{preprint} is now set to 1.5, rather than full |
---|
110 | double-spacing. The \classoption{tightenlines} option can be used to |
---|
111 | reduce this to single spacing. |
---|
112 | |
---|
113 | |
---|
114 | \section{Front Matter Markup} |
---|
115 | \label{sec:front} |
---|
116 | |
---|
117 | \revtex~4 has substantially changed how the front matter for an article |
---|
118 | is marked up. These are the most significant differences between |
---|
119 | \revtex~4 and other systems for typesetting manuscripts. It is |
---|
120 | essential that authors new to \revtex~4 be familiar with these changes. |
---|
121 | |
---|
122 | \subsection{Authors, Affiliations, and Author Notes} |
---|
123 | \revtex~4 has substantially changed the markup of author names, |
---|
124 | affiliations, and author notes (footnotes giving additional |
---|
125 | information about the author such as a permanent address or an email |
---|
126 | address). |
---|
127 | \begin{itemize} |
---|
128 | \item Each author name should appear separately in |
---|
129 | individual \cmd\author\ macros. |
---|
130 | |
---|
131 | \item Email addresses should be marked up using the \cmd\email\ macro. |
---|
132 | |
---|
133 | \item Alternative affiliation information should be marked up using |
---|
134 | the \cmd\altaffiliation\ macro. |
---|
135 | |
---|
136 | \item URLs for author home pages can be specified with a |
---|
137 | \cmd\homepage\ macro. |
---|
138 | |
---|
139 | \item The \cmd\thanks\ macro should only be used if one of the above |
---|
140 | don't apply. |
---|
141 | |
---|
142 | \item \cmd{\email}, \cmd{\homepage}, \cmd{\altaffiliation}, and |
---|
143 | \cmd{\thanks} commands are grouped together under a single footnote for |
---|
144 | each author. These footnotes can either appear at the bottom of the |
---|
145 | first page of the article or as the first entries in the |
---|
146 | bibliography. The journal style controls this placement, but it may be |
---|
147 | overridden by using the class options \classoption{bibnotes} and |
---|
148 | \classoption{nobibnotes}. Note that these footnotes are treated |
---|
149 | differently than the other footnotes in the article. |
---|
150 | |
---|
151 | \item The grouping of authors by affiliations is accomplished |
---|
152 | automatically. Each affiliation should be in its own |
---|
153 | \cmd{\affiliation} command. Multiple \cmd{\affiliation}, |
---|
154 | \cmd{\email}, \cmd{\homepage}, \cmd{\altaffiliation}, and \cmd{\thanks} |
---|
155 | commands can be applied to each author. The macro \cmd\and\ has been |
---|
156 | eliminated. |
---|
157 | |
---|
158 | \item \cmd\affiliation\ commmands apply to all previous authors that |
---|
159 | don't have an affiliation already declared. Furthermore, for any |
---|
160 | particular author, the \cmd\affilation\ must follow any \cmd{\email}, |
---|
161 | \cmd{\homepage}, \cmd{\altaffiliation}, or \cmd{\thanks} commands for |
---|
162 | that author. |
---|
163 | |
---|
164 | \item Footnote-style associations of authors with affilitations should |
---|
165 | not be done via explicit superscripts; rather, the class option |
---|
166 | \classoption{superscriptaddress} should be used to accomplish this |
---|
167 | automatically. |
---|
168 | |
---|
169 | \item A collaboration for a group of authors can be given using the |
---|
170 | \cmd\collaboration\ command. |
---|
171 | |
---|
172 | \end{itemize} |
---|
173 | |
---|
174 | Table~\ref{tab:front} summarizes some common pitfalls in moving from |
---|
175 | \revtex~3 to \revtex~4. |
---|
176 | \begin{table*} |
---|
177 | \begin{ruledtabular} |
---|
178 | \begin{tabular}{lll} |
---|
179 | \textbf{\revtex~3 Markup} & \textbf{\revtex~4 Markup} & \textbf{Explanation}\\ |
---|
180 | & & \\ |
---|
181 | \verb+\author{Author One and Author Two}+ & \verb+\author{Author One}+ & One name per\\ |
---|
182 | & \verb+\author{Author Two}+ & \verb+\author+ \\ |
---|
183 | & & \\ |
---|
184 | \verb+\author{Author One$^{1}$}+ & \verb+\author{Author One}+& Use \classoption{superscriptaddress}\\ |
---|
185 | \dots &\dots & class option \\ |
---|
186 | \verb+\address{$^{1}$APS}+ &\verb+\affiliation{APS}+ & \\ |
---|
187 | & & \\ |
---|
188 | \verb+\thanks{Permanent address...}+ & \verb+\altaffiliation{}+& Use most |
---|
189 | specific macro \\ |
---|
190 | \verb+\thanks{Electronic address: user@domain.edu}+ & |
---|
191 | \verb+\email{user@domain.edu}+& available\\ |
---|
192 | \verb+\thanks{http://publish.aps.org/}+ & |
---|
193 | \verb+\homepage{http://publish.aps.org/}+& \\ |
---|
194 | \end{tabular} |
---|
195 | \end{ruledtabular} |
---|
196 | \caption{Common mistakes in marking up the front matter} |
---|
197 | \label{tab:front} |
---|
198 | \end{table*} |
---|
199 | |
---|
200 | |
---|
201 | \subsection{Abstracts} |
---|
202 | \revtex~4, like \revtex~3, uses the \env{abstract} environment |
---|
203 | \envb{abstract} \dots \enve{abstract} for the abstract. The |
---|
204 | \env{abstract} environment must appear before the \cmd{\maketitle} |
---|
205 | command in \revtex~4. The abstract will be formatted |
---|
206 | appropriately for either one-column (preprint) or two-column |
---|
207 | formatting. In particular, in the two-column case, the abstract will |
---|
208 | automatically be placed in a single column that spans the width of the |
---|
209 | page. It is unnecessary to use a \cmd{\minipage} or any other macro to |
---|
210 | achieve this result. |
---|
211 | |
---|
212 | |
---|
213 | \section{Citations and References} |
---|
214 | |
---|
215 | \revtex~4 uses the same \cmd{\cite},\cmd{\ref}, and \cmd{\bibitem} |
---|
216 | commmands as standard \LaTeX\ and \revtex~3. Citation handling is |
---|
217 | based upon Patick Daly's \classname{natbib} package. The |
---|
218 | \env{references} environment is no longer used. Instead, use the |
---|
219 | standard \LaTeXe\ environment \env{thebibliography}. |
---|
220 | |
---|
221 | Two new \BibTeX\ files have been included with \revtex~4, |
---|
222 | \file{apsrev.bst} and \file{apsrmp.bst}. These will format references |
---|
223 | in the style of \textit{Physical Review} and \textit{Reviews of Modern |
---|
224 | Physics} respectively. In addition, these \BibTeX\ styles |
---|
225 | automatically apply a special macro \cmd{\bibinfo} to each element of the |
---|
226 | bibliography to make it easier to extract information for use in the |
---|
227 | editorial and production processes. Authors are strongly urged to use |
---|
228 | \BibTeX\ to manage their bibliographies so that the \cmd{\bibinfo} |
---|
229 | directives will be automatically included. Other bibliography styles |
---|
230 | can be specified by using the \cmd\bibliographystyle\ command, but |
---|
231 | unlike standard \LaTeXe, you must give this command \emph{before} the |
---|
232 | \envb{document} statement. |
---|
233 | |
---|
234 | Please note that the package \classname{cite.sty} is not needed with |
---|
235 | \revtex~4 and is incompatible. |
---|
236 | |
---|
237 | \section{Footnotes and Tablenotes} |
---|
238 | \label{sec:foot} |
---|
239 | |
---|
240 | \revtex~4 uses the standard \cmd{\footnote} macro for |
---|
241 | footnotes. Footnotes can either appear on the bottom of the page on |
---|
242 | which they occur or they can appear as entries at the end of the |
---|
243 | bibliography. As with author notes, the journal style option controls |
---|
244 | the placement; however, this can be overridden with the class options |
---|
245 | \classoption{footinbib} and \classoption{nofootinbib}. |
---|
246 | |
---|
247 | Within a table, the \cmd{\footnote} command behaves differently. Footnotes |
---|
248 | appear at the bottom of the table. \cmd{\footnotemark} and |
---|
249 | \cmd{\footnotetext} are also available within the table environment so |
---|
250 | that multiple table entries can share the same footnote text. There |
---|
251 | is no longer a need to use a \cmd{\tablenote}, \cmd{\tablenotemark}, |
---|
252 | and \cmd{\tablenotetext} macros. |
---|
253 | |
---|
254 | \section{Section Commands} |
---|
255 | |
---|
256 | The title in a \cmd\section\marg{title} command will be automatically |
---|
257 | uppercased in \revtex~4. To prevent a particular letter from being |
---|
258 | uppercased, enclose it in curly braces. |
---|
259 | |
---|
260 | \section{Figures} |
---|
261 | |
---|
262 | Figures should be enclosed within either a \env{figure} or \env{figure*} |
---|
263 | environment (the latter will cause the figure to span the full width |
---|
264 | of the page in two-column mode). \LaTeXe\ has two convenient packages |
---|
265 | for including the figure file itself: \classname{graphics} and |
---|
266 | \classname{graphicx}. These two packages both define a macro |
---|
267 | \cmd{\includegraphics} which calls in the figure. They differ in how |
---|
268 | arguments for rotation, translation, and scaling are specified. The |
---|
269 | package \classname{epsfig} has been re-implemented to use these |
---|
270 | \classname{graphicx} package. The package \classname{epsfig} provides |
---|
271 | an interface similar to that under the \revtex~3 \classoption{epsf} |
---|
272 | class option. Authors should use these standard |
---|
273 | \LaTeXe\ packages rather than some other alternative. |
---|
274 | |
---|
275 | \section{Tables} |
---|
276 | |
---|
277 | Short tables should be enclosed within either a \env{table} or \env{table*} |
---|
278 | environmnent (the latter will cause the table to span the full width |
---|
279 | of the page in two-column mode). The heart of the table is the |
---|
280 | \env{tabular} environment. This will behave for the most part as in |
---|
281 | standard \LaTeXe. Note that \revtex~4 no longer automatically adds |
---|
282 | double (Scotch) rules around tables. Nor does the \env{tabular} |
---|
283 | environment set various table parameters as before. Instead, a new |
---|
284 | environment \env{ruledtabular} provides this functionality. This |
---|
285 | environment should surround the \env{tabular} environment: |
---|
286 | \begin{verbatim} |
---|
287 | \begin{table} |
---|
288 | \caption{...} |
---|
289 | \label{tab:...} |
---|
290 | \begin{ruledtabular} |
---|
291 | \begin{tabular} |
---|
292 | ... |
---|
293 | \end{tabular} |
---|
294 | \end{ruledtabular} |
---|
295 | \end{table} |
---|
296 | \end{verbatim} |
---|
297 | |
---|
298 | Under \revtex~3, tables automatically break across pages. \revtex~4 |
---|
299 | provides some of this functionality. However, this requires adding the |
---|
300 | table a float placement option of [H] (meaning put the table |
---|
301 | ``here'') to the \envb{table} command. |
---|
302 | |
---|
303 | Long tables are more robustly handled by using the |
---|
304 | \classname{longtable.sty} package included with the standard \LaTeXe\ |
---|
305 | distribution (put \verb+\usepackage{longtable}+ in the preamble). This |
---|
306 | package gives precise control over the layout of the table. \revtex~4 |
---|
307 | goes out of its way to provide patches so that the \env{longtable} |
---|
308 | environment will work within a two-column format. A new |
---|
309 | \env{longtable*} environment is also provided for long tables that are |
---|
310 | too wide for a narrow column. (Note that the \env{table*} and |
---|
311 | \env{longtable*} environments should always be used rather than |
---|
312 | attempting to use the \env{widetext} environment.) |
---|
313 | |
---|
314 | To create tables with columns of numbers aligned on decimal points, |
---|
315 | load the standard \LaTeXe\ \classname{dcolumn} package and use the |
---|
316 | \verb+d+ column specifier. The content of each cell in the column is |
---|
317 | implicitly in math mode: Use of math delimiters (\verb+$+) is unnecessary |
---|
318 | in a \verb+d+ column. |
---|
319 | |
---|
320 | Footnotes within a table can be specified with the |
---|
321 | \cmd{\footnote} command (see Sec.~\ref{sec:foot}). |
---|
322 | |
---|
323 | \section{Font selection} |
---|
324 | |
---|
325 | The largest difference between \revtex~3 and \revtex~4 with respect to |
---|
326 | fonts is that \revtex~4 allows one use the \LaTeXe\ font commands such |
---|
327 | as \cmd{\textit}, \cmd{\texttt}, \cmd{\textbf} etc. These commands |
---|
328 | should be used in place of the basic \TeX/\LaTeX\ 2.09 font commands |
---|
329 | such as \cmd{\it}, \cmd{\tt}, \cmd{\bf}, etc. The new font commands |
---|
330 | better handle subtleties such as italic correction and scaling in |
---|
331 | super- and subscripts. |
---|
332 | |
---|
333 | \section{Math and Symbols} |
---|
334 | |
---|
335 | \revtex~4 depends more heavily on packages from the standard \LaTeXe\ |
---|
336 | distribution and AMS-\LaTeX\ than \revtex~3 did. Thus, \revtex~4 users |
---|
337 | should make sure their \LaTeXe\ distributions are up to date and they |
---|
338 | should install AMS-\LaTeX\ 2.0 as well. In general, if any fine control of |
---|
339 | equation layout, special math symbols, or other specialized math |
---|
340 | constructs are needed, users should look to the \classname{amsmath} |
---|
341 | package (see the AMS-\LaTeX\ documentation). |
---|
342 | |
---|
343 | \revtex~4 provides a small number of additional diacritics, symbols, |
---|
344 | and bold parentheses. Table~\ref{tab:revsymb} summarizes this. |
---|
345 | |
---|
346 | \begin{table} |
---|
347 | \caption{Special \revtex~4 symbols, accents, and boldfaced parentheses |
---|
348 | defined in \file{revsymb.sty}} |
---|
349 | \label{tab:revsymb} |
---|
350 | \begin{ruledtabular} |
---|
351 | \begin{tabular}{ll|ll} |
---|
352 | \cmd\lambdabar & $\lambdabar$ &\cmd\openone & $\openone$\\ |
---|
353 | \cmd\altsuccsim & $\altsuccsim$ & \cmd\altprecsim & $\altprecsim$ \\ |
---|
354 | \cmd\alt & $\alt$ & \cmd\agt & $\agt$ \\ |
---|
355 | \cmd\tensor\ x & $\tensor x$ & \cmd\overstar\ x & $\overstar x$ \\ |
---|
356 | \cmd\loarrow\ x & $\loarrow x$ & \cmd\roarrow\ x & $\roarrow x$ \\ |
---|
357 | \cmd\biglb\ ( \cmd\bigrb ) & $\biglb( \bigrb)$ & |
---|
358 | \cmd\Biglb\ ( \cmd\Bigrb )& $\Biglb( \Bigrb)$ \\ |
---|
359 | & & \\ |
---|
360 | \cmd\bigglb\ ( \cmd\biggrb ) & $\bigglb( \biggrb)$ & |
---|
361 | \cmd\Bigglb\ ( \cmd\Biggrb\ ) & $\Bigglb( \Biggrb)$ \\ |
---|
362 | \end{tabular} |
---|
363 | \end{ruledtabular} |
---|
364 | \end{table} |
---|
365 | |
---|
366 | Here is a partial list of the more notable changes between \revtex~3 |
---|
367 | and \revtex~4 math: |
---|
368 | \begin{itemize} |
---|
369 | \item Bold math characters should now be handle via the standard |
---|
370 | \LaTeXe\ \classname{bm} package (use \cmd{\bm} instead of \cmd{\bbox}). |
---|
371 | \cmd{\bm} will handle Greek letters and other symbols. |
---|
372 | |
---|
373 | \item Use the class options \classoption{amsmath}, |
---|
374 | \classoption{amsfonts} and \classoption{amssymb} to get even more math |
---|
375 | fonts and symbols. \cmd{\mathfrak} and \cmd{\mathbb} will, for instance, give |
---|
376 | Fraktur and Blackboard Bold symbols. |
---|
377 | |
---|
378 | \item Use the \classoption{fleqn} class option for making equation |
---|
379 | flush left or right. \cmd{\FL} and \cmd{\FR} are no longer provided. |
---|
380 | |
---|
381 | \item In place of \cmd{\eqnum}, load the \classname{amsmath} package |
---|
382 | [\verb+\usepackage{amsmath}+] and use \cmd{\tag}. |
---|
383 | |
---|
384 | \item In place of \cmd{\case}, use \cmd{\textstyle}\cmd{\frac}. |
---|
385 | |
---|
386 | \item In place of the \env{mathletters} environment, load the |
---|
387 | \classname{amsmath} package and use \env{subequations} environment. |
---|
388 | |
---|
389 | \item In place of \cmd{\slantfrac}, use \cmd{\frac}. |
---|
390 | |
---|
391 | \item The macros \cmd{\corresponds}, \cmd{\overdots}, and |
---|
392 | \cmd{\overcirc} have been removed. See Table~\ref{tab:obsolete}. |
---|
393 | |
---|
394 | \end{itemize} |
---|
395 | |
---|
396 | \section{Obsolete \revtex~3.1 commands} |
---|
397 | |
---|
398 | Table~\ref{tab:obsolete} summarizes more differences between \revtex~4 |
---|
399 | and \revtex~3, particularly which \revtex~3 commands are now obsolete. |
---|
400 | |
---|
401 | \begin{table*} |
---|
402 | \caption{Differences between \revtex~3.1 and \revtex~4 |
---|
403 | markup}\label{tab:diff31} |
---|
404 | \label{tab:obsolete} |
---|
405 | \begin{ruledtabular} |
---|
406 | \begin{tabular}{lp{330pt}} |
---|
407 | \textbf{\revtex~3.1 command}&\textbf{\revtex~4 replacement} |
---|
408 | \lrstrut\\ |
---|
409 | \cmd\documentstyle\oarg{options}\aarg{\classname{revtex}}&\cmd\documentclass\oarg{options}\aarg{\classname{revtex4}} |
---|
410 | \\ |
---|
411 | option \classoption{manuscript}& \classoption{preprint} |
---|
412 | \\ |
---|
413 | \cmd\tighten\ preamble command & \classoption{tightenlines} class option |
---|
414 | \\ |
---|
415 | \cmd\draft\ preamble command & \classoption{draft} class option |
---|
416 | \\ |
---|
417 | \cmd\author & \cmd\author\marg{name} may appear |
---|
418 | multiple times; each signifies a new author name.\\ |
---|
419 | & \cmd\collaboration\marg{name}: |
---|
420 | Collaboration name (should appear after last \cmd\author)\\ |
---|
421 | & \cmd\homepage\marg{URL}: URL for preceding author\\ |
---|
422 | & \cmd\email\marg{email}: email |
---|
423 | address for preceding author\\ |
---|
424 | & \cmd{\altaffiliation}: alternate |
---|
425 | affiliation for preceding \cmd\author\\ |
---|
426 | \cmd\thanks & \cmd\thanks, but use only for |
---|
427 | information not covered by \cmd{\email}, \cmd{\homepage}, or \cmd{\altaffilitiation}\\ |
---|
428 | \cmd\and & obsolete, remove this command\\ |
---|
429 | \cmd\address & \cmd\affiliation\marg{institution}\ gives the affiliation for the group of authors above\\ |
---|
430 | & \cmd\affiliation\oarg{note} lets you specify a footnote to this institution\\ |
---|
431 | & \cmd\noaffiliation\ signifies that the above authors have no affiliation\\ |
---|
432 | |
---|
433 | \cmd\preprint & \cmd\preprint\marg{number} can appear multiple times, and must precede \cmd\maketitle\\ |
---|
434 | \cmd\pacs & \cmd\pacs\ must precede \cmd\maketitle\\ |
---|
435 | \env{abstract} environment & \env{abstract} environment must precede \cmd\maketitle\\ |
---|
436 | \cmd\wideabs & obsolete, remove this command\\ |
---|
437 | \cmd\maketitle & \cmd\maketitle\ must follow |
---|
438 | \emph{all} front matter data commands\\ |
---|
439 | \cmd\narrowtext & obsolete, remove this command\\ |
---|
440 | \cmd\mediumtext & obsolete, remove this command\\ |
---|
441 | \cmd\widetext & obsolete, replace with \env{widetext} environment\\ |
---|
442 | \cmd\FL & obsolete, remove this command\\ |
---|
443 | \cmd\FR & obsolete, remove this command\\ |
---|
444 | \cmd\eqnum & replace with \cmd\tag, load \classname{amsmath}\\ |
---|
445 | \env{mathletters} & replace with \env{subequations}, load |
---|
446 | \classname{amsmath}\\ |
---|
447 | \env{tabular} environment & No longer puts in doubled-rules. Enclose \env{tabular} in \env{ruledtabular} to get old behavior.\\ |
---|
448 | \env{quasitable} environment & obsolete, \env{tabular} environment no longer |
---|
449 | puts in rules\\ |
---|
450 | \env{references} environment & replace with \env{thebibliography}\verb+{}+\\ |
---|
451 | \cmd\case & replace with \cmd\textstyle\cmd\frac\\ |
---|
452 | \cmd\slantfrac & replace with \cmd\frac\\ |
---|
453 | \cmd\tablenote & replace with \cmd\footnote\\ |
---|
454 | \cmd\tablenotemark & replace with \cmd\footnotemark\\ |
---|
455 | \cmd\tablenotetext & replace with \cmd\footnotetext\lrstrut\\ |
---|
456 | \cmd\overcirc & Use standard \LaTeXe\ \cmd\mathring\ \\ |
---|
457 | \cmd\overdots & Use \cmd\dddot\ with \classoption{amsmath}\\ |
---|
458 | \cmd\corresponds & Use \cmd\triangleq\ with \classoption{amssymb}\\ |
---|
459 | \classoption{epsf} class option & \verb+\usepackage{epsfig}+\\ |
---|
460 | \end{tabular} |
---|
461 | \end{ruledtabular} |
---|
462 | \end{table*} |
---|
463 | |
---|
464 | |
---|
465 | \section{Converting a \revtex~3.1 Document to \revtex~4}\label{sec:conv31}% |
---|
466 | |
---|
467 | \revtex~3 documents can be converted to \revtex~4 rather |
---|
468 | straightforwardly. The following checklist covers most of the major |
---|
469 | steps involved. |
---|
470 | |
---|
471 | \begin{itemize} |
---|
472 | \item Change \cmd\documentstyle\verb+{revtex}+ to |
---|
473 | \cmd\documentclass\verb+{revtex4}+, and run the document under |
---|
474 | \LaTeXe\ instead of \LaTeX2.09. |
---|
475 | |
---|
476 | \item |
---|
477 | Replace the \cmd\draft\ command with the \classoption{draft} class option. |
---|
478 | |
---|
479 | \item |
---|
480 | Replace the \cmd\tighten\ command with the \classoption{tightenlines} |
---|
481 | class option. |
---|
482 | |
---|
483 | \item |
---|
484 | For each \cmd\author\ command, split the multiple authors into |
---|
485 | individual \cmd\author\ commands. Remove any instances of \cmd\and. |
---|
486 | |
---|
487 | \item For superscript-style associations between authors and |
---|
488 | affiliations, remove explicit superscripts and use the |
---|
489 | \classoption{superscriptaddress} class option. |
---|
490 | |
---|
491 | \item |
---|
492 | Use \cmd\affiliation\ instead of \cmd\address. |
---|
493 | |
---|
494 | \item |
---|
495 | Put \cmd\maketitle\ after the \env{abstract} environment and any |
---|
496 | \cmd\pacs\ commands. |
---|
497 | |
---|
498 | \item If double-ruled table borders are desired, enclose \env{tabular} |
---|
499 | enviroments in \env{ruledtabular} environments. |
---|
500 | |
---|
501 | \item |
---|
502 | Convert long tables to \env{longtable}, and load the |
---|
503 | \classname{longtable} package. Alternatively, give the \env{table} |
---|
504 | an [H] float placement parameter so that the table will break automatically. |
---|
505 | |
---|
506 | \item |
---|
507 | Replace any instances of the \cmd\widetext\ and \cmd\narrowtext\ |
---|
508 | commands with the \env{widetext} environment. |
---|
509 | Usually, the \envb{widetext} statement will replace the \cmd\widetext\ |
---|
510 | command, and the \enve{widetext} statement replaces the matching |
---|
511 | \cmd\narrowtext\ command. |
---|
512 | |
---|
513 | Note in this connection that due to a curious feature of \LaTeX\ |
---|
514 | itself, \revtex~4 having a \env{widetext} environment means that it |
---|
515 | also has a definition for the \cmd\widetext\ command, even though the |
---|
516 | latter cammand is not intended to be used in your document. |
---|
517 | Therefore, it is particularly important to remove |
---|
518 | all \cmd\widetext\ commands when converting to \revtex~4. |
---|
519 | |
---|
520 | \item |
---|
521 | Remove all obsolete commands: \cmd\FL, \cmd\FR, \cmd\narrowtext, and |
---|
522 | \cmd\mediumtext\ (see Table~\ref{tab:diff31}). |
---|
523 | |
---|
524 | \item |
---|
525 | Replace \cmd\case\ with \cmd\frac. If a fraction needs to be set |
---|
526 | in text style despite being in a display equation, use the |
---|
527 | construction \cmd\textstyle\cmd\frac. Note that \cmd\frac\ does not |
---|
528 | support the syntax \cmd\case\verb+1/2+. |
---|
529 | |
---|
530 | \item |
---|
531 | Replace \cmd\slantfrac\ with \cmd\frac. |
---|
532 | |
---|
533 | \item |
---|
534 | Change \cmd\frak\ to \cmd\mathfrak\marg{char}\index{Fraktur} and |
---|
535 | \cmd\Bbb\ to \cmd\mathbb\marg{char}\index{Blackboard Bold}, and invoke |
---|
536 | one of the class options \classoption{amsfonts} or |
---|
537 | \classoption{amssymb}. |
---|
538 | |
---|
539 | \item |
---|
540 | Replace environment \env{mathletters} with environment |
---|
541 | \env{subequations} and load the \classname{amsmath} package. |
---|
542 | |
---|
543 | \item |
---|
544 | Replace \cmd\eqnum\ with \cmd\tag\ and load the \classname{amsmath} package. |
---|
545 | |
---|
546 | \item |
---|
547 | Replace \cmd\bbox\ with \cmd\bm\ and load the \classname{bm} package. |
---|
548 | |
---|
549 | \item |
---|
550 | If using the \cmd\text\ command, load the \classname{amsmath} package. |
---|
551 | |
---|
552 | \item |
---|
553 | If using the \verb+d+ column specifier in \env{tabular} environments, |
---|
554 | load the \classname{dcolumn} package. Under \classname{dcolumn}, the |
---|
555 | content of each \verb+d+ column cell is implicitly in math mode: |
---|
556 | remove any \verb+$+ math delimiters appearing in cells in a \verb+d+ |
---|
557 | column. |
---|
558 | |
---|
559 | \item |
---|
560 | Replace \cmd\tablenote\ with \cmd\footnote, \cmd\tablenotemark\ with |
---|
561 | \cmd\footnotemark, and \cmd\tablenotetext\ with \cmd\footnotetext. |
---|
562 | |
---|
563 | \item |
---|
564 | Replace \envb{references} with \envb{thebibliography}\verb+{}+; |
---|
565 | \enve{references} with \enve{thebibliography}. |
---|
566 | \end{itemize} |
---|
567 | \end{document} |
---|