• Home   /
• Archive by category "1"

## REVTeX 4 - Frequently Asked Questions

REVTeX 4 Home

The current version is REVTeX (patch level 2), released on August 11,

## Bugs/Workarounds

March 15, A new release of REVTeX has been made public. The following bugs were addressed:

• Using the same \affiliation more than once results in some authors not getting any affiliation at all.
• reftest was left out of the distribution
• For RMP, the \cite command doesn't enclose the citation in parentheses properly.
• For RMP, the .bst files don't properly handle several cases including a book with editors, but no authors

In addition, there were many other improvements including the handling of footnotes, compatibility with packages such as lscape and hyperref, and punctuation in bibliographies. Also, the "long" version of the BibTeX style files have been removed from the distribution. The remaining style files have been enhanced to provide the same functionality when the longbibliography class option is used.

## Changes from REVTeX 4

The current release of REVTeX may be download directly from this site as a zipfile: revtexzip. In addition, it may be found on CTAN in the latex/contrib/revtex directory.

Where do I get a TeX installation?

• TeX Live is available for many platforms from the TeX Live home page. It is updated annually and it is a rather comprehensive distribution. REVTeX has been part of TeX Live starting with its distribution.
• MacTeX for Mac users is made available via the MacTeX package on the TUG site.
• MiKTeX is also a free Windows TeX installation. You might be interested in downloading the up-to-date MiKTeX installer. Choose either the basic system or the complete MiKTeX system.
• Scientific Word is another option for using LaTeX on Windows. It is available from Mackichan Software.
• PCTeX is still another option for Windows available from their website.

Is REVTeX still available?

REVTeX may still be needed for legacy documents. Most REVTeX 4 documents should run under REVTeX as well. Many TeX distributions remove older packages, so you may need to install REVTeX 4 yourself. It can be downloaded as the zip file lyouzqp.prodejce.cz REVTeX 4 and REVTeX can be installed side-by-side on the same computer without interfering each other. New documents should be created using REVTeX , especially if you are planning on submitting to an APS journal.

## Installing REVTeX 4

I have a TeX installation. How do I install REVTeX ?

Many up-to-date TeX installations already include REVTeX Installation for TeX Live and MikTeX is fairly straightforward because both use the standard TeX Directory Structure (TDS) layout for their files. See the README file included in the REVTeX distribution for basic instructions. REVTeX comes as a zip file using the same TDS layout. Usually one only need unzip the lyouzqp.prodejce.cz file in the proper place and run a program to update where TeX looks for files. See the README and the documentation for your TeX distribution on which program to run.

For other TeX distributions, please consult that distribution's documentation.

REVTeX 4 and can be installed side-by-side on the same computer. The files in are all versioned.

## Using REVTeX

Are there any templates to help with producing my paper?

REVTeX comes with template files called lyouzqp.prodejce.cz for APS journals and lyouzqp.prodejce.cz for AIP journals. They are located in the doc/latex/revtex/sample directory.

How do I achieve a one-column, double-spaced, 12 pt document?

Using \documentclass[preprint,]{revtex} gives 12 pt., one-column, double-spaced look used for the review/production process.

How do I make my paper look like the journal?

Using \documentclass[reprint,]{revtex} gives the look and feel of the journal (whether the journal is set in one or two columns). You may use the twocolumn class option to force a two-column layout.

How do I format a one-page comment or erratum?

Just format it as a regular article. REVTeX doesn't support comments or errata directly. It will be formatted in the production stage of the processing of the manuscript.

How do I change the numbering of pages?

The standard LaTeX 2e method should work: \setcounter[page]{}. Any standard LaTeX2e manual should be able to help you with this.

How do I remove all page numbers?

You should be able to use the standard LaTeX 2e \pagestyle{empty}. Please consult any LaTeX 2e manual.

How do I choose the square bracket or superscript style for citations?

The citation style is set by the journal option you choose. For APS journals, only the prb option gives superscript-style citations.

Why is the compiler rejecting the \Bbb command and recommending the \mathbb command?

Be sure you are using the amssymb math package by specifing the amssymb class option:
\documentclass[,amssymb,]{revtex}

