source: Backup NB/Talks/MEMPHYSetal/LAGUNA/EU I3/PhysicsLatex/revtex4/revtex4/docs/auguide.tex @ 416

%% ****** Start of file authguide.tex ****** %
%%
%%   This file is part of the APS files in the REVTeX 4 distribution.
%%   Version 4.0 of REVTeX, August, 2001
%%
%%   Copyright (c) 2000,2001 The American Physical Society.
%%
%%   See the REVTeX 4 README file for restrictions and more information.
%%
\listfiles
\documentclass[%
%prl%
%,preprint%
 ,twocolumn%
 ,secnumarabic%
%,tightenlines%
,amssymb, amsmath,nobibnotes, aps, prl]{revtex4}
%\usepackage{acrofont}%NOTE: Comment out this line for the release version!
\usepackage{docs}%
\usepackage{bm}%
%\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

\begin{document}

\title{\revtex~4 Author's Guide}%

\author{American Physical Society}%
\email{revtex@aps.org}
\affiliation{1 Research Road, Ridge, NY 11961}
\date{August 2001}%
\maketitle
\tableofcontents

\section{Introduction}

This is the author's guide to \revtex~4, the preferred submission
format for all APS journals. This guide is intended to be a concise
introduction to \revtex~4. The documentation has been separated out
into smaller units to make it easier to locate essential
information.

The following documentation is also part of the APS \revtex~4
distribution. Updated versions of these will be maintained at
the \revtex~4 homepage located at \url{http://publish.aps.org/revtex4/}.
\begin{itemize}
\item \textit{APS Compuscript Guide for \revtex~4}
\item \textit{\revtex~4 Command and Options Summary}
\item \textit{\revtex~4 Bib\TeX\ Guide}
\item \textit{Differences between \revtex~4 and \revtex~3}
\end{itemize}
This guide assumes a working \revtex~4
installation. Please see the installation guide included with the
distribution.

The \revtex\ system for \LaTeX\ began its development in 1986 and has
gone through three major revisions since then.  All versions prior to
\revtex~4 were based on \LaTeX2.09 and, until now, \revtex\ did not
keep pace with the advances of the \LaTeX\ community and thus became
inconvenient to work with. \revtex~4 is designed to remedy this by
incorporating the following design goals:

\begin{itemize}
\item
Make \revtex\ fully compatible with \LaTeXe; it is now a \LaTeXe\
document class, similar in function to the standard
\classname{article} class.

\item
Rely on standard \LaTeXe\ packages for common tasks, e.g,
\classname{graphicx},
\classname{color}, and
\classname{hyperref}.

\item
Add or improve macros to support translation to tagged formats such as
XML and SGML. This added markup will be key to enhancing the
peer-review process and lowering production costs.

\item
Provide a closer approximation to the typesetting style used in
\emph{Physical Review}.

\item
Incorporate new features, such as hypertext, to make \revtex\ a
convenient and desirable e-print format.

\item
Relax the restrictions in \revtex\ that had only been necessary for
typesetting journal camera-ready copy.
\end{itemize}

To meet these goals, \revtex~4 is a complete rewrite with an emphasis
on maintainability so that it will be easier to provide enhancements.

The \revtex~4 distribution includes both a template
(\file{template.aps}) and a sample document (\file{apssamp.tex}).
The template is a good starting point for a manuscript. In the
following sections are instructions that should be sufficient for
creating a paper using \revtex~4.

\subsection{Submitting to APS Journals}

Authors using \revtex~4 to prepare a manuscript for submission to
\textit{Physical Review} or \textit{Reviews of Modern Physics} 
must also read the companion document \textit{APS Compuscript Guide
for \revtex~4}
distributed with \revtex\ and follow the guidelines detailed there.

Further information about the compuscript program of the American
Physical Society may be found at \url{http://publish.aps.org/ESUB/}.

\subsection{Contact Information}\label{sec:resources}%
Any bugs, problems, or inconsistencies should reported to
\revtex\ support at \verb+revtex@aps.org+.
Reports should include information on the error and a \textit{small}
sample document that manifests the problem if possible (please don't
send large files!).

\section{Some \LaTeXe\ Basics}
A primary design goal of \revtex~4 was to make it as compatible with
standard \LaTeXe\ as possible so that authors may take advantage of all
that \LaTeXe\ offers. In keeping with this goal, much of the special
formatting that was built in to earlier versions of \revtex\ is now
accomplished through standard \LaTeXe\ macros or packages. The books
in the bibliography provide extensive coverage of all topics
pertaining to preparing documents under \LaTeXe. They are highly recommended.

To accomplish its goals, \revtex~4 must sometimes patch the underlying
\LaTeX\ kernel. This means that \revtex~4 requires a fairly recent version of
\LaTeXe. Versions prior to 1996/12/01 may not work
correctly. \revtex~4 will be maintained to be compatible with future
versions of \LaTeXe.

\subsection{Useful \LaTeXe\ Markup}
\LaTeXe\ markup is the preferred way to accomplish many basic tasks.

\subsubsection{Fonts}

Because \revtex~4 is based upon \LaTeXe, it inherits all of the
macros used for controlling fonts. Of particular importance are the
\LaTeXe\ macros \cmd{\textit}, \cmd{\textbf}, \cmd{\texttt} for changing to
an italic, bold, or typewriter font respectively. One should always
use these macros rather than the lower-level \TeX\ macros \cmd{\it},
\cmd{\bf}, and \cmd{\tt}. The \LaTeXe\ macros offer
improvements such as better italic correction and scaling in super-
and subscripts for example. Table~\ref{tab:fonts}
summarizes the font selection commands in \LaTeXe.

\begin{table}
\caption{\label{tab:fonts}\LaTeXe\ font commands}
\begin{ruledtabular}
\begin{tabular}{ll}
\multicolumn{2}{c}{\textbf{Text Fonts}}\\
\textbf{Font command} & \textbf{Explanation} \\
\cmd\textit\marg{text}  & Italics\\
\cmd\textbf\marg{text}  & Boldface\\
\cmd\texttt\marg{text}  & Typewriter\\
\cmd\textrm\marg{text}  & Roman\\
\cmd\textsl\marg{text}  & Slanted\\
\cmd\textsf\marg{text}  & Sans Serif\\
\cmd\textsc\marg{text}  & Small Caps\\
\cmd\textmd\marg{text}  & Medium Series\\
\cmd\textnormal\marg{text} & Normal Series\\
\cmd\textup\marg{text}  & Upright Series\\
  &\\
\multicolumn{2}{c}{\textbf{Math Fonts}}\\
\cmd\mathit\marg{text}  & Math Italics\\
\cmd\mathbf\marg{text}  & Math Boldface\\
\cmd\mathtt\marg{text}  & Math Typewriter\\
\cmd\mathsf\marg{text}  & Math Sans Serif\\
\cmd\mathcal\marg{text}  & Calligraphic\\
\cmd\mathnormal\marg{text} & Math Normal\\
\cmd\bm\marg{text}& Bold math for Greek letters\\
                  & and other symbols\\
\cmd\mathfrak\marg{text}\footnotemark[1]  & Fraktur\\
\cmd\mathbb\marg{text}\footnotemark[1] & Blackboard Bold\\
\end{tabular}
\end{ruledtabular}
\footnotetext[1]{Requires \classname{amsfonts} or \classname{amssymb} class option}
\end{table}

\subsubsection{User-defined macros}
\LaTeXe\ provides several macros that enable users to easily create new
macros for use in their manuscripts:
\begin{itemize}
\footnotesize
\item \cmd\newcommand\marg{\\command}\oarg{narg}\oarg{opt}\marg{def} 
\item \cmd\newcommand\verb+*+\marg{\\command}\oarg{narg}\oarg{opt}\marg{def}
\item \cmd\renewcommand\marg{\\command}\oarg{narg}\oarg{opt}\marg{def}
\item \cmd\renewcommand\verb+*+\marg{\\command}\oarg{narg}\oarg{opt}\marg{def}
\item \cmd\providecommand\marg{\\command}\oarg{narg}\oarg{opt}\marg{def}
\item \cmd\providecommand\verb+*+\marg{\\command}\oarg{narg}\oarg{opt}\marg{def}
\end{itemize}
Here \meta{\\command} is the name of the macro being defined,
\meta{narg} is the number of arguments the macro takes,
\meta{opt} are optional default values for the arguments, and
\meta{def} is the actually macro definiton. \cmd\newcommand\ creates a
new macro, \cmd\renewcommand\ redefines a previously defined macro,
and \cmd\providecommand\ will define a macro only if it hasn't
been defined previously. The *-ed versions are an optimization that
indicates that the macro arguments will always be ``short'' arguments. This is
almost always the case, so the *-ed versions should be used whenver
possible.

The use of these macros is preferred over using plain \TeX's low-level
macros such as
\cmd\def{},\cmd\edef{}, and \cmd\gdef{}. APS authors must follow the
\textit{APS Compuscript Guide for \revtex~4} when defining macros.

\subsubsection{Symbols}

\LaTeXe\ has added some convenient commands for some special symbols
and effects. These are summarized in Table~\ref{tab:special}. See
\cite{Guide} for details.

\begin{table}
\caption{\label{tab:special}\LaTeXe\ commands for special symbols and effects}
\begin{ruledtabular}
\begin{tabular}{lc}
Command & Symbol/Effect\\
\cmd\textemdash & \textemdash\\
\cmd\textendash & \textendash\\
\cmd\textexclamdown & \textexclamdown\\
\cmd\textquestiondown & \textquestiondown\\
\cmd\textquotedblleft & \textquotedblleft\\
\cmd\textquotedblright & \textquotedblright\\
\cmd\textquoteleft & \textquoteleft\\
\cmd\textquoteright & \textquoteright\\
\cmd\textbullet   & \textbullet\\
\cmd\textperiodcentered & \textperiodcentered\\
\cmd\textvisiblespace & \textvisiblespace\\
\cmd\textcompworkmark & Break a ligature\\
\cmd\textcircled\marg{char} & Circle a character\\
\end{tabular}
\end{ruledtabular}
\end{table}

\LaTeXe\ also removed some symbols that were previously automatically
available in \LaTeX 2.09. These symbols are now contained in a
separate package \classname{latexsym}. To use these symbols, include
the package using:
\begin{verbatim}
\usepackage{latexsym}
\end{verbatim}

\subsection{Using \LaTeXe\ packages with \revtex}\label{sec:usepackage}%

Many \LaTeXe\ packages are available, for instance, on CTAN at
\url{ftp://ctan.tug.org/tex-archive/macros/latex/required/}
and at
\url{ftp://ctan.tug.org/tex-archive/macros/latex/contrib/}
or may be available on other distribution media, such as the \TeX\
Live CD-ROM \url{http://www.tug.org/texlive/}.  Some of these packages
are automatically loaded by \revtex~4 when certain class options are
invoked and are, thus, ``required''.  They will either be distributed
with \revtex\ or are already included with a standard \LaTeXe\
distribution.

Required packages are automatically loaded by \revtex\ on an as-needed
basis.  Other packages should be loaded using the
\cmd\usepackage\ command. To load the
\classname{hyperref} package, the document preamble might look like:
\begin{verbatim}
\documentclass{revtex}
\usepackage{hyperref}
\end{verbatim}

Some common (and very useful) \LaTeXe\ packages are \textit{a priori}
important enough that \revtex~4 has been designed to be specifically
compatible with them. 
A bug stemming from the use of one of these packages in
conjunction with any of the APS journals may be reported by contacting
\revtex\ support.
\begin{description}
\item[\textbf{AMS packages}] \revtex~4 is compatible with and depends
 upon the AMS packages
\classname{amsfonts},
\classname{amssymb}, and
\classname{amsmath}. In fact, \revtex~4 requires use of these packages
to accomplish some common tasks. See Section~\ref{sec:math} for more.
\revtex~4 requires version 2.0 or higher of the AMS-\LaTeX\ package.

\item[\textbf{array and dcolumn}]
The \classname{array} and \classname{dcolumn} packages are part of
\LaTeX's required suite of packages. \classname{dcolumn} is required
to align table columns on decimal points (and it in turn depends upon
the \classname{array} package).

\item[\textbf{longtable}]
\file{longtable.sty} may be used for large tables that will span more than one
page. \revtex~4 dynamically applies patches to longtable.sty so that
it will work in two-column mode.

\item[\textbf{hyperref}] \file{hyperref.sty} is a package by Sebastian Rahtz that is
used for putting hypertext links into \LaTeXe\ documents.
\revtex~4 has hooks to allow e-mail addresses and URL's to become
hyperlinks if \classname{hyperref} is loaded.
\end{description}

Other packages will conflict with \revtex~4 and should be
avoided. Usually such a conflict arises because the package adds
enhancements that \revtex~4 already includes. Here are some common
packages that clash with \revtex~4:
\begin{description}
\item[\textbf{multicol}] \file{multicol.sty} is a package by Frank Mittelbach
that adds support for multiple columns. In fact, early versions of
\revtex~4 used \file{multicol.sty} for precisely this. However, to
improve the handling of floats, \revtex~4 now has its own macros for
two-column layout. Thus, it is not necessary to use \file{multicol.sty}.

\item[\textbf{cite}] Donald Arseneau's \file{cite.sty} is often used to provide
support for sorting a \cmd\cite\ command's arguments into numerical
order and to collapse consecutive runs of reference numbers. \revtex~4
has this functionality built-in already via the \classname{natbib} package.

\item[\textbf{endfloat}] The same functionality can be accomplished
using the \classoption{endfloats} class option.

\item[\textbf{float}] \revtex~4 already contains a lot of this
functionality.
\end{description}

\section{The Document Preamble}

The preamble of a \LaTeX\ document is the set of commands that precede
the \envb{document} line. It contains a
\cmd\documentclass\ line to load the \revtex~4 class (\textit{i.~e.},
all of the \revtex~4 macro definitions), \cmd\usepackage\ macros to
load other macro packages, and other macro definitions.

\subsection{The \emph{documentclass} line}
The basic formatting of the manuscript is controlled by setting
\emph{class options} using
\cmd\documentclass\oarg{options}\aarg{\classname{revtex4}}.
The macro \cmd\documentclass\ 
replaces the \cmd\documentstyle\ macro of \LaTeX2.09. The optional
arguments that appear in the square brackets control the layout of the
document. At this point, one only needs to choose a journal style
(\classoption{pra}, \classoption{prb},
\classoption{prc}, \classoption{prd},
\classoption{pre}, \classoption{prl}, \classoption{prstab},
and \classoption{rmp}) and either \classoption{preprint} or
\classoption{twocolumn}. Usually, one would want to use
\classoption{preprint} for draft papers. \classoption{twocolumn} gives
the \emph{Physical Review} look and feel. Paper size options are also
available as well. In particular, \classoption{a4paper} is available
as well as the rest of the standard \LaTeX\ paper sizes. A
full list of class options is given in the \textit{\revtex~4 Command
and Options Summary}.

\subsection{Loading other packages}
Other packages may be loaded into a \revtex~4 document by using the
standard \LaTeXe\ \cmd\usepackage\ command. For instance, to load
the \classoption{graphics} package, one would use
\verb+\usepackage{graphics}+.

\section{The Front Matter}\label{sec:front}

After choosing the basic look and feel of the document by selecting
the appropriate class options and loading in whatever other macros are
needed, one is ready to move on to creating a new manuscript. After
the preamble, be sure to put in a \envb{document} line (and put
in an \enve{document} as well). This section describes the macros
\revtex~4 provides for formatting the front matter of the
article. The behavior and usage of these macros can be quite
different from those provided in either \revtex~3 or \LaTeXe. See the
included document \textit{Differences between \revtex~4 and \revtex~3} for an
overview of these differences.

\subsection{Setting the title}

The title of the manuscript is simply specified by using the
\cmd\title\aarg{title} macro. A \verb+\\+ may be used to put a line
break in a long title.

\subsection{Specifying a date}%

The \cmd\date\marg{date} command outputs the date on the
manuscript.  Using \cmd\today\ will cause \LaTeX{} to insert the
current date whenever the file is run:
\begin{verbatim}
\date{\today}
\end{verbatim}

\subsection{Specifying authors and affiliations}

The macros  for specifying authors and their affiliations have
changed significantly for \revtex~4. They have been improved to save
labor for authors and in production. Authors and affiliations are
arranged into groupings called, appropriately enough, \emph{author
groups}. Each author group is a set of authors who share the same set
of affiliations. Author names are specified with the \cmd\author\
macro while affiliations (or addresses) are specified with the
\cmd\affiliation\ macro. Author groups are specified by sequences of
\cmd\author\ macros followed by \cmd\affiliation\ macros. An
\cmd\affiliation\ macro applies to all previously specified
\cmd\author\ macros which don't already have an affiliation supplied.

For example, if Bugs Bunny and Roger Rabbit are both at Looney Tune
Studios, while Mickey Mouse is at Disney World, the markup would be:
\begin{verbatim}
\author{Bugs Bunny}
\author{Roger Rabbit}
\affiliation{Looney Tune Studios}
\author{Mickey Mouse}
\affiliation{Disney World}
\end{verbatim}
The default is to display this as 
\begin{center}
Bugs Bunny and Roger Rabbit\\
\emph{Looney Tune Studios}\\
Mickey Mouse\\
\emph{Disney World}\\
\end{center}
This layout style for displaying authors and their affiliations is
chosen by selecting the class option
\classoption{groupedaddress}. This option is the default for all APS
journal styles, so it does not need to be specified explicitly.
The other major way of displaying this
information is to use superscripts on the authors and
affiliations. This can be accomplished by selecting the class option
\classoption{superscriptaddress}. To achieve the display
\begin{center}
Bugs Bunny,$^{1}$ Roger Rabbit,$^{1,2}$ and Mickey Mouse$^{2}$\\
\emph{$^{1}$Looney Tune Studios}\\
\emph{$^{2}$Disney World}\\
\end{center}
one would use the markup
\begin{verbatim}
\author{Bugs Bunny}
\affiliation{Looney Tune Studios}
\author{Roger Rabbit}
\affiliation{Looney Tune Studios}
\affiliation{Disney World}
\author{Mickey Mouse}
\affiliation{Disney World}
\end{verbatim}

Note that \revtex~4 takes care of any commas and \emph{and}'s that join
the author names together and font selection, as well as any
superscript numbering. Only the author names and affiliations should
be given within their respective macros.

There is a third class option, \classoption{unsortedaddress}, for
controlling author/affiliation display. The default
\classoption{groupedaddress} will actually sort authors into the
approriate author groups if one chooses to specify an affiliation for
each author. The markup:
\begin{verbatim}
\author{Bugs Bunny}
\affiliation{Looney Tune Studios}
\author{Mickey Mouse}
\affiliation{Disney World}
\author{Roger Rabbit}
\affiliation{Looney Tune Studios}
\end{verbatim}
will result in the same display as for the first case given
above even though Roger Rabbit is specified after Mickey Mouse. To
avoid Roger Rabbit being moved into the same author group as Bugs
Bunny, use the
\classoption{unsortedaddress} option instead. In general, it is safest
to list authors in the order they should appear and specify
affiliations for multiple authors rather than one at a time. This will
afford the most independence for choosing the display option. Finally,
it should be mentioned that the affiliations for the
\classoption{superscriptaddress} are presented and numbered 
in the order that they are encountered. These means that the order
will usually follow the order of the authors. An alternative ordering
can be forced by including a list of \cmd\affiliation\ commands before
the first \cmd{\author} in the desired order. Then use the exact same
text for each affilation when specifying them for each author.

If an author doesn't have an affiliation, the \cmd\noaffiliation\
macro may be used in the place of an \cmd\affiliation\ macro.


\subsubsection{Collaborations}

A collaboration name can be specified with the \cmd\collaboration\
macro. This is very similar to the \cmd\author\ macro, but it can only
be used with the class option \classoption{superscriptaddress}. The
\cmd\collaboration\ macro should appear at the end of the list of
authors. The collaboration name will be appear centered in parentheses
between the list of authors and the list of
affiliations. Because collaborations
don't normally have affiliations, one needs to follow the
\cmd\collaboration\ with \cmd\noaffiliation.

\subsubsection{Footnotes for authors, collaborations, affiliations or title}\label{sec:footau}

Often one wants to specify additional information associated with an
author, collaboration, or affiliation such an e-mail address, an
alternate affiliation, or some other anicillary information. 
\revtex~4 introduces several new macros just for this purpose. They
are:
\begin{itemize}
\item\cmd\email\oarg{optional text}\aarg{e-mail address}
\item\cmd\homepage\oarg{optional text}\aarg{URL}
\item\cmd\altaffiliation\oarg{optional text}\aarg{affiliation}
\item\cmd\thanks\aarg{miscellaneous text}
\end{itemize}
In the first three, the \emph{optional text} will be prepended before the
actual information specified in the required argument. \cmd\email\ and
\cmd\homepage\ each have a default text for their optional arguments
(`Electronic address:' and `URL:' respectively). The \cmd\thanks\
macro should only be used if one of the other three do not apply. Any
author name can have multiple occurences of these four macros. Note
that unlike the
\cmd\affiliation\ macro, these macros only apply to the \cmd\author\
that directly precedes it. Any \cmd\affiliation\ \emph{must} follow
the other author-specific macros. A typical usage might be as follows:
\begin{verbatim}
\author{Bugs Bunny}
\email[E-mail me at: ]{bugs@looney.com}
\homepage[Visit: ]{http://looney.com/}
\altaffiliation[Permanent address: ]
                     {Warner Brothers}
\affiliation{Looney Tunes}
\end{verbatim}
This would result in the footnote ``E-mail me at: \texttt{bugs@looney.com},
Visit: \texttt{http://looney.com/}, Permanent address: Warner
Brothers'' being attached to Bugs Bunny. Note that:
\begin{itemize}
\item Only an e-mail address, URL, or affiliation should go in the
required argument in the curly braces.
\item The font is automatically taken care of.
\item An explicit space is needed at the end of the optional text if one is
desired in the output.
\item Use the optional arguments to provide customized
text only if there is a good reason to.
\end{itemize}

The \cmd\collaboration\ , \cmd\affiliation\ , or even \cmd\title\ can
also have footnotes attached via these commands. If any ancillary data
(\cmd\thanks, \cmd\email, \cmd\homepage, or
\cmd\altaffiliation) are given in the wrong context (e.g., before any
\cmd\title, \cmd\author, \cmd\collaboration, or \cmd\affiliation\
command has been given), then a warning is given in the \TeX\ log, and
the command is ignored.

Duplicate sets of ancillary data are merged, giving rise to a single
shared footnote. However, this only applies if the ancillary data are
identical: even the order of the commands specifying the data must be
identical. Thus, for example, two authors can share a single footnote
indicating a group e-mail address.

Duplicate \cmd\affiliation\ commands may be given in the course of the
front matter, without the danger of producing extraneous affiliations
on the title page. However, ancillary data should be specified for
only the first instance of any particular institution's
\cmd\affiliation\ command; a later instance with different ancillary
data will result in a warning in the \TeX\ log.

It is preferable to arrange authors into
sets. Within each set all the authors share the same group of
affiliations. For each author, give the \cmd\author\ (and appropriate
ancillary data), then follow this author group with the needed group
of \cmd\affiliation\ commands.

If affiliations have been listed before the first
\cmd\author\ macro to ensure a particular ordering, be sure
that any later \cmd\affiliation\ command for the given institution is
an exact copy of the first, and also ensure that no ancillary data is
given in these later instances.


Each APS journal has a default behavior for the placement of these
ancillary information footnotes. The \classoption{prb} option puts all
such footnotes at the start of the bibliography while the other
journal styles display them on the first page. One can override a
journal style's default behavior by specifying explicitly the class
option
\classoption{bibnotes} (puts the footnotes at the start of the
bibliography) or \classoption{nobibnotes} (puts them on the first page).

\subsubsection{Specifying first names and surnames}

Many APS authors have names in which either the surname appears first
or in which the surname is made up of more than one name. To ensure
that such names are accurately captured for indexing and other
purposes, the \cmd\surname\ macro should be used to indicate which portion
of a name is the surname. Similarly, there is a \cmd\firstname\ macro
as well, although usage of \cmd\surname\ should be sufficient. If an
author's surname is a single name and written last, it is not
necessary to use these macros. These macros do nothing but indicate
how a name should be indexed. Here are some examples;
\begin{verbatim}
\author{Andrew \surname{Lloyd Weber}}
\author{\surname{Mao} Tse-Tung}
\end{verbatim}

\subsection{The abstract}
An abstract for a paper is specified by using the \env{abstract}
environment:
\begin{verbatim}
\begin{abstract}
Text of abstract
\end{abstract}
\end{verbatim}
Note that in \revtex~4 the abstract must be specified before the
\cmd\maketitle\ command and there is no need to embed it in an explicit
minipage environment.

\subsection{PACS codes}
APS authors are asked to supply suggested PACS codes with their
submissions. The \cmd\pacs\ macro is provided as a way to do this:
\begin{verbatim}
\pacs{23.23.+x, 56.65.Dy}
\end{verbatim}
The actual display of the PACS numbers below the abstract is
controlled by two class options: \classoption{showpacs} and
\classoption{noshowpacs}. In particular, this is now independent of
the \classoption{preprint} option. \classoption{showpacs} must be
explicitly included in the class options to display the PACS codes.

\subsection{Keywords}
A \cmd\keywords\ macro may also be used to indicate keywords for the
article. 
\begin{verbatim}
\keywords{nuclear form; yrast level}
\end{verbatim}
This will be displayed below the abstract and PACS (if supplied). Like
PACS codes, the actual display of the the keywords is controlled by
two classoptions: \classoption{showkeys} and
\classoption{noshowkeys}. An explicit \classoption{showkeys} must be
included in the \cmd\documentclass\ line to display the keywords.

\subsection{Institutional report numbers}
Institutional report numbers can be specified using the \cmd\preprint\
macro. These will be displayed in the upper lefthand corner of the
first page. Multiple \cmd\preprint\ macros maybe supplied (space is
limited though, so only three or less may actually fit). 

\subsection{maketitle}
After specifying the title, authors, affiliations, abstract, PACS
codes, and report numbers, the final step for formatting the front
matter of the manuscript is to execute the \cmd\maketitle\ macro by
simply including it:
\begin{verbatim}
\maketitle
\end{verbatim}
The \cmd\maketitle\ macro must follow all of the macros listed
above. The macro will format the front matter in accordance with the various
class options that were specified in the
\cmd\documentclass\ line (either implicitly through defaults or
explicitly).

\section{The body of the paper}

For typesetting the body of a paper, \revtex~4 relies heavily on
standard \LaTeXe\ and other packages (particulary those that are part
of AMS-\LaTeX). Users unfamiliar with these packages should read the
following sections carefully. 

\subsection{Section headings}

Section headings are input as in \LaTeX.
The output is similar, with a few extra features.

Four levels of headings are available in \revtex{}:
\begin{quote}
\cmd\section\marg{title text}\\
\cmd\subsection\marg{title text}\\
\cmd\subsubsection\marg{title text}\\
\cmd\paragraph\marg{title text}
\end{quote}

Use the starred form of the command to suppress the automatic numbering; e.g.,
\begin{verbatim}
\section*{Introduction}
\end{verbatim}

To label a section heading for cross referencing, best practice is to
place the \cmd\label\marg{key} within the argument specifying the heading:
\begin{verbatim}
\section{\label{sec:intro}Introduction}
\end{verbatim}

In the some journal substyles, such as those of the APS,
all text in the \cmd\section\ command is automatically set uppercase.
If a lowercase letter is needed, use \cmd\lowercase\aarg{x}.
For example, to use ``He'' for helium in a \cmd\section\marg{title text} command, type
\verb+H+\cmd\lowercase\aarg{e} in \marg{title text}.

Use \cmd\protect\verb+\\+ to force a line break in a section heading.
(Fragile commands must be protected in section headings, captions, and
footnotes and \verb+\\+ is a fragile command.)

\subsection{Paragraphs and General Text}

Paragraphs always end with a blank input line.  Because \TeX\
automatically calculates linebreaks and word hyphenation in a
paragraph, it is not necessary to force linebreaks or hyphenation.  Of
course, compound words should still be explicitly hyphenated, e.g.,
``author-prepared copy.''

Use directional quotes for quotation marks around quoted text
(\texttt{``xxx''}), not straight double quotes (\texttt{"xxx"}).
For opening quotes, use one or two backquotes; for closing quotes,
use one or two forward quotes (apostrophes).

\subsection{One-column vs. two-column}\label{sec:widetext}

One of the hallmarks of \textit{Physical Review} is its two-column
formatting and so one of the \revtex~4 design goals is to make it easier to
acheive the \textit{Physical Review} look and feel. In particular, the
\classoption{twocolumn} option will take care of formatting the front matter
(including the abstract) as a single column. \revtex~4 has its own
built-in two-column formatting macros to provide well-balanced columns
as well as reasonable control over the placement of floats in either
one- or two-column modes.

Occasionally it is necessary to change the formatting from two-column to
one-column to better accomodate very long equations that are more
easily read when typeset to the full width of the page. This is
accomplished using the \env{widetext} environment:
\begin{verbatim}
\begin{widetext}
long equation goes here
\end{widetext}
\end{verbatim}
In two-column mode, this will temporarily return to one-column mode,
balancing the text before the environment into two short columns, and
returning to two-column mode after the environment has
finished. \revtex~4 will also add horizontal rules to guide the
reader's eye through what may otherwise be a confusing break in the
flow of text. The
\env{widetext} environment has no effect on the output under the 
\classoption{preprint} class option because this already uses
one-column formatting.

Use of the \env{widetext} environment should be restricted to the bare
minimum of text that needs to be typeset this way. However short pieces
of paragraph text and/or math between nearly contiguous wide equations
should be incorporated into the surrounding wide sections.

Low-level control over the column grid can be accomplished with the
\cmd\onecolumngrid\ and \cmd\twocolumngrid\ commands. Using these, one
can avoid the horizontal rules added by \env{widetext}. These commands
should only be used if absolutely necessary. Wide figures and tables
should be accomodated using the proper \verb+*+ environments.

\subsection{Cross-referencing}\label{sec:xrefs}

\revtex{} inherits the \LaTeXe\ features for labeling and cross-referencing
section headings, equations, tables, and figures. This section
contains a simplified explanation of these cross-referencing features.
The proper usage in the context of section headings, equations,
tables, and figures is discussed in the appropriate sections.

Cross-referencing depends upon the use of ``tags,'' which are defined by
the user.  The \cmd\label\marg{key} command is used to identify tags for
\revtex. Tags are strings of characters that serve to label section
headings, equations, tables, and  figures that replace explicit,
by-hand numbering.

Files that use cross-referencing (and almost all manuscripts do)
need to be processed through \revtex\ at least twice to
ensure that the tags have been properly linked to appropriate numbers.
If any tags are added in subsequent editing sessions, 
\LaTeX{} will display a warning message in the log file that ends with
\texttt{... Rerun to get cross-references right}.
Running the file through \revtex\ again (possibly more than once) will
resolve the cross-references.  If the error message persists, check
the labels; the same \marg{key} may have been used to label more than one
object.

Another \LaTeX\ warning is \texttt{There were undefined references},
which indicates the use of a key in a \cmd\ref\ without ever
using it in a \cmd\label\ statement.

\revtex{} performs autonumbering exactly as in standard \LaTeX.
When the file is processed for the first time,
\LaTeX\ creates an auxiliary file (with the \file{.aux} extension) that 
records the value of each \meta{key}.  Each subsequent run retrieves
the proper number from the auxiliary file and updates the auxiliary
file.  At the end of each run, any change in the value of a \meta{key}
produces a \LaTeX\ warning message.

Note that with footnotes appearing in the bibliography, extra passes
of \LaTeX\ may be needed to resolve all cross-references. For
instance, putting a \cmd\cite\ inside a \cmd\footnote\ will require at
least three passes.

Using the \classname{hyperref} package to create hyperlinked PDF files
will cause reference ranges to be expanded to list every
reference in the range. This behavior can be avoided by using the
\classname{hypernat} package available from \url{www.ctan.org}.

\subsection{Acknowledgments}
Use the \env{acknowledgments} environment for an acknowledgments
section.  Depending on the journal substyle, this element may be
formatted as an unnumbered section title \textit{Acknowledgments} or
simply as a paragraph. Please note the spelling of
``acknowledgments''.
\begin{verbatim}
\begin{acknowlegments}
The authors would like to thank...
\end{acknowlegments}
\end{verbatim}

\subsection{Appendices}
The \cmd\appendix\ command signals that all following sections are
appendices, so \cmd\section\marg{title text} after \cmd\appendix\ will set
\marg{title text} as an appendix heading (an empty \marg{title text}
is permitted). For a single appendix, use a
\cmd\appendix\verb+*+ followed by \cmd\section\marg{title text}
command to suppress the appendix letter in the section heading.

\section{Math and Equations}\label{sec:math}

\subsection{Math in text}

Not surprisingly, \revtex\ uses the \TeX\ math \verb+$+ delimiters
for math embedded in text. For example,
\verb|$a^{z}$| give $a^{z}$.  Within math mode, use
\verb+^+\marg{math} for superscripts and
\verb+_+\marg{math} for subscripts. If the braces after the
\verb+^+ are omitted, \TeX{} will
superscript the next \emph{token} (generally a single character or
command). Thus it is safest to use explicit braces \verb+{}+.

As with text, math should not require extensive explicit vertical or
horzontal motion commands, because \TeX\ calculates math spacing
itself automatically.  In particular, explicit spacing around
relations (e.g., $=$) or operators (e.g., $+$) should be
unnecessary. These suggestions notwithstanding, some fine-tuning of
math is required in specific cases, see Chapter~18 in the \TeX
book\cite{TeXbook}.

\subsection{Text in math}\label{sec:textinmath}

There are times when normal, non-italic text needs to be inserted
into a math expression.  The \cmd\text\marg{text} command is the
preferred method of accomplishing this.  It produces regular text
\emph{and} scales correctly in superscripts:
\verb+$y=x \text{ for } x_{\text{e-p}}$+ gives 
``$y=x \text{ for } x_{\text{e-p}}$''. To use the \cmd\text\ command,
the \classname{amsmath} package must be loaded: include a
\cmd\usepackage\aarg{\classname{amsmath}} command in the document
preamble or use the class option \classoption{amsmath}. Please note
that \revtex~4 requires version 2.0 or higher of \classname{amsmath}.

Other common alternatives may be less desirable. Using the standard
\LaTeXe\  \cmd\mbox\marg{text} will give normal text, including a hyphen,
but will not scale correctly in superscripts:
\verb+$x_{\mbox{e-p}}$+ gives ``$x_{\mbox{e-p}}$''.
The \cmd\rm\ command
only switches to Roman font for math letters.  It does not, for
example, handle hyphens correctly:
\verb+$$x_{\rm{e-p}}$+ gives ``$x_{\rm e-p}$''. But note that
\cmd\textrm{}, it does work: \verb+$x_{\textrm{e-p}}$+ gives ``$x_{\textrm{e-p}}$''.

\subsection{Displayed equations}\label{sec:dispmath}

Equations are set centered in the column width or flush left depending
on the selected journal substyle.

For the simplest type of displayed equation, a numbered, one-line
equation, use the \env{equation} environment.
\revtex\ takes care of the equation number%
---the number will be set below the equation if necessary.
Use \cmd\[\dots\cmd\] for a single, one-line unnumbered display equation.

Use the \env{eqnarray} environment when more than one consecutive
equation occurs, putting each equation in a separate row of the
environment, and using \cmd\nonumber\ before the row end (\cmd\\) to
suppress the equation number where necessary.  If the equations are
related to each other, align each on the respective relation operator
(such as $=$).

When an equation is broken over lines or is continued over multiple
relation operators, it is called a multi-line or continued equation,
respectively; here, too, use the \env{eqnarray} environment.

For a continued equation, align each row on the relation operator just
as with multiple equations, and use the \cmd\nonumber\ command to
suppress auto-numbering on broken lines.  Also, use the starred form
of the row end (\cmd\\\verb+*+) to prevent a pagebreak at that
juncture.

Short displayed equations that can appear together on a single line
separated by \cmd\qquad\ space may be placed in a single
\env{equation} environment.

As explained in Section~\ref{sec:widetext}, occasionally in two-column
mode a long equation, in order to fit it in the narrow column width,
would need to be broken into so many lines that it would affect
readibility. Set it in a wide column using the \env{widetext}
environment. Then return to the normal text width as soon as
possible.

The sample file \file{apssamp.tex} illustrates how to obtain each of
the above effects.

\subsection{Numbering displayed equations}

\revtex~4 automatically numbers equations.
For single-line and multi-line equations, use the
\env{equation} and \env{eqnarray} environments as described above.
For unnumbered single-line equations, use the \verb+\[+\dots\verb+\]+
construction.  The command \cmd\nonumber\ will suppress the numbering
on a single line of an
\env{eqnarray}.
For a multi-line equation with no equation numbers at all,
use the \env{eqnarray*} environment.

A series of equations can be a labeled with a lettered sequence,
e.g., (3a), (3b), and (3c), by
putting the respective \env{equation} or \env{eqnarray} environment within a
\env{subequations} environment. 
The \classname{amsmath} package (can be loaded with the
\classoption{amsmath} class option) is required for this.

Use the command \cmd\tag\marg{number} to produce an idiosyncratic
equation number: $(1')$, for example.  Numbers assigned by \cmd\tag\
are completely independent of \revtex's automatic numbering.  The
package \classname{amsmath} is required for using the \cmd\tag\
command.

To have \revtex{} reset the equation numbers at the start of each section,
use the \classoption{eqsecnum} class option in the document preamble. 

See the sample file \file{apssamp.tex} for some examples.

\subsection{Cross-referencing displayed equations}

To refer to a numbered equation, use
the \cmd\label\marg{key} and \cmd\ref\marg{key} commands.
The \cmd\label\marg{key} command is used within the referenced equation
(on the desired line of the \env{eqnarray}, if a multi-line equation):
\begin{verbatim}
\begin{equation}
 A=B \label{pauli}
\end{equation}
 ... It follows from Eq.~(\ref{pauli})
that this is the case ...
\begin{eqnarray}
 A & = &B,\label{pauli2}\\
 A'& = &B'
\end{eqnarray}
\end{verbatim}
gives 
\begin{equation}
A=B \label{pauli}
\end{equation}
 ... It follows from Eq.~(\ref{pauli})
that this is the case ...
\begin{eqnarray}
A & = &B,\label{pauli2}\\
A'& = &B'
\end{eqnarray}

Please note the parentheses surrounding the \cmd\ref\ command.
These are \emph{not} provided automatically and, thus, must be
explicitly incorporated.

Numbers produced with \cmd\tag\ can also be cross-referenced by adding
a \cmd\label\ command after the \cmd\tag\ command.

Using a \cmd\label\ after \envb{subequations} to reference the
\emph{general} number of the equations in the
\env{subequations} environment. For example, if
\begin{verbatim}
\begin{subequations}
 \label{allequations} % notice location
 \begin{eqnarray}
  E&=&mc^2,\label{equationa}
 \\
  E&=&mc^2,\label{equationb}
 \\
  E&=&mc^2,\label{equationc}
 \end{eqnarray}
\end{subequations}
\end{verbatim}
%
gives the output
\begin{subequations}
\label{allequations} % notice location
\begin{eqnarray}
E&=&mc^2,\label{equationa}
\\
E&=&mc^2,\label{equationb}
\\
E&=&mc^2,\label{equationc}
\end{eqnarray}
\end{subequations}
%
then \verb+Eq.~(\ref{allequations})+ gives ``Eq.~(\ref{allequations})''.

{\bf Note:} incorrect cross-referencing will result if
\cmd\label\ is used in an unnumbered single-line equation
(i.e., within the \verb+\[+ and \verb+\]+ commands),
or if \cmd\label\ is used on a line of an eqnarray that is not being numbered
(i.e., a line that has a \cmd\nonumber).

\subsection{Using the AMS packages \classoption{amsfonts},
\classoption{amssymb}, and \classoption{amsmath}}\label{AMS}

The American Mathematical Society's AMS-\LaTeX\ packages provided extra
fonts, symbols, and math markup that are quite convenient. \revtex~4
supports the use of these packages directly. To use the \classoption{amsfonts},
\classoption{amssymb}, and \classoption{amsmath} class options,
AMS-\LaTeX\ (and perhaps the additional AMS fonts) will need to be
installed. Please note the \revtex~4 requires version 2.0 or higher
of AMS-\LaTeX. These packages can be downloaded from
\url{http://www.ams.org/tex/}.

There are two class options for accessing the AMS fonts:
\classoption{amsfonts} and \classoption{amssymb}.
The \classoption{amsfonts} option defines the \cmd\mathfrak\ and
\cmd\mathbb\ commands to switch to the Fraktur and
Blackboard Bold fonts, respectively.
These fonts are selected with the \cmd\mathfrak\ and \cmd\mathbb\
font-switching commands:
\verb+${\mathfrak{G}}$+ gives a Fraktur ``$\mathfrak{G}$''
and \verb+${\mathbb{Z}}$+ gives a Blackboard Bold ``$\mathbb{Z}$''.
\revtex{} does not currently support the use of the extra Euler fonts
(the AMS fonts starting with \texttt{eur} or \texttt{eus}) or the
Cyrillic fonts (the AMS fonts starting with \texttt{w}).

The \classoption{amssymb} class option gives all the font
capabilities of the
\classoption{amsfonts} class option and further defines the commands
for many commonly used math symbols. These symbols will scale
correctly in superscripts and other places. See the AMS-\LaTeX\
documentation for the complete list of symbols available.

\subsection{Bold symbols in math}\label{sec:bboxamsfonts}

\revtex~4 uses the standard \LaTeXe\ Bold Math (\classname{bm}) package as the
basis for creating bold symbols in math mode. As usual, this requires
an explicit \cmd\usepackage\aarg{\classname{bm}} in the document
preamble. The command
\cmd\bm\marg{symbol} makes \marg{symbol} bold in math mode, ensuring
that it is the correct size, even in superscripts. If the correct font
in the correct size is not available then result is the \marg{symbol}
set at the
correct size in lightface and a \LaTeXe\ warning that says
``\texttt{No boldmath typeface in this size}\dots''. Most bold special
characters will require that the AMS fonts be installed and the
\classoption{amsfonts} class option be invoked.

\cmd\bm\ is the proper means to get bold Greek characters---upper- and
lowercase---and other symbols.
The following will come out bold with \cmd\bm:
normal math italic letters, numbers,
Greek letters (uppercase and lowercase),
small bracketing and operators, and \cmd\mathcal. Fraktur
characters will come out bold in a \cmd\bm; however, Blackboard Bold
requires using the \cmd\mathbb command rather than \cmd{\bm}.
The \classoption{amsfonts} option adds support for bold math
letters and symbols in smaller sizes and in superscripts when a
\cmd\bm\marg{symbol} is used. 
For example, \verb+$\pi^{\bm{\pi}}$+ gives a bold
lowercase pi in the superscript position: $^{\pi\bm{\pi}}$.

Note that \cmd\bm\marg{math} is a fragile command and, thus, should be
preceded by \cmd\protect\ in commands with moving arguments.

\section{Footnotes}
\LaTeX's standard \cmd\footnote\ command is available in
\revtex~4. The footnote text can either appear at the bottom of a page or
as part of the bibliography (in order, after the rest of the
references). This choice can be controlled by two class options:
\classoption{footinbib} and \classoption{nofootinbib}. \revtex~4
defaults to the former.  Specific journal options may select a
different value than the default. Note that in the latter case, the
argument of the
\cmd\footnote\ command is a moving argument in the sense of the \LUG,
Appendix~C.1.3: any fragile command within that argument must be
preceded by a \cmd\protect\ command.

The \cmd\footnote\ macro \emph{should not} be used in the front
matter for indicating author/affiliation relationships or to provide
additional information about authors (such as an e-mail
address). See Section~\ref{sec:footau} for the proper way to do
this.

Finally, footnotes that appear in tables behave differently. They
will be typeset as part of the table itself. See
Section~\ref{sec:tablenote} for details.

\section{Citations and References}\label{sec:endnotes}

In keeping with the \revtex~4 design goal of making it easier to
extract tagged information from a manuscript, new macros and \BibTeX\
style files have been added to provide better markup. Furthermore,
these have been built upon some widely-used \LaTeX\ packages in line
with the design goal of making use of the existing packages where
possible. The two main external packages that are of concern here are
Patrick Daly's \classname{natbib} citation package and his
\classname{custom-bib} tool kit for building new \BibTeX\ style
files.

From an author's point of view, all this means is that a proper
\revtex~4 installation requires having \classname{natbib} (version 7
or higher) installed. It also means that the full set of
\classname{natbib} functionality is available from within \revtex~4
(but see the \textit{APS Compuscript Guide for \revtex~4} for restrictions).
The \classname{natbib} documentation contains many exmaples; see in
particular the included \verb+natnotes.tex+ file for a convenient summary.

As in standard \LaTeX, references are cited in text using the
\cmd\cite\marg{key} command and are listed in the bibliography using
the \cmd\bibitem\marg{key} command. The \cmd\cite{} macro enables
\revtex~4 to automatically number the references in the manuscript.

A typical example might be:
\begin{verbatim}
String theory\cite{GSW} attempts to 
provide a theory of everything.
\end{verbatim}
The corresponding \cmd\bibitem{} would be:
\begin{verbatim}
\bibitem{GSW} M.~Greene, J.~Schwarz, and
E.~Witten, \textit{Superstring Theory:
Introduction}, (Cambridge University
Press, London, 1985).
\end{verbatim}

Journals differ in how the \cmd\cite\ will be displayed. Most APS journals
display the citation in-line, as a number, enclosed in square brackets,
\textit{e.~g.}, ``String theory[1] attempts\dots.'' Other journals
(most notably \textit{Physical Review B})
instead use a number in a superscript: ``String theory$^{1}$ attempts\dots.''
Selecting the journal substyle using a class option (such as
\classoption{prb}) will invoke the appropriate style.
In journal substyles using superscripts,
the macro the \cmd\onlinecite\marg{key} is necessary to get the number
to appear on the baseline.
For example, ``String theory (see, for example,
\verb+Ref.~\onlinecite{GSW}+)'' will give the output
``String theory (see, for example, Ref.~1).''

The \cmd{\onlinecite} command has the same semantics as
\classname{natbib}'s \cmd{\citealp} command.

A \cmd\cite\ command with multiple keys is formatted with consecutive
reference numbers collapsed; e.g., [1,2,3,5] will be output as
[1--3,5].  To split the list over more than one line, use
a \verb+%+ character immediately following a comma:
\begin{verbatim}
. . .  \cite{a,b,c,d,e,f,%
g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}
\end{verbatim}
The \verb+%+ avoids unwanted spaces.

\subsection{Author/Year (Non-numeric) Citations}

\textit{Reviews of Modern Physics} uses a citation style based on the
first author's last name and the year of the reference rather than a
simple number. Support for this style of citing references is the
primary reason \revtex~4 uses the \classname{natbib}
package. \classname{natbib} uses an optional argument to the
\cmd\bibitem\ macro to specify what text to use for the \cmd\cite\
text:
\begin{quote}
\cmd\bibitem\verb+[+\meta{short-name}\verb+(+\meta{year}\verb+)+\meta{long-name}\verb+]+
\end{quote}
where \meta{short-name} is the author name used in a parenthetical citation, 
\meta{long-name} that used in a textual citation, and 
\meta{year} is the year. More concretely, the \cmd\bibitem\ example
above would appear as
\begin{verbatim}
\bibitem[Greene et al.(1985)Green,
Schwarz, and Witten]{GSW}
M.~Greene, J.~Schwarz, and E.~Witten,
\textit{Superstring Theory},
(Cambridge Press, London, 1985).
\end{verbatim}

When the citation constitutes part of the grammar of the sentence,
the \cmd\textcite\marg{key} command may be used (analogous to the
\cmd\onlinecite\ command above). Both \cmd\textcite\ and
\cmd\onlinecite\ are built upon \classname{natbib}'s rich repertoire of
macros (\cmd\citep{}, \cmd\citet{}, etc.). These macros are available in
\revtex~4; however, APS authors must follow the
\textit{APS Compuscript Guide for \revtex~4}
guidelines regarding \classname{natbib}'s macros.

\subsection{\label{sec:use-bib}Using Bib\TeX}

The \cmd\bibitem{} entries can be coded by hand as above, of course, but the
use of \BibTeX\ with the new style files provided with \revtex~4 makes
it particularly simple to generate marked-up references that can, for
instance, take advantage of packages like
\classname{hyperref} for linking. They also save the trouble of having
to specify formatting like the italics for the book title in the above
example. And, for those wishing to use author/year citations, \BibTeX\ 
will automatically generate the appropriate optional arguments for the
\cmd\bibitem\ commands.

\BibTeX\ is an adjunct to \LaTeX\ that aids in the
preparation of  bibliographies. \BibTeX\ allows authors to build up a
database or collection of bibliography entries that may be used for many
manuscripts. A \BibTeX\ style file then specifies how to transform the
entries into a proper \cmd\bibitem{} for a particular journal. Here we
give a brief summary of how to get started with \BibTeX. More details can be
found in the \textit{\revtex~4 \BibTeX\ Guide} included in the
distribution or in the LaTeX books listed in the references.

Selecting a journal style by using an appropriate class option will
automatically select the correct \BibTeX\ style file. For all
of the \textit{Physical Review} journals, this is \file{apsrev.bst},
while for \textit{Reviews of Modern Physics} this is
\file{apsrmp.bst}. The selection can be overridden by specifying an
alternative \file{.bst} file using the standard \LaTeXe
\cmd\bibliographystyle\ macro. This must appear in the preamble
before the \envb{document} line in \revtex~4 (this differs from
standard \LaTeX).

The \BibTeX\ database files will contain entries such as:
\begin{verbatim}
@Book{GSW,
  author=``M. Greene, J. Schwarz,
           E. Witten'',
  title=``Superstring theory:
          Introduction'',
  publisher=``Cambridge University
          Press'',
  address=``London'',
  year=``1985''
}
\end{verbatim}
There are entry formats for articles, technical reports, e-prints,
theses, books, proceedings, and articles that appear in books or
proceedings. The \file{apsrev} and \file{apsrmp} styles provided with
\revtex~4 also allows URL's and e-print identifiers to be specified
for any of the different entry types. There is also an additional
``collaboration'' field that can be used in addition to ``author''.

To actually create the bibliography in the manuscript, the
\cmd\bibliography\marg{bib files} macro is used. 
Here \meta{bib files} is a comma-separated list of \BibTeX\ bibliography
database files, each with the \file{.bib} extension. The
\cmd\bibliography\ macro should be placed at the location where the
references are to appear (usually after the main body of the
paper). When the manuscript is processed with \LaTeX\ for the first
time, the keys corresponding for the \cmd\cite{} macros used in the
manuscript are written out to the \file{.aux} file. Then \BibTeX\ should
be run (if the manuscript is called \file{paper.tex}, the command would
be \verb+bibtex paper+. This will produce a \file{.bbl} file containing all
of the \cmd\bibitem{}'s for the manuscript. Subsequent runs of \LaTeXe\
will call this file in to resolve the references. \LaTeXe\ should be run
repeatedly until all references are resolved.

The \BibTeX-produced \cmd\bibitem{}'s created using the \file{apsrev} and
\file{apsrmp} appear considerably more complex than the example given
above. This is because the style files add in \cmd\bibinfo{},
\cmd\bibnamefont{}, \cmd\eprint{}, and \cmd\url{} macros for
specifying additional formatting and tagging. The \cmd\bibinfo\ macro
is mostly a do-nothing macro that serves merely to tag the information with
the field information from the original entry in the \BibTeX\ database.
The \cmd\eprint\ and \cmd\url\ macros can be used to create the
appropriate hyperlinks in target formats such as PDF.

For more information on using \BibTeX\ with \LaTeX, see Sections~4.3.1
and~C.11.3 of the \LUG\cite{LaTeXman}, Section~13.2 of \cite{Compan},
or the online \BibTeX\ manual
\url{http://ctan.tug.org/tex-archive/biblio/bibtex/distribs/doc/btxdoc.tex}.
%\url{http://ctan.tug.org/tex-archive/help/Catalogue/entries/bibtex.html}.

\section{Figures and Artwork}\label{sec:figures}

Figures may be included into a \revtex~4 manuscript by using the
standard \LaTeXe\ macros. It should be noted that \LaTeXe\ includes
several powerful packages for including the files in various
formats. The two main packages are \classname{graphics} and
\classname{graphicx}. Both offer a macro called
\cmd\includegraphics\oarg{args}\marg{filename}; 
they mainly differ in how arguments for
controlling figure scaling, translation, and orientation
are specified. Old \LaTeX2.09 interfaces such as
\file{epsfig} have been re-implemented on top of these packages.
For more information on the enhancements of the \classname{graphicx} package, 
see \cite{CompanG} or
\url{ftp://ctan.tug.org/tex-archive/macros/latex/required/graphics/grfguide.ps}.
\revtex~4 no longer has the \classoption{epsf} class option, though
the \classname{epsfig} package provides a similar interface.


The \env{figure} environment should be used to add a caption to the figure and
to allow \LaTeX\ to number and place the figures where they fit best. 
\LaTeX\  will label and automatically number the captions FIG.~1,
FIG.~2, etc. For example:
\begin{verbatim}
\begin{figure}
 \includegraphics{fig1.eps}
 \caption{\label{fig1}Text of first caption.}
\end{figure}
\end{verbatim}
Note how the \cmd\label\marg{key} command is used to cross-reference
figures in text. The \cmd\label\marg{key} command should be inserted
inside the figure caption. As usual, the \cmd\ref\marg{key} macro can
then by used to refer to the label: ``As depicted in
FIG.\verb+~\ref{fig1}+\dots''.

Figures are normally set to the width of the column in
which they are placed. This means that in two-column mode, the figure
will be placed in a single, narrow column. For wide figures, the
\cmd\figure\verb+*+ environment should be used
instead. This will place the figure across both columns (the figure
usually will
appear either at the top or the bottom of the following page).


Captions less than one line long are centered under the figure,
otherwise they span the width of the figure.

Note that is unnecessary (and undesirable) to use explicit centering
commands inside the float environments.

\section{Tables}\label{sec:tables}

Tables are very similar to figures. They should be input using the
\env{table} environment as detailed below, and 
\LaTeX\ will label and number the captions TABLE~1, TABLE~2, etc.
(or in whatever format required by the chosen journal
substyle). Tables without captions won't be numbered.

Each table must begin with \envb{table}, end with \enve{table}. A
caption can be specified using the \cmd\caption\marg{text} command.
Captions less than one line long are centered under the figure,
otherwise they span the width of the figure.
To refer to the table via cross-referencing, a \cmd\label\marg{key}
command should appear within the \cmd{\caption}.  Use the
\cmd\ref\marg{key} command to cite tables in text. The \env{table}
environment will set the table to the width of the column. Thus, in
two-column mode, the table will confined to a single column. To set a
table to the full width of the page, rather than the column, use the
\env{table*} environment.

The heart of the table is the
\env{tabular} environment. This will behave for the most part as in
standard \LaTeXe\ (please refer to Section~3.6.3 and Appendix~C.10.2 of the
\LUG{} for more details about the \env{tabular} environment).
Note that \revtex~4 no longer automatically adds double (Scotch) rules
around tables. Nor does the \env{tabular} environment set various
table parameters for column spacing as before. Instead, a new
environment \env{ruledtabular} provides this functionality. This
environment should surround the \env{tabular} environment:
\begin{verbatim}
\begin{table}
\caption{\label{<key>}....}
\begin{ruledtabular}
\begin{tabular}
...
\end{tabular}
\end{ruledtabular}
\end{table}
\end{verbatim}

A basic table looks as follows:
\begin{verbatim}
\begin{table}
\caption{\label{tab:example}Text of table caption.}
\begin{ruledtabular}
\begin{tabular}{ll}
  Heading 1 & Heading 2\\
  Cell 1 & Cell 2\\
\end{tabular}
\end{ruledtabular}
\end{table}
\end{verbatim}

The \env{quasitable} environment is no longer in \revtex~4. The
standard \env{tabular} environment can be used instead because it
no longer puts in the double rules.

\subsection{Aligning on a decimal point}
Numerical columns should align on the decimal point (or
decimal points if more than one is is present). This is accomplished
by again using a standard \LaTeXe\ package, \classname{dcolumn} which
must be loaded in the manuscript's preamble:
\begin{verbatim}
\usepackage{dcolumn}
\end{verbatim}
Once this package is loaded, the column specifier `\texttt{d}' can be
used in the table's \env{tabular}\marg{preamble} enviroment preamble.
The `\texttt{d}' should be used for simple numeric data with a single
decimal point.
%
The entry of a \texttt{d} column is typeset in math mode; do not
insert any \verb+$+ math delimiters into a `\texttt{d}' column.  Items
without a decimal point are simply set in math mode, centered.  If
text is required in the column, use \cmd\text\ or \cmd\mbox\ as
appropriate.  If multiple decimal points are present then the last is
used for alignment. To escape from the `\texttt{d}' column use
\cmd\multicolumn\ as usual. See the sample file \file{apssamp.tex} for examples.

\subsection{Footnotes in Tables}\label{sec:tablenote}

Footnotes in a table are labeled \emph{a}, \emph{b}, \emph{c},
etc. They can be specified by using the \LaTeX\ \cmd\footnote\
command. Furthermore,
\cmd\footnotemark\ and \cmd\footnotetext\ can be used so that multiple entries
can to refer to the same footnote. The footnotes for a table are typeset
at the bottom of the table, rather than at the bottom of the page or
at the end of the references. The arguments for \cmd\footnotemark\ and
\cmd\footnotetext\ should be numbers 1, 2, \dots. The journal style
will convert these to letters.  See sample file \file{apssamp.tex} for
examples and explanations of use.

\subsection{Dealing with Long Tables}
By default, tables are set in a smaller size than the text body
(\cmd\small). The \cmd\squeezetable\ declaration makes the table font
smaller still (\cmd\scriptsize).  Thus, putting the
\cmd\squeezetable\ command before the \envb{table} line in a table
will reduce the font size. If this isn't sufficient to fit
the table on a page, the standard \LaTeXe\ \classname{longtable}
package may be used. The scope of the
\cmd\squeezetable\ command must be limited by enclosing it with a group:
\begin{verbatim}
\begingroup
\squeezetable
\begin{table}
[...]
\end{table}
\endgroup
\end{verbatim}

Tables are normally set to the width of the column in
which they are placed. This means that in two-column mode, the table
will be placed in a single, narrow column. For wide tables, the
\cmd\table\verb+*+ environment should be used
instead. This will place the table across both columns (the table
usually will
appear either at the top or the bottom of the following page).


Under \revtex~3, tables automatically break across pages; \revtex~4
provides some of this functionality. However, this requires adding to the
table a float placement option of [H] (meaning put the table ``here''
and effectively ``unfloating'' the table) to the \envb{table}
command. The commands \verb+\\*+ and \cmd{\samepage} can be used to
control where the page breaks occur (these are the same as for the
\env{eqnarray} environment).

Long tables are more robustly handled by using the
\classname{longtable.sty} package included with the standard \LaTeXe\
distribution (put \verb+\usepackage{longtable}+ in the preamble). This
package gives precise control over the layout of the table.
The \revtex~4 package contains patches that enable the
\classname{longtable} package to work in two-column mode. Of course, a
table set in two-column mode needs to be narrow enough to fit within
the column. Otherwise, the columns may overlap. \revtex~4 provides
an additional environment \env{longtable*} which allows a longtable to
span the whole page width. Currently, the \env{longtable*} and
\env{ruledtabular} environments are incompatible. In order to get the
double (Scotch) rule, it is necessary to add the \verb+\hline\hline+
manually (or define \verb+\endfirsthead+ and \verb+\endlastfoot+
appropriately).  For more documentation on the \env{longtable}
environment and on the package options of the
\classname{longtable} package, please see the documentation available at
\url{ftp://ctan.tug.org/macros/latex/required/tools/longtable.dtx} or
refer to \cite{Compan}.

\section{Placement of Figures, Tables, and Other Floats}
\label{sec:place}

By default, figures and tables (and any other ``floating'' environments
defined by other packages) float to the top or bottom of the page
using the standard \LaTeX\ float placement mechanism.  Initially, each
\env{figure} or \env{table} environment should be put immediately
following its first reference in the text; this will usually result in
satisfactory placement on the page.  An optional argument for either 
environment adjusts the float placement. For example:
\begin{quote}
\envb{figure}\oarg{placement}\\
\dots\\
\enve{figure}
\end{quote}
where \meta{placement} can be any combination of \verb|htbp!|, signifying
``here'', ``top'', ``bottom'', ``page'', and ``as soon as possible'',
respectively. The same placement argument may be added to a
\envb{table}. For more details about float placement, 
see the instructions in the \LUG, Appendix~C.9.1.

In two-column mode, a page may contain both a \env{widetext}
environment and a float. \revtex~4 may not always be able to
automatically put the float in the optimal place. For instance, a
float may be placed at the bottom of a column just before the
\env{widetext} begins. To workaround this, try moving the float
environment below the \env{widetext} environment. Alternative
\meta{placements} may also alleviate the problem.

\env{figure} and \env{table} environments should not 
be enclosed in a \env{widetext} environment to make them span
the page to accomodate wide figures or tables. Rather, the
\env{figure*} or \env{table*} environments should be used instead.

Sometimes in \LaTeX\ the float placement mechanism breaks down and a
float can't be placed. Such a ``stuck'' float may mean that it and all
floats that follow are moved to the end of the job (and if there are
too many of floats, the fatal error \texttt{Too many unprocessed floats}
will occur). \revtex~4 provides the class option
\classoption{floatfix} which attempts to invoke emergency float
processing to avoid creating a ``stuck'' float. \revtex~4 will provide
a message suggesting the use of
\classoption{floatfix}. If \classoption{floatfix} doesn't work or if
the resulting positioning of the float is poor, the float should be
repositioned by hand.

\revtex~4 offers an additional possibility for placing the floats. By
using the either the \classoption{endfloats} or the
\classoption{endfloats*} class option all floats may be held
back (using an external file) and then set elsewhere in the document
using the the commands \cmd\printtables\ and \cmd\printfigures{},
placed where the tables and figures are to be printed (usually at the
end of the document).  (This is similar to the standard
\cmd\printindex\ command). Using a \texttt{*}-form of the commands
(\cmd\printfigures\verb+*+ and
\cmd\printtables\verb+*+) will begin the figures
or tables on a new page. Alternatively, the option
\classoption{endfloats*} may be used to change the behavior of the
non-\texttt{*}-forms so that every float will appear on a separate
page at the end.

Without one of the \classoption{endfloats} class options, these float
placement commands are silently ignored, so it is always safe to use
them.  If one of the \classoption{endfloats} class options is given,
but the \cmd\printtables\ command is missing, the tables will be
printed at the end of the document. Likewise, if \cmd\printfigures\ is
missing, the figures will be printed at the end of the document.
Therefore it is also safe to omit these commands as long as \revtex's
default choices for ordering figures and tables are satisfactory.

The \classoption{endfloats} option (or perhaps some journal substyle
that invokes it), requires explicit \envb{figure}, \enve{figure},
\envb{table}, and \enve{table} lines. In particular, do \emph{not}
define typing shortcuts for table and figure environments, such as
\begin{verbatim}
\def\bt{\begin{table}}% Incompatible!
\def\et{\end{table}}%
\end{verbatim}

Please note that it is generally undesirable to have all floats moved
to the end of the manuscript. APS no longer requires this for
submissions. In fact, the editors and referees will have an easier time
reading the paper if the floats are set in their normal positions.

\section{Rotating Floats}

Often a figure or table is too wide to be typeset in the standard
orientation and it is necessary to rotate the float 90
degrees. \revtex~4 provides a new environment \env{turnpage} as an
easy means to accomplish this. The \env{turnpage} environment depends
on one of the packages \classname{graphics} or \classname{graphicx}
being loaded. To use the \env{turnpage} environment, simply enclose
the \env{figure} or \env{table} environment with the \env{turnpage}
environment:
\begin{verbatim}
\documentclass[...]{revtex4}
\usepackage{graphicx}
[...]
\begin{turnpage}
\begin{figure} or \begin{table}
[...]
\end{figure} or \end{table}
\end{turnpage}
\end{verbatim}
A turnpage float will be typeset on a page by itself. Currently, there
is no mechanism for breaking such a float across multiple pages.

\section{\revtex~4 symbols and the \classname{revsymb} package}

Symbols made available in earlier versions of \revtex\ are
defined in a separate package, \classname{revsymb},
so that they may be used with other classes.
This might be useful if, say, copying text from a \revtex\ document to
a non-\revtex\ document. \revtex~4 automatically includes these
symbols so it is not necessary to explicitly call them in with a 
\cmd\usepackage\ statement.

Table~\ref{tab:revsymb} summarizes the symbols defined in this package.
Note that \cmd{\overcirc}, \cmd{\overdots}, and \cmd{\corresponds} are
no longer in \revtex~4. Use \cmd{\mathring} (standard in \LaTeXe),
\cmd{\dddot} (with the \classoption{amsmath} package loaded), and 
\cmd\triangleq\ (with the \classoption{amssymb} class option) respectively.
\cmd{\succsim}, \cmd{\precsim}, \cmd{\lesssim}, and \cmd{\gtrsim} are
also defined either in \classname{amsmath} or \classname{amssymb}. The
AMS versions of these commands will be used if the appropriate AMS
package is loaded.

\begin{table}
\caption{\label{tab:revsymb}Special \revtex~4 symbols, accents, and
boldfaced parentheses defined in \file{revsymb.sty}}
\begin{ruledtabular}
\begin{tabular}{ll|ll}
\cmd\lambdabar & $\lambdabar$ &\cmd\openone & $\openone$\\
\cmd\altsuccsim & $\altsuccsim$ & \cmd\altprecsim & $\altprecsim$ \\
\cmd\alt & $\alt$ & \cmd\agt & $\agt$ \\
\cmd\tensor\ x & $\tensor x$ & \cmd\overstar\ x & $\overstar x$ \\
\cmd\loarrow\ x & $\loarrow x$ & \cmd\roarrow\ x & $\roarrow x$  \\
\cmd\biglb\ ( \cmd\bigrb ) & $\biglb( \bigrb)$ &
\cmd\Biglb\ ( \cmd\Bigrb )& $\Biglb( \Bigrb)$ \\
& & \\
\cmd\bigglb\ ( \cmd\biggrb ) & $\bigglb( \biggrb)$ &
\cmd\Bigglb\ ( \cmd\Biggrb\ ) & $\Bigglb( \Biggrb)$ \\
\end{tabular}
\end{ruledtabular}
\end{table}

\section{Other \revtex~4 Features}
%\subsection{Hooks}
%To be written....

\subsection{Job-specific Override Files}
\revtex~4 allows manuscript-specific macro definitions to be put
in a file separate from the main \TeX\ file. One merely creates a file
with the same basename as the \TeX\ file, but with the extension
`.rty'. Thus, if the \TeX\ file is names man.tex, the macro
definitions would go in man.rty. Note that the .rty file should be in
the same directory as the \TeX\ file. APS authors should follow the
guidelines in the \textit{APS Compuscript Guide for \revtex~4} when
submitting.

\begin{thebibliography}{}\label{sec:TeXbooks}
\bibitem[Knuth(1986)]{TeXbook} D.E. Knuth, \emph{The \TeX book},
(Addison-Wesley, Reading, MA, 1986).
\bibitem[Lamport(1996)]{LaTeXman} L. Lamport, \emph{\LaTeX, a Document
Preparation System}, (Addison-Wesley, Reading, MA, 1996).
\bibitem[Kopka(1995)]{Guide} H. Kopka and P. Daly, \emph{A Guide to
\LaTeXe}, (Addison-Wesley, Reading, MA, 1995).
\bibitem[Goossens(1994)]{Compan} M. Goosens, F. Mittelbach, and
A. Samarin, \emph{The \LaTeX\
Companion}, (Addison-Wesley, Reading, MA, 1994).
\bibitem[Goossens(1997)]{CompanG} M. Goossens, S. Rahtz, and
F. Mittelbach, \emph{The
\LaTeX\ Graphics Companion}, (Addison-Wesley, Reading, MA, 1997).
\bibitem[Rahtz(1999)]{CompanW} S. Rahtz, M. Goossens, \emph{et
al.},\emph{The \LaTeX\ Web Companion}, (Addison-Wesley, Reading, MA, 1999).
\end{thebibliography}

\end{document}