next up previous contents
Next: Running an older Up: Installing REVTeX 3.1 Previous: Differences between REVTeX

Differences between REVTeX v3.1 and REVTeX v<3.0

 

There are few differences between REVTeX v3.1 and v3.0:

  1. No difference in basic macro functionality.
  2. Support for the same ``tag set''.
  3. Version 3.1 remains .09 compliant.
  4. A new publisher has been added to the program, SEG.
  5. A new APS journal has been added, Reviews of Modern Physics.
  6. New/revised style files have been added to the toolbox.
  7. Documentation has been updated.

Here are the differences between REVTeX v3.1 and versions <3.0.

  1. The \documentstyle is different. The main style is now revtex, and aps is a mandatory style option for APS authors. Other style options are eqsecnum (to number equations by section), preprint (to get double-spaced output for submission purposes), tighten (to get single-spaced output with the preprint option), and amsfonts and amssymb (see below). There are also style options for each APS journal: pra, prb, prc, prd, pre, prl, and rmp for Physical Review A, B, C, D, E, Letters, and Reviews of Modern Physics, respectively. pra is the default. The prb option gives superscript reference citations, as is the style for Physical Review B. Other than this, there are no substantial differences in the journal options. Please do not use the prb option unless you will be submitting to Physical Review B. The prl option yields a slightly different line spacing for accurate PRL length estimates. The floats style option enables LaTeX-style floating figures and tables---it is not for use with files to be submitted to the APS. Similarly the twocolumn style option is for personal use, and not for use in submitted files.

  2. The beginning of a file is different in v3.1. It is more like LaTeX's article style. See Sec. vC and template.aps for details.

  3. The \tightenlines command is now called \tighten. The tighten style option can be used to get a single-spaced preprint.

  4. You can now use the \label{#1} command after \begin{mathletters}. This allows you to reference the general number of the equations in the mathletters environment. For example, if
    \begin{mathletters}
    \label{eq:all} % note location
    \begin{equation}
    E=mc^2,\label{eq:a}
    \end{equation}
    \begin{equation}
    E=mc^2,\label{eq:b}
    \end{equation}
    \begin{equation}
    E=mc^2,\label{eq:c}
    \end{equation}
    \end{mathletters}
    
    gives the output



        



    then Eq.\ (\ref{eq:all}) gives ``Eq. (4)''.

  5. The \nonum command is no longer used. You can get unnumbered section headings by using the ``star form'' of the command; e.g.,
    \section*{Unnumbered section}
    
    This is normal LaTeX practice. Appendix headings used to be set with the \appendix{#1} and \unletteredappendix{#1} commands. The normal LaTeX convention is now used: When you wish to start the appendix(es) use the \appendix command (no argument). Then \section{#1} will give an appendix heading and \section*{#1} gives an unlettered appendix. All numbering, labeling, and cross-referencing remain the same.

  6. Figure captions should be input as in LaTeX. The syntax is exactly the same as in LaTeX; e.g.,
    \begin{figure}
    \caption{Here is the caption.\label{xxx}}
    \end{figure}
    
    Note that the label can be inside the caption or after it, as long as it is inside the figure environment and does not come before the caption.

  7. All the normal LaTeX rules about fragile commands in moving arguments apply. Especially in figure and table captions, where REVTeX users have not had to worry until now. An error of
      ! Argument of \@caption has an extra }
    
    generally indicates that a command in a caption must be preceded by the \protect command. \protect will need to be used much more often, unfortunately. Specifically, \\ and \ref, along with other fragile commands, will need to be protected in section heads and captions.

  8. Equations and eqnarrays center in the column width, instead of appearing indented. The \FL and \FR commands still flush equations left and right, repectively, in the column, but should be needed only occasionally. This mimics the style of how the equations will appear in the journal.

  9. The AMSFonts are supported through the amsfonts and amssymb style options. These work similar on both LaTeX's normal font macros (OFSS) and the so-called NFSS. You do not need to know what the OFSS and NFSS are. (See Sec. vii if you are curious.)

    The amsfonts option will define the \frak and \Bbb commands to switch to the Fraktur and Blackboard Bold fonts, respectively. Fraktur characters will come out bold in a bbox (see below), Blackboard Bold will not. The amsfonts option also adds support for bold math letters and symbols in smaller sizes in galley style and in superscripts when a bbox is used. For example, $^{\bbox{\pi}}$ gives a bold lowercase pi in the superscript position. \bbox{#1} is explained below.

    The amssymb option gives all the capabilities of the amsfonts option, but also defines names for all the extra symbols in the AMSFonts.

    See Sec. vii for font details.

  10. The \bbox{#1} command will give bold output of #1 in math mode. You can use it to get bold greek characters---upper- and lowercase---and other symbols. It is still easier to use \bf to get upright Latin letters in boldface. How much comes out bold and in how many places you get bold output depends on how many fonts you have installed. Using the amsfonts option will automatically enable bold Fraktur in a bbox and will use the extra AMS Computer Modern math and symbol fonts for bold in superscripts and smaller sizes. The following will come out bold in bboxes: normal math italic letters, numbers, Greek letters (uppercase and lowercase), small bracketing and operators, \cal, and \frak. See Sec. viiB.

  11. The \text{#1} command will print #1 as regular text output in math. In particular, you will get hyphens instead of minus signs. Used in a superscript, you will get the correct size. See Sec.\ vG.

  12. When you use the \bf command in superscripts, you will get a correctly sized character.

  13. The / in the \case command is now optional. Either \case{1}/{2} or \case{1}{2} will work. Our hope is that the latter, more usual construct will become the norm.

  14. There are commands \tablenote{#1}, \tablenotetext{#1}, and \tablenotemark{#1}. These commands work in direct analogy to the regular footnoting commands in LaTeX. They should be used only in tables, and the notes will come out at the bottom of the table in which they appear. See apssamp.tex for instructions and examples.

  15. There is a new letter for specifying columns in tabular environments. Using d in a tabular specification will create a column centered on the decimal points of the entries. See Sec. vL for details; see apssamp.tex for examples. \dec and \setdec should not be used.

  16. The symbols were called \alt,\agt in previous versions of REVTeX . These symbols are now called \lesssim and \gtrsim, for compatibility with normal AMSFonts notation.

  17. Extra diacritics are available: \tensor (double-headed overarrow), \overdots (triple overdots), \overstar (star), \overcirc (circle), \loarrow (left-going overarrow), and \roarrow (right-going overarrow). They scale correctly in superscripts. See Appendix A for examples.

  18. There are BIBTeX style files, prsty.bst, rmp.bst, that can be used to prepare bibliographies automatically, as explained in Lamport's book.

  19. There is also a tool for authors that prepare their bibliographies by hand. It is called reftest.tex. It will check to make sure that you (1) have no uncited bibitems, (2) have no undefined citations, and (3) have your bibitems in the same order as your citations. These are all requirements in Physical Review style. This can only work if you use LaTeX's \bibitem and \cite mechanisms. See Sec.\ vJ.

  20. We have intended for REVTeX to be as compatible as possible with LaTeX, including features we (APS) do not require at this time such as \twocolumn, floats, etc. You cannot use these for files that you submit to the APS; they are added for your personal use. Please let us know of any incompatibilities.

  21. You should be able to use either the OFSS or NFSS with these macros, with similar results (the NFSS may give you more fonts in some areas, depending what your setup is). We are only supporting the NFSS with oldlfont.sty active. Please let us know if you have any problems in this area. And don't worry if you don't know what the OFSS and NFSS are. (See Sec. vii if you are curious.)


next up previous contents
Next: Running an older Up: Installing REVTeX 3.1 Previous: Differences between REVTeX




Fri Feb 6 11:29:29 GMT 1998