How do I format long equations in a preprint format?

If you want them typeset with a certain set of line breaks, you should force the line breaks in your preprint style submission. Our typesetter is the final arbiter of how the math is set, so it may be changed in production. You may include a note in your cover letter indicating why you prefer to have the equations typeset with the line breaks. You will also be given the opportunity to comment on the formatting at the author proofs stage.

Why is there no top margin when I print?

The bounding box is cutting off the top of the page. Be sure that your dvips is configured to use letter size and not A4 size paper. If you are running Unix, try using the texconfig command to check and fix the default size.

Can I use REVTeX to prepare a contribution to an AIP journal?

Yes, REVTeX introduced full support for all AIP journals. Please consult Author's Guide to AIP Substyles for REVTeX Questions regarding AIP journals should be sent to tex@lyouzqp.prodejce.cz

How do I add line numbers to my document?

Use the linenumbers class option: \documentclass[,linenumbers,]{revtex}. This will call in lyouzqp.prodejce.cz (and patch it to work with REVTeX ).

## Page Length

Can I use REVTeX to estimate the length of my submission?

Although using the reprint option in REVTeX typesets the text area and font sizes appropriately for each journal, the formatting in REVTeX is not exact enough for determining the final length of an article once it goes through journal production (which involves converting the article to XML). Different fonts and figure scalings are the largest sources of error. Use of Times-Roman fonts can partially mitigate the problem. Length estimates at APS are calculated as described in our Length Guide. For AIP length requirements, please consult their web site.

## Bugs/Workarounds

Why does \tag not work with hyperref?

This isn't really a REVTeX bug. There is an incompatibility between AMSTeX's \tag command and hyperref. We don't know of a workaround.

## BibTeX

Is there any link to the BibTeX Guide mentioned in the REVTeX 4 documentation?

This was an error in the REVTeX 4 documentation and has been addressed in REVTeX At this point in time, there is no separate BibTeX guide. A good LaTeX book will contain an intro to BibTeX and help you through the process. We can answer specific questions if you have them.

How do I put multiple references in the same bibliography entry?

Combining multiple references into a single bibliography entry when using BibTeX was one of the most common problems authors run into. During the development of REVTeX , we worked with Patrick Daly to add enhancements to his natbib package to make this straightforward. To combine two references together, prepend an * to the argument of the \cite command. For instance, if you want the bibitems with keys feynman and bohr combined into a single entry, use \cite{feynman,*bohr}. The references will be separated by a semicolon in a single entry.

Another feature of natbib and REVTeX is to allow the prepending or appending of text to an entry in the bibliography. This is done via \cite{*[{prepended text}][{appended text}]key}. Note the use of the curly braces within the square bracket to avoid problems with the processing of the text. See the REVTeX documentation for more information.

The lyouzqp.prodejce.cz files are available at CTAN in the macros latex/contrib/natbib directory.

Is it necessary to have the same citation order in a .bib file?

The order in the BibTeX entries in the .bib file is irrelevant. Only the order of the \cite commands matters.

How can I make the titles of cited journal articles appear in the bibliography?

REVTeX calls in a default BibTeX Style (.bst) file for each supported journal. The .bst files support displaying the titles of cited journal articles in the bibliography. To display the titles, simply use the "longbibliography" class option. Consult the REVTeX documentation for more information.

How do I include an accent in an author's name?

Try surrounding the entire name in an additional set of braces. Or, try isolating the accented letter as {\"u}.

How do I keep footnotes in order of appearance within the text instead of having them appear at the end of the bibliography?

REVTeX uses the footnote style appropriate for the chosen journal. You can override the journal default by using the 'footinbib' or 'nofootinbib' options (see the command summary documentation included with REVTeX ).

I received warning messages about missing references when I ran LaTeX on my file.

While in the directory containing the TeX files, run the following:

• latex lyouzqp.prodejce.cz
• bibtex file (creates the .bbl file)
• latex lyouzqp.prodejce.cz (runs latex on the .tex and .bbl files together)
• latex lyouzqp.prodejce.cz (second run of latex corrects the citations)

BibTeX will have created a .bbl file. When submitting to APS or AIP journals, we ask that you include the final .bbl directly into the main .tex file.

How do I get a truncated reference, e.g., "Ann Author et al." when there are 5 or more authors?

The BibTeX style files distributed with REVTeX no longer truncate the author lists of references (REVTeX 4's .bst files would truncate the list if there were more than 10 authors). APS editors prefer full author lists be used for references with 15 or less authors. For longer lists, use the phrase "and others" in place of the authors you want to omit.

I received a fatal error: Warning--I didn't find a database entry for "endnote 1" you've exceeded BibTeX's wizard-defined function space

The REVTeX BibTeX style files are fairly demanding but most up-to-date TeX installations come with a big enough space for BibTeX. Your TeX distrubtion's BibTeX may have have a command line flag or configuration parameter to increase this space.

## Figures

How do I include PostScript figures?

Assuming you are using REVTeX

\usepackage{graphics} (or graphicx)

\begin{figure}
\caption{\label{foo} }
\includegraphics{lyouzqp.prodejce.cz}
\end{figure}

Please see the "Documentation" section of the REVTeX 4 Home Page or any good book on LaTeX2e.

How do I generate a page that shows a list of figures with their captions?

Use the endfloats option and leave out the \includegraphics - this will list all of the figures at the end of the paper. APS no longer requires this so we don't support it particularly well. It is not needed for production or editorial purposes. It is better to have the figures in the text for the referees to see.

Can I place a caption in the second column next to a long, full-column-wide figure?

No, unfortunately the REVTeX layout isn't that sophisticated.

When there are two figures on the same page, the second one doesn't seem to appear.

Please check your log file. You should be receiving error messages; i.e., could not place figure, or something similar. It should not just be ignoring the figure. You can try the floatfix option and see if that helps.

Is there a way to convert .jpg (.jpeg) files to .ps or .eps?

You can convert it to a similarly sized EPS file via a program called 'jpeg2ps.' The jpeg2ps program puts a simple PostScript Level II wrapper around the JPEG. The size shouldn't change at all. (You might try making sure that exporting Level II EPS.)

How do I get the LaTeX compiler to recognize the command \includegraphics?

You need to either use \usepackage{graphics} or \usepackage{graphicx}
Somewhere in your TeX distribution is a file called lyouzqp.prodejce.cz or lyouzqp.prodejce.cz You may want to read it to learn how to resize and reposition your graphics. Alternatively, search at CTAN for "grfguide" to locate a copy of the guide.

## Changes from REVTeX 4

What changes were made with upgrading from REVTeX 4 to REVTeX ?

A complete list of specific differences between REVTeX 4 and REVTeX is given in the REVTeX documentation included in the REVTeX distribution. The file is whatsnewpdf in the doc/latex/revtex/auguide directory.

## Help with REVTeX

How can I get more help with REVTeX ?

## Release of REVTeX (patch level 2)

August 11, A new release of REVTeX has been made public. The following bugs were addressed:

• AIP BibTeX style files properly handle journal article titles.
• Pasting a .bbl file into the main TeX file no longer results in duplicate numbering of references.
• BibTeX style files no longer put in spurious comma after journal name.
• Improved compatibility with non-REVTeX BibTeX style files.
• BibTeX style files no longer warn when both an editor and author are present in an @BOOK entry.
• Review of Modern Physics BibTeX style file now correctly handles muliple references by an author in the same year.
• Fixed linking of DOI when not using pdflatex.
• Fixed listing of videos.
• Improved handling of ISSN and ISBN fields in bibliography entries.
• Fixed citation of a reference with long author lists in AIP author-year styles.
• Fixed punctuation of authors in references.

March 15, Bugs addressed in the first patch level release:

• Using the same \affiliation more than once results in some authors not getting any affiliation at all.
• reftest was left out of the distribution
• For RMP, the \cite command doesn't enclose the citation in parentheses properly.
• For RMP, the .bst files don't properly handle several cases including a book with editors, but no authors

In addition, there were many other improvements including the handling of footnotes, compatibility with packages such as lscape and hyperref, and punctuation in bibliographies. Also, the "long" version of the BibTeX style files have been removed from the distribution. The remaining style files have been enhanced to provide the same functionality when the longbibliography class option is used.

## Introduction to REVTeX 4

REVTeX is a set of macro packages designed to be used with LaTeX2e and is well-suited for preparing manuscripts for submission to the journals of the American Physical Society (APS) and American Institute of Physics (AIP). The changes from REVTeX 4 include bug fixes, improved functionality, and support for a wider range of journals, including those of the American Institute of Physics (AIP). REVTeX was developed jointly by APS, AIP, and Arthur Ogawa. Additional work was done by Patrick Daly to incorporate our suggested improvements into natbib to address many new features concerning bibliographies. natbib a or later is required to run REVTeX

Major changes in REVTeX include:

• Added support for APS journal Physical Review Physics Education Research.
• Added support for AIP journals. There is now an explicit "aip" society option along with support for AIP journals. Please see the Author's Guide to AIP Substyles for REVTeX In addition, REVTeX provides an extensible system for the easy addition of new collections of journals.
• Endnotes now ordered correctly. Endnotes in the bibliography now appear in the correct order, interleaved with citations.
• Multiple references in a single citation supported using a special starred (*) argument to the \cite command. One of the major new features in made possible by the joint work on "natbib ". Multiple BibTeX entries can be combined into a single \bibitem command.
• Free form text can be prepended and appended to a bibliographic entry using the special starred (*) argument to the \cite command. Often a citation in the bibliography will have explanatory text such as See also or and references therein before and after the actual citation. The new REVTeX \cite command allows the specification of both text to precede and follow a citation.
• Structured Abstracts. Use of the "description" environment in abstracts now provides for "structured" abstracts.
• Figures referring to videos now supported. A "figure" may now be labeled as a Video by using the "video" environment. A frame from the video may be included in the figure and a URL to link the caption's label to the online video also may be included. There is also a \listofvideos command.
• Better support for lyouzqp.prodejce.cz in BibTeX Three more BibTeX fields have been added: "SLACcitation", "archivePrefix", and "primaryClass" in addition to the existing field "eprint".

Authors submitting to APS or AIP journals using TeX should use REVTeX Proper use of the commands provided by REVTeX greatly aids the peer-review and the publication process, reducing the chances for the introduction of errors.

## Documentation

The documentation is included in the full REVTeX distribution However, for convenience the documentation is also available from here in PDF format:

The REVTeX may be downloaded directly from here as revtexzip. REVTeX is also available on CTAN.

To install REVTeX , unzip the revtexzip file. This will unpack a README file as well as an additional zip file, lyouzqp.prodejce.cz The README file contains information about how to unpack and install the lyouzqp.prodejce.cz file. Briefly, this zip file contains all of the files in the REVTeX distribution in the standard "TeX Directory Structure" (TDS) layout. Usually the file can be unzipped directly in the local tree of your TeX distribution (for TeX Live, this would be in the texmf-local directory).

## Required Packages

The most common problem encountered when first trying to use REVTeX is missing or outdated packages. REVTeX requires the natbib package (version a or higher), lyouzqp.prodejce.cz, lyouzqp.prodejce.cz, and lyouzqp.prodejce.cz files at the very least. AMS-LaTeX is required as well for certain documentclass optons. Most pacakges are available from CTAN, but you will be better served by installing an up-to-date TeX/LaTeX2e distribution such as TeX Live or MikTeX.

• natbib: This can be downloaded from the contrib/natbib directory on CTAN. Be sure to get version or later (a was released in November , so it is likely you will need to update natbib).
• lyouzqp.prodejce.cz: This can be downloaded from the contrib/url directory on CTAN.
• lyouzqp.prodejce.cz: This can be downloaded from the contrib/textcase directory on CTAN. Note that you need to download lyouzqp.prodejce.cz and lyouzqp.prodejce.cz lyouzqp.prodejce.cz is generated by running latex on the lyouzqp.prodejce.cz file.
• lyouzqp.prodejce.cz: If you are missing lyouzqp.prodejce.cz, you have a very incomplete or outdated LaTeX2e distribution and you should upgrade your distribution.
• AMS-LaTeX: Version or higher is needed. It is available from lyouzqp.prodejce.cz