% \iffalse <A     THIS IS A META-COMMENT
%<*dtx>
\ProvidesFile
%========================================================================
                       {PREPRINT.DTX}
%========================================================================
%</dtx>
%% Copyright 1993-2004 Patrick W Daly
%% Max-Planck-Institut f\"ur Sonnensystemforschung (prev. Aeronomie)
%% Max-Planck-Str. 2
%% D-37191 Katlenburg-Lindau
%% Germany
%% E-mail: daly@mps.mpg.de
%%
%% This program can be redistributed and/or modified under the terms
%% of the LaTeX Project Public License Distributed from CTAN
%% archives in directory macros/latex/base/lppl.txt; either
%% version 1 of the License, or any later version.
%%
%% This is a contributed file to the LaTeX2e system.
%========================================================================
%  There are 2 things that may be done with this file:
%    1. LaTeX it directly to get the coding documentation
%    2. Docstrip it (using batch job PREPRINT.INS) to make files
%          -- prepman.tex   (the users manual, LaTeX2e)
%          -- preprint.sty  (a style file for LaTeX 2.09)
%          -- preprint.cls  (a class file for LaTeX2e)
%          -- preprint.drv  (a driver file to print the documentation)
%                           (not really needed, because of point 1)
%
%  Only parts of the manual are included in the documentation. Those parts
%   that are NOT included are to be found between iffalse .. fi guards.
%
%  Docstrip options:
%    style  :- to produce the main style file preprint.sty for LaTeX 2.09
%    class  :- to produce a class file preprint.cls for LaTeX2e
%    manual :- to produce a .tex file, the users manual.
%    driver :- to extract a docstrip driver file that prints the
%                documentation of this file
%-------------------------------------------------------------------
%<style>\def\ProvidesClass#1#2]
%<style>  {\typeout{Main style `#1'#2]}}
%
%  *** Identify the class file:-
%<class|manual>\NeedsTeXFormat{LaTeX2e}[1994/06/01]
%<class|style>\ProvidesClass{preprint}
%
%  *** Identify the manual file:-
%<manual>\ProvidesFile{prepman.tex}
%
%  *** Identify the driver file:-
%<driver>\NeedsTeXFormat{LaTeX2e}
%<driver>\ProvidesFile{preprint.drv}
%
%  *** The DATE, VERSION, and other INFO
%\fi
%\ProvidesFile{preprint}
           [2011/01/27 7.1 (PWD)]
%\iffalse
%<manual>\def\manualdate{2011/01/27}
%<*style|class>
 %-----------------------------------------------------------
%  Here follows abbreviated usage description for the stripped version
 %
%<style> % Call this main style in place of article.
%<class> % Call this class in place of article.
 % Additional options are:
 %  full     :- to call all the other preprint style packages
 %              fullpage, appendix, balance, figcaps, mpaehead, authblk,
 %                natbib, sublabel
 %  mpae     :- with full, to use mpaehead, for older documents
 %  mps      :- with full, to input mpshead, default
 %  bw       :- with mps, to input mpshead with bw option (no color)
 %  nosecnum :- to suppress section numbering
%<style> %  any of the preprint options listed above if `full' not given
%<class> %  (Any of the above packages can be added with \usepackage
%<class> %   if `full' is not given.)
 %  a4, a4in, a4wide, secnum  are recognized but do nothing
 %  other standard LaTeX options are accepted
 %
%<style> %  Will read in local article.sty and art1n.sty
%<class> %  Will read in local article.cls and size1n.clo
 %--------------------------------------------------------------------
%</style|class>
% A>\fi
% \CheckSum{482}
% \CharacterTable
%  {Upper-case    \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
%   Lower-case    \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
%   Digits        \0\1\2\3\4\5\6\7\8\9
%   Exclamation   \!     Double quote  \"     Hash (number) \#
%   Dollar        \$     Percent       \%     Ampersand     \&
%   Acute accent  \'     Left paren    \(     Right paren   \)
%   Asterisk      \*     Plus          \+     Comma         \,
%   Minus         \-     Point         \.     Solidus       \/
%   Colon         \:     Semicolon     \;     Less than     \<
%   Equals        \=     Greater than  \>     Question mark \?
%   Commercial at \@     Left bracket  \[     Backslash     \\
%   Right bracket \]     Circumflex    \^     Underscore    \_
%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%   Right brace   \}     Tilde         \~}
%
% \iffalse
%<*install>
%^^A =============================================
%^^A    Here is the docstrip installation file
%^^A    It is written on first LaTeX run if it
%^^A    does not already exist
%^^A =============================================
\begin{filecontents}{preprint.ins}
% This file can be redistributed and/or modified under the terms
% of the LaTeX Project Public License Distributed from CTAN
% archives in directory macros/latex/base/lppl.txt; either
% version 1 of the License, or any later version.
%
% It is an installation file for extracting package and driver
% files from the original source file. Simply process it under
% TeX or LaTeX.

\input docstrip

\keepsilent
\askforoverwritefalse

\declarepreamble\manual
=============================================
IMPORTANT NOTICE:
This is a generated file.

It is subject to the same copyright conditions (see below)
as in the original file: \inFileName.
It may not be distributed without \inFileName.

This is the user's manual for the
Preprint collection of Latex packages
written by Patrick W. Daly
=============================================
\endpreamble


\declarepreamble\class
=============================================
IMPORTANT NOTICE:
This is a generated file.

It is subject to the same copyright conditions (see below)
as in the original file: \inFileName.
It may not be distributed without \inFileName.

Full documentation can be obtained by LaTeXing that original file.
Only a few abbreviated comments remain here to describe the usage.
=============================================
\endpreamble
\postamble

<<<<< End of generated file <<<<<<
\endpostamble

\declarepreamble\driver
============================================
This is the driver file to produce the LaTeX documentation
from the original source file \inFileName.

Make changes to it as needed. (Never change the file \inFileName!)
============================================
\endpreamble
\declarepostamble\driverq

End of documentation driver file \noexpand\outFileName.
\endpostamble

\generate{\file{prepman.tex}{\usepreamble\manual\from{preprint.dtx}{manual}}
%          \file{preprint.sty}{\usepreamble\class\from{preprint.dtx}{style}}
          \file{preprint.cls}{\usepreamble\class\from{preprint.dtx}{class}}
% CONSIDER IF YOU REALLY NEED A DRIVER
%          \file{preprint.drv}{\usepreamble\driver
%                              \usepostamble\driverq
%                \from{preprint.dtx}{driver}}
         }

\obeyspaces
\Msg{*******************************************}%
\Msg{* For documentation, process preprint.dtx}%
%\Msg{*    or the driver file      preprint.drv}%
\Msg{* (LaTeX2e only!)                       }%
\Msg{*******************************************}

\endbatchfile
\end{filecontents}
%</install>
%<*driver>
\documentclass{ltxdoc}
%<driver>%\EnableCrossrefs %Comment out when .ind file ready
  \DisableCrossrefs %May stay; zapped by \EnableCrossrefs
%<driver>%\RecordChanges %Comment out when .gls file ready
%<driver>%\CodelineIndex %Comment out when .ind file ready
  \CodelineNumbered %May stay
%<driver>%\OnlyDescription
\begin{document}
   \DocInput{preprint.dtx}
\end{document}
%</driver>
% \fi
%
% \DoNotIndex{\documentstyle,\WideMargins,\EnableCrossrefs,\DisableCrossrefs}
% \DoNotIndex{\RecordChanges,\CodelineIndex,\OnlyDescription,\setcounter}
% \DoNotIndex{\begin,\DocInput,\end}
% \DoNotIndex{\@@input,\@arabic,\@dblfloat,\@evenfoot,\@evenhead,\@float}
% \DoNotIndex{\@gobbletwo,\@ifundefined,\@mkboth,\@mparswitchtrue,\@namedef}
% \DoNotIndex{\@ne,\@oddfoot,\@oddhead,\@startsection,\@starttoc,\@tempboxa}
% \DoNotIndex{\@tempdima,\advance,\alph,\baselineskip,\bf,\box,\centering}
% \DoNotIndex{\def,\else,\end@dblfloat,\end@float,\evensidemargin,\fi}
% \DoNotIndex{\figurename,\filedate,\filename,\fileversion,\flushbottom}
% \DoNotIndex{\hbox,\hfil,\hsize,\hskip,\ifcase,\ifdim,\ifnum,\input}
% \DoNotIndex{\l@figure,\large,\leftmargini,\leftmarginv,\leftmarginvi}
% \DoNotIndex{\leftmark,\let,\long,\marginparwidth,\markboth,\markright}
% \DoNotIndex{\newcounter,\newif,\normalsize,\oddsidemargin,\or,\pagestyle}
% \DoNotIndex{\par,\parindent,\relax,\rightmark,\rm,\sc,\sectionmark,\setbox}
% \DoNotIndex{\sl,\sloppy,\small,\space,\subsectionmark,\tablename}
% \DoNotIndex{\textheight,\textwidth,\thefigure,\thepage,\thesection}
% \DoNotIndex{\thesubsection,\thetable,\topmargin,\topskip,\typeout}
% \DoNotIndex{\uppercase,\vskip,\wd,\z@,\baselinestretch,\c@secnumdepth}
% \DoNotIndex{\raggedbottom,\flushbottom}
% \DoNotIndex{\addtolength,\CodelineNumbered,\CurrentOption,\DeclareOption}
% \DoNotIndex{\documentclass,\ExecuteOptions,\if@titlepage,\if@twocolumn}
% \DoNotIndex{\if@twoside,\listofplates,\listplatename,\LoadClass}
% \DoNotIndex{\NeedsTeXFormat,\PassOptionsToClass,\PrintChanges,\PrintIndex}
% \DoNotIndex{\ProcessOptions,\ProvidesClass,\RequirePackage,\usepackage}
% \DoNotIndex{\@ptsize,\@titlepagetrue,\@twocolumnfalse,\@twocolumntrue}
% \DoNotIndex{\@twosidetrue,\ProvidesFile}
%
% \setcounter{IndexColumns}{2}
% \setlength{\IndexMin}{10cm}
% \setcounter{StandardModuleDepth}{1}
%
% \iffalse
%  When read in directly, only the driver lines should be seen
%   so all uncommented lines are protected by following iffalse
%  When read by \DocInput, % is ignored; put %fi... %iffalse for
%   those lines that are to be seen by \DocInput
%  To ensure that the outer iffalse fi pair are not included by
%   docstrip, put the in <a&!a> guard, which is always false.
%  To help keep track of the pairs, they are marked with < > brackets
%<*a&!a>
% \fi
\iffalse <B
% \iffalse
%</a&!a>
%<*manual>
% \fi
\documentclass[nosecnum,11pt]{preprint}
\usepackage{mpshead}
% \iffalse
%</manual>
% \fi
%
% C> \fi ^^A Start of \DocInput input
%        ^^A This fi cancels the B class iffalse, only in \DocInput mode
% \changes{5.0}{1993 Oct 27}{First \texttt{docstrip} version}
% \changes{6.0}{1994 May 22}{Convert to \LaTeX2e}
% \changes{6.1}{1994 Jun 22}{Update to first official release of \LaTeXe}
% \changes{6.2}{1995 Jan 08}{Center headlines with \texttt{headings}}
% \changes{6.2}{1995 Jan 08}{Update documentation to PWD standard}
% \changes{6.2a}{1996 Mar 08}{Fix paper size for compatibility mode}
% \changes{6.2a}{1997 Feb 05}{Change manual for \texttt{natbib} changes}
% \changes{6.2a}{1997 Aug 28}{Change manual to include \texttt{authblk}}
% \changes{6.3}{1998 Jul 16}{Add \texttt{ms} option}
% \changes{6.3}{1998 Jul 16}{Change manual to update graphics inclusion}
% \changes{6.3a}{1998 Sep 14}{Read \texttt{figcaps} with \texttt{full} option}
% \changes{6.4}{1999 Feb 23}{Update copyright notice}
% \changes{7.0}{2004 Jul 6}{Add \texttt{mpshead} in place of \texttt{mpaehead}}
% \changes{7.1}{2011 Jan 27}{Make MPS head the default, add \texttt{mpae} option}
% \changes{7.1}{2011 Jan 27}{Remove \texttt{natbib} descriptions}
%
% \GetFileInfo{preprint}
%
%^^A Title for documentation article
% \title{\bfseries The Preprint Document Class}
%
% \author{Patrick W. Daly}
%
% \date{This paper describes class \texttt{\filename}\\
%       version \fileversion{} from \filedate
%  }
%
% \pagestyle{myheadings}
% \markboth{P. W. Daly}{THE PREPRINT DOCUMENT CLASS}
%
%^^A In order to keep all marginal notes on the one (left) side:
%^^A (otherwise they switch sides disasterously with twoside option)
% \makeatletter \@mparswitchfalse \makeatother
%
% \maketitle
%
% \section{Introduction}
% This is an abstract from the user's manual for the \texttt{preprint}
% collection of packages, describing only the main class and its coding.
%
% The master file \texttt{\filename.dtx}
% may be \texttt{docstrip}ped with the following options:
% \begin{description}
% \item[\ttfamily manual] to extract the user's manual (as
%     \texttt{prepman.tex}) for distribution;
%
% \item[\ttfamily style] to extract the style file \texttt{preprint.sty}
%     for use with the obsolete \LaTeX~2.09 only;
%
% \item[\ttfamily class] to extract the class file \texttt{preprint.cls}
%     for use with \LaTeXe;
%
% \item[\ttfamily driver] to extract the documentation driver file
%     \texttt{preprint.tex} that inputs \texttt{preprint.dtx} to print out
%     the coding documentation.
%
% \end{description}
% The source file \texttt{\filename.dtx} is itself a driver file and can
% be processed directly by \LaTeX.
%
% \section{Additional Packages in the Collection}
% This file contains only some basic modifications to the \texttt{article}
% class, to change the sectioning and page layout. The extra features that are
% part of the \texttt{preprint} collection must be added as packages with
% |\usepackage|; alternatively, the option \texttt{full} adds all of them.
% Any options that the individual packages might have may be added as an option
% to |\documentclass|.
%
%\iffalse <C % Here begins text for the user's manual (not documentation)
%<*manual>
\pagestyle{myheadings}
\markright{P. W. Daly: The \texttt{preprint} Collection of Packages}

\begin{document}
\title{\bfseries The \texttt{preprint} Collection of \LaTeX{} Packages}
\author{Patrick W. Daly}
\date{\manualdate}
\maketitle

\begin{abstract}
A number of \LaTeX{} packages have been developed to adapt the
\texttt{article} class more to the formats generally used in this house. They
may be called individually, or all together as a \emph{document class} named
\texttt{preprint}.
\end{abstract}

\section{Overview}

I have developed a \LaTeX{} document class for use in the \textsl{Max-Planck-Institut
f\"ur Sonnen\-sys\-tem\-for\-schung} (previously \textsl{Aeronomie}),
conforming more to the geophysical standards that we normally
use in comparison to the \LaTeX{} standard \texttt{article} class. It may be
called by replacing \texttt{article} with \texttt{preprint} in the
\verb!\documentclass! command:
\begin{quote}
\verb!\documentclass[!{\em \dots options\dots}\verb!]{preprint}!
\end{quote}

This class changes the sectioning and layout formats of the standard
\texttt{article} class. A number of other packages belonging to my
\texttt{preprint} collection may also be invoked. With the option
\texttt{full}, all of them will be loaded automatically.

These constituent packages are:
%  End of manual-only text C> \fi

\begin{description}
\item[\ttfamily fullpage] to set the page margins such
  that there is one inch on all four sides.

\item[\ttfamily mpaehead] (obsolete) to put a MPAe heading and logo on the
  first page of the article; now replaced by \texttt{mpshead}.

\item[\ttfamily mpshead] to put an MPS heading and logo on the first page of
  the article;  for MPS reports, the report number may be added as part
  of the title information.

\item[\ttfamily authblk] to allow author/affiliation blocks or affiliation
  by footnote; is loaded automatically with \texttt{mpshead}.

\item[\ttfamily appendix] to make the equations, figures, and tables be
  numbered within appendices.

\item[\ttfamily balance] to balance the two columns on the last page when
  \texttt{twocolumn} has been selected.

\item[\ttfamily sublabel] allows selected elements to be sub-numbered, such as
  equations in the sequence 4, 5a, 5b, 6, \dots. Figures and tables may also
  be so numbered.

\item[\ttfamily figcaps] puts the list of figure captions at the end
  automatically, along with all the tables from the article; the
  \texttt{figure} and \texttt{table} environments appear in the source
  text where they are first referred to, but the figure captions and the
  tables appear at the end; optionally, the figures themselves appear at
  the very end. Why do it this way? It is how a manuscript is normally
  prepared for submission. Then, by turning off this option, a preprint
  may be produced with the figures and tables in the text where they
  belong, without making any other change to the source text.

\item[\ttfamily natbib] was originally developed as part of this collection,
  but has become a \LaTeX\ standard and so is described elsewhere. It is
  loaded automatically. It extends the bibliographic citations, in
  particular, allows for author-year citations, unlike the standard numerical
  ones.

\end{description}
% The description and documentation for these are to be found in separate
% files.
All of the above may be used with other main classes, like the standard
\texttt{article}, either together or singly. (However, \texttt{figcaps} must
be called after \texttt{appendix} and \texttt{sublabel}.)

A number of other options exist that may be used only with the
\texttt{preprint} class.

\begin{description}
\item[\ttfamily full] loads all of the above packages.

\item[\ttfamily mpae] used with \texttt{full} to load \texttt{mpaehead} in
  place of the default \texttt{mpshead}, kept to make old documents
  compatible with their original appearance.

\item[\ttfamily mps] used with \texttt{full} to load \texttt{mpshead}; not
  really needed since this is the default.

\item[\ttfamily bw] is passed on to \texttt{mpshead} to produce black \&
  white logo and institute name instead of default coloured.

\item[\ttfamily ms] makes a manuscript by adding a title page, double
  spacing, and activates the figure captions list, by reading in
  \texttt{figcaps} even if \texttt{full} has not been issued.

\item[\ttfamily draft] is the same as \texttt{ms}, but this conflicts with
  the \texttt{graphicx} package; kept for compatibility.

\item[\ttfamily nosecnum] suppresses section numbering.

\end{description}
The following options are provided for consistency with other packages but
really do not do anything.
\begin{description}
\item[\tt a4] is superfluous since the layout is designed for A4 paper.

\item[\tt a4in] is equally superfluous.

\item[\tt secnum] is the opposite of \texttt{nosecnum}, but is the default
  anyway.
\end{description}
The regular \LaTeX{} options \texttt{twoside}, \texttt{twocolumn}, and {\tt
titlepage} may also be given.

%\iffalse <C  Begin manual-only text
\section{Implementing the Packages}
Any document that has been prepared for the \LaTeX{} \texttt{article}
class may add them with the \verb!\usepackage! command, e.g.:
\begin{quote}
\verb!\documentclass{article}!\\
\verb!\usepackage{mpshead,appendix}!
\end{quote}
Any number of packages may be included, in any order, except that
\texttt{sublabel} and \texttt{appendix} must come before \texttt{figcaps}.

\section{Implementing the Whole Preprint Package}
Alternatively, the complete preprint format may be invoked with
\begin{quote}
\verb!\documentclass[full,!{\em \dots options\dots}\verb!]{preprint}!
  \quad for a preprint, or\\
\verb!\documentclass[ms,full,!{\em \dots
   options\dots}\verb!]{preprint}!\quad for a manuscript.
\end{quote}

This not only loads most of all the packages, but also changes the sectioning
and layout formats, as well as the form of running headlines and some other
things. Naturally, the normal \LaTeX{} options such as {\tt 11pt}, {\tt 12pt},
\texttt{titlepage}, etc.\ may also be included.

Some of the packages are only loaded in conjunction with some others. For
example:
\begin{quote}
\texttt{balance} only makes sense when the standard option \texttt{twocolumn}
has also been given, so it is only read in with \texttt{twocolumn};

\texttt{figcaps} is appropriate only for a manuscript, which is indicated with
the option \texttt{ms}; by leaving off the \texttt{ms} option, a
preprint is produced instead of a manuscript.

\end{quote}
\section{How to Use the Extra Features}
Some of these features, such as \texttt{appendix}, work automatically without
any extra interaction from the user, while others, such as \texttt{sublabel},
only enable new commands that the user must know how to employ. These new
commands are listed here organized according to the package that defines them.

\subsection{Extra \texttt{preprint} Features}
% End of manual-only text C> \fi
%\section{Changes in Layout}
% The \texttt{preprint} class is an \texttt{article}-like class, meaning it
% has no |\chapter| commands. In fact, it reads in the local
% \texttt{article.cls} and then makes some changes to the layout. These
% are:
% \begin{itemize}
% \item
%    Section titles are centered, bold, with a smaller font than with
%    \texttt{article}; other sectioning titles are flush left, using
%    slanted rather than bold.
%
% \item
%    A \texttt{plate} environment is added analogous to \texttt{figure}
%    (this is for compatibility with AGU publications).
%
% \item
%    The form of figure captions is changed slightly, to be
%    `\textbf{Figure~3.}' rather than `Figure~3:'
%
% \item
%    The running heads use small caps instead of italic font.
%
% \item
%    The page layout is for A4 paper, with a 2.5~cm border on all 4 sides.
%
% \end{itemize}
%
% Some extra commands that are available under \texttt{preprint} are:

\begin{description}
\item
% \DescribeMacro{\iftwocol}
   \verb!\iftwocol{!{\em yes\/}\verb!}{!{\em no\/}\verb!}!
   allows one to enter alternative text depending on whether \texttt{twocolumn}
   has been selected or not. This is sometimes necessary with formulas that do
   not fit into the narrow column of a two-column page. The {\em yes\/} text
   is entered if \texttt{twocolumn} is active, otherwise the {\em no\/} text is
   included.

\item
% \DescribeEnv{plate}
   \verb!\begin{plate}...\end{plate}! is an environment that functions exactly
   the same as \texttt{figure}, but with independent numbering. A starred
   version also exists for double-column plates in \texttt{twocolumn} mode.
   This environment has been added because JGR wants coloured figures to be
   labelled as ``plates'' instead of ``figures''.

\item
% \DescribeMacro{\listofplates}
   \verb!\listofplates! is analogous to \verb!\listoffigures! for printing
   out the list of plates.

\end{description}
% \iffalse <C Begin manual-only text
\subsection{Extra \texttt{fullpage} Features}
This package can only be used in conjunction with a page size
specification in the \verb!\documentclass! command, such as \texttt{a4paper},
which is given automatically by the \texttt{preprint} class. See the list of
loading options below for additional features.

\subsection{Extra \texttt{mpshead} Features}
\begin{description}
\item \verb!\reportno{!{\em mps report number\/}\verb!}!
   allows one to enter an internal report identification number that is then
   printed at the top of the first page; Fr.\ Steinmetz distributes these numbers.
   If this command is missing, then no number is printed.

\end{description}

\subsection{Extra \texttt{authblk} Features}
(This package is loaded automatically with \texttt{mpshead}. It may be
loaded independently, without that package.)

In standard \LaTeX, one enters authors and affiliations with a single
\verb!\author{..\and..\and..}! command, as
\begin{quote}\begin{verbatim}
\author{J. B. Smith\\Institute for Research
  \and
        F. G. James and K. Baldwin\\NASA}
\end{verbatim}
\end{quote}
This produces
\begin{center}
  \textsc{\large J. B. Smith}\\
  \textit{Institute for Research}\\[1ex]
  \textsc{F. G. James and K. Baldwin}\\
  \textit{NASA}
\end{center}

With this package, one can additionally enter them as
\begin{quote}\begin{verbatim}
\author{J. B. Smith} \affil{Institute for Research}
\author{F. G. James} \author{K. Baldwin} \affil{NASA}
\end{verbatim}
\end{quote}
For one or two affiliations, this produces the same result as the first
example, but for more, a footnote style is automatically generated.
This would look like
\begin{center}
\textsc{\large
J. B. Smith\textsuperscript{1}, F. G. James\textsuperscript{2}, and
  K. Baldwin\textsuperscript{2}}\\[1ex]
\textsuperscript{1}\textit{Insitute of Research}\\
\textsuperscript{2}\textit{NASA}
\end{center}
(This is only illustrative; it really takes three or more affiliations
to produce this style.)

Furthermore, each of the \verb!\author! and \verb!\affil! commands may be given
an explicit footnote marker, as an optional argument. This is useful to force
footnotes even for two affiliations, and if the authors are not ordered by
affiliation.
\begin{quote}\begin{verbatim}
\author[1]{K. Baldwin}
\author[2]{J. B. Smith}
\author[1]{F. G. James}
\affil[1]{NASA}
\affil[2]{Institute for Research}
\end{verbatim}
\end{quote}
produces
\begin{center}
\textsc{\large
  K. Baldwin\textsuperscript{1}, J. B. Smith\textsuperscript{2}, and
  F. G. James\textsuperscript{1}}\\[1ex]
\textsuperscript{1}\textit{NASA}\\
\textsuperscript{2}\textit{Insitute of Research}
\end{center}

\subsection{Extra \texttt{appendix} Features}
None.

\subsection{Extra \texttt{balance} Features}
\begin{description}
\item \verb!\balance! turns the column-balancing feature on. It is advisable
to print out the two-column document first without balancing; then add
\verb!\balance! somewhere within the text of the first column. After the next
processing, the two columns will be (nearly) the same length. Theoretically,
one could activate \verb!\balance! earlier, but my experience is that
sometimes extra lines of text are written below figures and tables. My
balancing act is not perfect, so use it only where it is needed.

\item \verb!\nobalance! turns off balancing if it was already on.

\end{description}

\subsection{Extra \texttt{sublabel} Features}
\begin{description}
\item \verb!\sublabon{!{\em counter\/}\verb!}...\sublaboff{!{\em counter\/
  }\verb!}!
  turn sublabelling on and off for the specified counter. Any existing counter
  name may be given, but the most meaningful ones are \texttt{equation},
  \texttt{table}, \texttt{figure}, and \texttt{plate}. Sublabelling means that
  the main counter stays unchanged and a suffix is added to it, usually a
  lowercase letter.  Equations may then have a sequence of 4, 5{\it a}, 5{\it
  b}, 6,\dots. These commands function {\em globally}, i.e., they are not
  affected by the range of other environments.

  If \verb!\sublabon! is issued again while sublabelling of that counter is
  still active, then the main counter is incremented and the sub-counter
  reset. Thus
  \begin{quote}
  \verb!\sublabon{x} ... \sublabon{x} ... \sublaboff{x} !
  \end{quote}
  is the same as
  \begin{quote}
  \verb!\sublabon{x} ... \sublaboff{x}\sublabon{x} ... \sublaboff{x} !
  \end{quote}

\item \verb!\substyle! determines the form of the sublabels. The default
  within \texttt{sublabel.sty} is lowercase italic letters, as shown above.
  However, this may be changed by redefining \verb!\substyle!. The
  \texttt{preprint} style contains such a redefinition, and makes the above
  sequence to be 4, 5-a, 5-b, 6,\dots. This is done with
  \begin{quote}
  \verb!\renewcommand{\substyle}[1]{-\alph{#1}}!
  \end{quote}
  The user may make similar redefinitions if he wishes.

\end{description}

\subsection{Extra \texttt{figcaps} Features}
When \texttt{figcaps} has been invoked, either explicitly
or under \texttt{preprint} with the option \texttt{ms},
then the figures, tables, and plates are not printed where they have been
entered in the source text, but are collected throughout the whole paper and
printed at the end. This is the usual place for them in a manuscript. However,
by changing the options in the \verb!\documentclass!
command to produce a preprint in one or two columns, they will appear in the
text as they should, without the user having to move them about.

Actually, only the figure and plate captions are listed at the end, along with
the tables. There is an option to allow the figures and plates to be output as
well, but this only makes sense if the \texttt{figure} and \texttt{plate}
environments contain something that \LaTeX{} can print.

Often figures are produced outside of \LaTeX{} and are simply added to the
manuscript by hand. Or, space is left in the text where they are later glued
in. In this case, one should reserve the space with a \verb!\vspace! command.
For example,
\begin{quote}\begin{verbatim}
\begin{figure}
  \vspace{5cm}
  \caption{....}
\end{figure}
\end{verbatim}
\end{quote}
For a manuscript, the \verb!\vspace! command is simply ignored, but when a
preprint is printed, a blank space 5~cm high will be reserved for the figure.

Alternatively, figures may be produced with \LaTeX{} in \texttt{picture}
environment, or may be imported as encapsulated PostScript files. As an
example of the latter, suppose the figure is stored in a (PostScript) file
named \texttt{myfig.eps}. It is imported with
\begin{quote}\begin{verbatim}
\begin{figure}
 \includegraphics[height=5cm]{myfig.eps}
  \caption{...}
\end{figure}
\end{verbatim}
\end{quote}
(This requires the package \texttt{graphicx} to have been loaded with
\verb!\usepackage!.) In this case, the figure is imported into
the preprint, but only the figure caption is listed in the manuscript.

The special command \verb!\printfigures! given {\em before\/}
\verb!\begin{document}! will cause the figures (and plates) to be output even
for manuscripts, at the very end of the document.

\subsection{Extra \texttt{natbib} Features}
This section has been removed, since \texttt{natbib} is no longer part of
this collection, but is a standard \LaTeX\ contributed package.

% One of the reasons that {\sc Bib}\TeX{} is not so popular in this Institute is
% that it produces numerical literature citations instead of the author-year
% system that we normally use. I have written bibliographic style files for the
% following journals to get around this problem:
% \begin{center}\begin{tabular}{ll}
%   Name of style & For publications in:\\\hline
%   \texttt{agu} & JGR, GRL \\
%   \texttt{aa}   & Astronomy and Astrophysics\\
%   \texttt{anngeo} & Annales Geophysic\ae\\
%   \texttt{pass} & Planetary and Space Science \\
%   \texttt{nlinproc} & Nonlinear Processes in Geophysics \\
%   \texttt{cospar} & Advances in Space Research \\
%   \texttt{esa}  & ESA \\
%   \texttt{nature} & Nature
% \end{tabular}\end{center}
% Only the first five of these are of the author-year style, the rest being
% numerical. These names may be used are arguments to the
% \verb!\bibliographystyle! command to specify the desired style.
%
% However, the style files alone do not solve the author-year problem. There are
% two ways to refer to a paper in this style,
% \begin{quote}
%  \dots as has been shown by Smith {\it et al.} [1992] \dots \\
%  \dots it has been shown [Smith {\it et al.}, 1992] that \dots
% \end{quote}
%
% My \texttt{natbib} package allows both of these forms to be generated with the
% \verb!\citet! and \verb!\citep! commands. Let us suppose that the above
% reference exists in some {\sc Bib}\TeX{} database named \texttt{mylit.bib}
% with the key \texttt{smith92}.  Then the above two statements may be produced,
% in AGU style, with
% \begin{quote}
% \begin{verbatim}
% ... as has been shown by \citet{smith92} ...
% ... it has been shown \citep{smith92} that ...
% . . . . . . . . .
% \bibliographystyle{agu}
% \bibliography{mylit}
% \end{verbatim}
% \end{quote}
% An optional argument may be given in
% square brackets for text that is printed {\em after\/}
% the reference, such as \texttt{page~22} or \texttt{chap.~2}, as in standard
% \LaTeX.  A second set of square brackets may be given with text, in which case
% the first text comes \emph{before}, the second \emph{after} the citation. This
% is my invention, and is not standard \LaTeX.
%
\section{Loading Options}
Under \LaTeXe, packages may have their own options which are
included in the \verb!\usepackage! command, as
\begin{quote}
\verb!\usepackage[!\emph{options}\verb!]{!\emph{package}\verb!}!
\end{quote}
If the \texttt{full} option is given for \texttt{preprint}, then it is not
necessary to load the other packages with \verb!\usepackage!.
In any event, with or without \texttt{full}, any of the package options may
then be added to the class options in the \verb!\documentclass! line.

\subsection{Options for \texttt{fullpage}}
\begin{description}
\item[\ttfamily in] (default) sets a one~inch margin all around the text and
   headings and footers;

\item[\ttfamily cm] sets a margin of 1.5~cm all around;

\item[\ttfamily plain] (default) sets \verb!\pagestyle{plain}! and removes the
   space reserved for the headings;

\item[\ttfamily empty, headings, myheadings] set corresponding page styles
   and take them into account when fixing the margins.

\end{description}
This package requires that the correct paper
specification (e.g., \texttt{a4paper}) be given in \verb!\documentclass!.
The \texttt{preprint} class automatically selects \texttt{a4paper} and loads
\texttt{fullpage} with options \texttt{cm, myheadings}.

\subsection{Options for \texttt{mpshead}}
\begin{description}
\item[\ttfamily color] (default) outputs logo and institute name in colour;
\item[\ttfamily colour] same as \texttt{color};
\item[\ttfamily bw] outputs logo and name in black \& white;
\item[\ttfamily sw] same as \texttt{bw}.
\end{description}

\subsection{Options for \texttt{authblk}}
 \begin{description}
 \item[\ttfamily blocks]
   automatic selection will always be author/affiliation blocks;

 \item[\ttfamily noblocks]
   automatic selection will always be footnote mode;

 \item[\ttfamily max$n$] ($n=2,6$) there are $n$ affiliations before switching
    to footnote style

 \item[\ttfamily auth-sc] sets author font to small caps;

 \item[\ttfamily auth-sc-lg] sets author font to small caps, but with size
     \verb|\large|;

 \item[\ttfamily auth-lg] sets author font to normal, but in size
      \verb|\large|;

 \item[\ttfamily affil-sl] sets affiliation font to slanted;

 \item[\ttfamily affil-it] sets affiliation font to italic;

 \item[\ttfamily german] changes `and' to `und' in author lists.
 \end{description}

\subsection{Options for \texttt{appendix}}
\begin{description}
\item[\ttfamily mylang] (default) keeps the current value for the word
    `Appendix';

\item[\ttfamily english, american] sets `Appendix' unconditionally to English;

\item[\ttfamily german, austrian, french, esperanto] translates to
   the given language;

\item[\ttfamily blank] suppresses the printing of the appendix title with the
  \verb|\appendix| command.

\end{description}

\subsection{Options for \texttt{balance}}
None.

\subsection{Options for \texttt{sublabel}}
\begin{description}
\item[\ttfamily italic] to have subnumbers as italic lowercase letters
      (default);
\item[\ttfamily roman] to have the subnumbers as Roman lowercase letters, as
      4{\rmfamily a}.
\end{description}
(Actually, \texttt{preprint} itself overwrites these definitions, so these
options are ineffectual.)

\subsection{Options for \texttt{figcaps}}
The same language options as for \texttt{appendix}, plus
\begin{description}
\item[\ttfamily figon] (default) activates the whole procedure of moving
    figures and tables to the back of the article, (same as
    \verb|\figcapson|);

\item[\ttfamily figoff] deactivates the whole procedure, (same as
    \verb|\figcapsoff|);

\item[\ttfamily printfigures] allows the figures themselves and not just
    their captions to be output at the very end, in addition to the
    caption page, (same as \verb|\printfigures|); by default this is not done;

\item[\ttfamily figmark] enables marking of figure and table environments
    in the text with marginal notes; (same as \verb|\figmarkon|);

\end{description}
(Again, \texttt{preprint} sets many of these itself.)

\subsection{Options for \texttt{natbib}}
\begin{description}
\item[\ttfamily round] (default) for round parentheses;
\item[\ttfamily square] for square brackets;
\item[\ttfamily colon] (default) to separate multiple citations with
     colons;
\item[\ttfamily comma] to use commas as separaters;
\item[\ttfamily authoryear] (default) for author-year citations;
\item[\ttfamily numbers] for numerical citations;
\item[\ttfamily super] for superscripted numerical citations, as in
     \textsl{Nature};
\item[\ttfamily nobibstyle] to ignore punctuation style specified by
     \verb|\bibliographystyle|.
\end{description}

\section{Summary of Extra Commands}

This is an alphabetically-ordered quick-reference of the extra or modified
commands mentioned above.

\begin{description}
\item \verb!\author[!\emph{mark}\verb!]{!\emph{author\_name}\verb!}!
   enters the name of a single author, with optional footnote marker
   \emph{mark}. Must be given for each author separately.

\item \verb!\affil[!\emph{mark}\verb!]{!\emph{affiliation\_text}\verb!}!
   enters text for the affiliation of the previous \verb!\author!(s),
   with optional footnote marker \emph{mark}. Must be given once for each
   affiliation.

\item \verb!\balance!
  turns on the column balancing when \texttt{twocolumn} has been selected.

\item \verb!\begin{plate}...\end{plate}!
  is an environment exactly like \texttt{figure} meant for coloured plates.

\item \verb!\bibliographystyle{!{\em style\/}\verb!}!
  may take on arguments \texttt{agu}, \texttt{anngeo}, \texttt{pass},
  \texttt{cospar}, \texttt{esa}, \texttt{nature}, as well as the standard
  \texttt{plain}.

\item \verb!\citet{!{\em ref\_key}\verb!}!
  prints the reference as author~[year] for \texttt{agu} style, or
  author~(year) for \texttt{pass}, \texttt{anngeo}, \texttt{nlinproc}, or
  \texttt{aa} styles, otherwise it prints a running number formatted as for
  the selected journal.

\item \verb!\citep{!{\em ref\_key}\verb!}!
  prints the reference as [author, year] for \texttt{agu} style, or (author,
  year) for \texttt{pass}, \texttt{anngeo}, \texttt{nlinproc}, or \texttt{aa}
  styles, otherwise it prints a running number formatted as for the selected
  journal.

\item \verb!\citep[!{\em post}\verb!]{!{\em ref\_key}\verb!}!
  prints the reference as [author, year, {\em post}] or (author, year, {\em
  post}), i.e., with a note after the reference, as in standard \LaTeX.

\item \verb!\citep[!{\em pre}\verb!][!{\em post}\verb!]{!{\em ref\_key}\verb!}!
  prints the reference as [{\em pre} author, year, {\em post}] or ({\em pre}
  author, year, {\em post}), i.e., with notes before and after the reference;
  this is non-standard \LaTeX.

\item \verb!\citeauthor{!{\em ref\_key}\verb!}!
  prints the authors of given reference, without the year.

\item \verb!\citeyear{!{\em ref\_key}\verb!}!
  prints the year of given reference, without the authors.

\item \verb!\iftwocol{!{\em yes\/}\verb!}{!{\em no\/}\verb!}!
  includes text {\em yes\/} if \texttt{twocolumn} has been selected, otherwise
  text {\em no}.

\item \verb!\figcapsoff!
  de-activates the macros that put the figure captions and tables at the end
  of the article, so that the environments work as normal.

\item \verb!\figcapson!
  activates the macros to put the figure captions and tables at the end
  of the article.

\item \verb!\figmarkoff!
  suppresses the appearance of marginal notes where figure, table plate
  should come.

\item \verb!\figmarkon!
  allows marginal notes to appear where the figure, table, plate should apper
  in the text.

\item \verb!\listofplates!
  prints a list of plates, analogous to \verb!\listoffigures!.

\item \verb!\nobalance!
  de-activates column balancing.

\item \verb!\printfigures!
  (only in the preamble, before \verb!\begin{document}!) will add the actual
  figures and plates at the end of a manuscript; otherwise, only the captions
  are listed at the end.

\item \verb!\reportno{!{\em mpae report number\/}\verb!}!
  includes an MPAe/MPS report number at the top of the first page.

\item \verb!\sublabon{!{\em counter\/}\verb!}...\sublaboff{!{\em counter\/%
  }\verb!}!
  causes {\em counter\/} to be sublabelled.

\item \verb!\substyle!
  may be redefined to change the style of the sublabels.

\end{description}

\end{document}
% \iffalse
%</manual>
%  Here is the end of the iffalse fi section to cause skipping up to
%    the driver code.
%<*a&!a>
% \fi
B> \fi
% \iffalse
%</a&!a>
% \fi
%
% \StopEventually{\PrintIndex\PrintChanges}
%
% \section{The Coding}
% This section presents and explains the actual coding of the macros.
% It is nested between |%<*class>| and |%</class>|, which
% are indicators to \texttt{docstrip} that this coding belongs to the class
% file.
%
% An inferior version of this coding is provided for running as a main
% style file under \LaTeX~2.09. Code lines belonging to this are
% indicated with guard |<style>|.
%
% The main task of the class is to input \texttt{article}, to
% modify many of its specifications, and to define a number of new
% commands.  The other \texttt{preprint} modules that may be included are
% documented separately.
%
% \subsection{The Options}
% This is to be a main style/class, not an option or package. In reality,
% it uses most of the \texttt{article} style/class, so what we do is to read
% in \texttt{article.sty} or \texttt{article.cls}. However, we want some extra
% options and want to redefine some of the existing options.  For \LaTeXe,
% this is trivial, but for 2.09, we have to call |\@options| ourselves and
% then deactivate the command.  We therefore describe the 2.09 coding
% first.
%
% \begin{macro}{\if@draft}
% \begin{macro}{\if@secnum}
% \begin{macro}{\if@full}
% But first some common flags are defined that are needed for option
% handling in both versions.
%    \begin{macrocode}
%<*style|class>
\newif\if@draft \@draftfalse
\newif\if@secnum \@secnumtrue
\newif\if@full \@fullfalse
%    \end{macrocode}
% \end{macro}\end{macro}\end{macro}
%
% \subsubsection*{Font Size}
% Define option commands |\ds@11pt| and |\ds@12pt| as in \texttt{article}, except
% that |\@ptsz| is set instead of |\@ptsize|. We cannot use |\@ptsize| because
% \texttt{article} will set it to default of {\tt0} before we get to use it.
%
%    \begin{macrocode}
%<*style>
\def\@ptsz{0}
\@namedef{ds@11pt}{\def\@ptsz{1}}
\@namedef{ds@12pt}{\def\@ptsz{2}}
%    \end{macrocode}
%
% \subsubsection*{Manuscript}
% The \texttt{ms} (previously \texttt{draft}) option will be used to produce a
% manuscript instead of camera-ready copy. This option sets a flag accordingly.
%    \begin{macrocode}
\def\ds@ms{\@drafttrue}
\def\ds@draft{\@drafttrue}
%</style>
%<class>\DeclareOption{ms}{\@drafttrue}
%<class>\DeclareOption{draft}{\@drafttrue}
%    \end{macrocode}
%
% \subsubsection*{Standard and Null Options}
% We have to handle the options \texttt{twoside}, \texttt{twocolumn},
% and \texttt{titlepage} as in \texttt{article}. (Since the |\if@titlepage|
% flag is set to \meta{false} in \texttt{article}, a different flag must be
% used here. The other flags are not set there and may be used directly.)
% Options \texttt{a4}, \texttt{a4in}, \texttt{a4wide},
% and \texttt{secnum} are provided for consistency with other styles but do
% nothing.  Actually, \texttt{a4} normally reads in a file \texttt{a4.sty},
% which we do not want here.
%
% For the \LaTeXe, we also want to turn off \texttt{a4paper}.
%    \begin{macrocode}
%<*style>
\def\ds@twocolumn{\@twocolumntrue}
\def\ds@twoside{\@twosidetrue \@mparswitchtrue}
\newif\if@titpg \@titpgfalse
\def\ds@titlepage{\@titpgtrue}
\@namedef{ds@a4}{\typeout{Option `a4' not necessary}}
\@namedef{ds@a4in}{\typeout{Option `a4in' not necessary}}
\@namedef{ds@a4wide}{\typeout{Option `a4wide' not necessary}}
%</style>
%<*class>
\DeclareOption{a4}{\typeout{Option `a4' not necessary}}
\DeclareOption{a4in}{\typeout{Option `a4in' not necessary}}
\DeclareOption{a4wide}{\typeout{Option `a4wide' not necessary}}
\DeclareOption{a4paper}{\typeout{Option `a4paper' not necessary}}
%</class>
%    \end{macrocode}
%
% \subsubsection*{Extra Options}
% The new options that do things are \texttt{nosecnum} (to turn off
% section numbering) and \texttt{full} (to read in all the other options in
% the \texttt{preprint} collection). Both just set a flag for later usage.
%    \begin{macrocode}
%<*style>
\def\ds@nosecnum{\@secnumfalse}
\def\ds@secnum{\@secnumtrue}
\def\ds@full{\@fulltrue}
%</style>
%<*class>
\DeclareOption{secnum}{\@secnumtrue}
\DeclareOption{nosecnum}{\@secnumfalse}
\DeclareOption{full}{\@fulltrue}
\DeclareOption{bw}{\PassOptionsToPackage{bw}{mpshead}}
\newif\if@MPS \@MPStrue
\DeclareOption{mpae}{\@MPSfalse}
\DeclareOption{mps}{\@MPStrue}
%</class>
%    \end{macrocode}
%
% \subsubsection*{Invoke Options}
% Now for \LaTeX~2.09, invoke the options with |\@options|, and then
% redefine that command to |\relax| so that it is not called again by {\tt
% article}. The |\@@input| command is stored and redefined so that no files
% are read in by \texttt{article}.
%    \begin{macrocode}
%<*style>
\@options
\let\@options=\relax
\let\oriinput=\@@input
\def\@@input#1\relax{\relax}
\oriinput article.sty
\let\@@input=\oriinput
%    \end{macrocode}
%
% Now set |\@ptsize| and |\if@titlepage| to the intermediate commands
% |\@ptsz| and |\@titpg|, and then read
% in the \texttt{art1\textit{n}.sty} file with the size-specific
% definitions.
%    \begin{macrocode}
\let\@ptsize=\@ptsz
\let\if@titlepage=\if@titpg
\input art1\@ptsize.sty\relax
%</style>
%    \end{macrocode}
%
% For \LaTeXe, the situation is much simpler. Pass unused options over to
% \texttt{article}, execute the defaults, and then process the selected
% options before loading the main class \texttt{article}.
%
% In compatibility mode, the paper size options are not activated; hence
% the \texttt{a4paper} option must not be issued. Page sizes are explicitly
% set later.
%    \begin{macrocode}
%<*class>
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}}
\ExecuteOptions{secnum}
\ProcessOptions
\if@compatibility
  \LoadClass{article}
\else
  \LoadClass[a4paper]{article}
\fi
%</class>
%    \end{macrocode}
%
% \subsection{Modify the \texttt{article} Specifications}
% Now start changing the things set by \texttt{article} and
% \texttt{art1\textit{n}.sty} or \texttt{size1\textit{n}.clo}.
%
% \subsubsection*{Changes for a Manuscript}
% The \texttt{ms} option is for a manuscript. This will never be with
% two columns and will always have a title page. Furthermore, it is
% double-spaced.
%    \begin{macrocode}
\if@draft
     \@twocolumnfalse
     \@titlepagetrue
     \def\baselinestretch{1.4}
     \typeout{Draft manuscript}
\fi
%    \end{macrocode}
%
% \subsubsection*{Section Numbering}
% Suppress section numbering if flag |\if@secnum| has been set. This is
% done by setting the counter \texttt{secnumdepth} to 0.
%    \begin{macrocode}
\setcounter{secnumdepth}{\if@secnum 3 \else 0\fi}
%    \end{macrocode}
%
% \subsubsection*{Sectioning Commands}
% \begin{macro}{\section}
% \begin{macro}{\subsection}
% \begin{macro}{\subsubsection}
% \begin{macro}{\paragraph}
% \begin{macro}{\subparagraph}
% The major changes are that |\section| centers its title, with
% |\large\bfseries| instead of |\Large\bfseries|; other levels use
% |\slshape| in place of
% |\bfseries| and tend to be in a smaller font than used by \texttt{article}.
%    \begin{macrocode}
\def\section{\@startsection {section}{1}{\z@}{-2.5ex plus -.5ex minus
    -.2ex}{1ex plus .1ex}{\reset@font\large\bfseries\centering}}
\def\subsection{\@startsection{subsection}{2}{\z@}{-2.25ex plus -.5ex minus
   -.2ex}{1ex plus .1ex}{\reset@font\normalsize\bfseries}}
\def\subsubsection{\@startsection{subsubsection}{3}{\parindent}{2.25ex plus
   .5ex minus .2ex}{-1em}{\reset@font\normalsize\slshape}}
\def\paragraph{\@startsection
     {paragraph}{4}{\parindent}{2.25ex plus .5ex minus .2ex}{-1em}
     {\reset@font\normalsize\slshape}}
\def\subparagraph{\@startsection
     {subparagraph}{5}{\parindent}{2.25ex plus .5ex minus .2ex}
     {-1em}{\reset@font\normalsize\slshape}}
%    \end{macrocode}
% \end{macro}\end{macro}\end{macro}\end{macro}\end{macro}
%
% \subsubsection*{Plate Environment}
% \begin{macro}{\plate}
%  Add a \texttt{plate} environment, parallel to \texttt{figure}.
%    \begin{macrocode}
\newcounter{plate}
\def\theplate{\@arabic\c@plate}
\def\fps@plate{tbp}
\def\ftype@plate{4}
\def\ext@plate{lop}
\def\plate{\@float{plate}}
\let\endplate\end@float
\@namedef{plate*}{\@dblfloat{plate}}
\@namedef{endplate*}{\end@dblfloat}
%    \end{macrocode}
% \end{macro}
% \begin{macro}{\listofplates}
% Include a |\listofplates| command like |\listoffigures|.
%    \begin{macrocode}
\def\listofplates{\section*{\listplatename
    \@mkboth{\uppercase{\listplatename}}{\uppercase{\listplatename}}}%
  \@starttoc{lop}}
\let\l@plate\l@figure
%    \end{macrocode}
% \end{macro}
% \begin{macro}{\platename}
% \begin{macro}{\listplatename}
% Add name commands for plates.
%    \begin{macrocode}
\def\platename{Plate}
\def\listplatename{List of Plates}
%    \end{macrocode}
% \end{macro}\end{macro}
%
% \subsubsection*{Fix up Float Captions}
% Print the words `Figure' and `Plate' in bold in the captions; for two
% column mode, print them small.
%    \begin{macrocode}
\if@twocolumn
  \def\fnum@figure{\reset@font\small{\bfseries \figurename~\thefigure}}
  \def\fnum@plate{\reset@font\small{\bfseries \platename~\theplate}}
\else
  \def\fnum@figure{\reset@font\normalsize{\bfseries \figurename~\thefigure}}
  \def\fnum@plate{\reset@font\normalsize{\bfseries \platename~\theplate}}
\fi
\def\fnum@table{\reset@font{\bfseries \tablename~\thetable}}
%    \end{macrocode}
% \begin{macro}{\@makecaption}
% Modification to |\@makecaption|, to use period in place of colon.
%    \begin{macrocode}
\long\def\@makecaption#1#2{
   \vskip 1em
   \setbox\@tempboxa\hbox{#1. #2}
   \@tempdima\wd\@tempboxa
   \ifdim \@tempdima >\hsize
     #1. #2\par
   \else
     \hbox to\hsize{\hfil\box\@tempboxa\hfil}
   \fi}
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{Page Styles}
% \begin{macro}{\ps@myheadings}
% Change the \texttt{myheadings} and \texttt{headings} page styles to use
% small caps in place of italics.
%    \begin{macrocode}
\def\ps@myheadings{\let\@mkboth\@gobbletwo
\def\@oddhead{\hfil{\scshape\rightmark} \hfil {\rmfamily\thepage}}%
\def\@oddfoot{}\def\@evenhead{{\rmfamily \thepage}\hfil
   {\scshape\leftmark}\hfil}%
\def\@evenfoot{}\def\sectionmark##1{}\def\subsectionmark##1{}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ps@headings}
% \changes{6.2}{1995 Jan 08}{Center text, the same as in \texttt{myheadings}}
% Do the same for \texttt{headings}; however, many automatic entries are
% done with |\uppercase|, something that must be suppressed if small caps
% are used. Add |\scnuc| to do this (``small caps no upper case'').
%    \begin{macrocode}
\if@twoside
 \def\ps@headings{\let\@mkboth\markboth
  \def\@oddfoot{}\def\@evenfoot{}%
  \def\@evenhead{{\rmfamily\thepage}\hfil {\scnuc \leftmark}\hfil}%
  \def\@oddhead{\hfil{\scnuc \rightmark}\hfil {\rmfamily\thepage}}%
  \def\sectionmark##1{\markboth {\ifnum \c@secnumdepth >\z@
    \thesection\hskip 1em\relax \fi ##1}{}}%
  \def\subsectionmark##1{\markright {\ifnum \c@secnumdepth >\@ne
          \thesubsection\hskip 1em\relax \fi ##1}}}
\else
 \def\ps@headings{\let\@mkboth\markboth
  \def\@oddfoot{}\def\@evenfoot{}%
  \def\@oddhead{{\scnuc \rightmark}\hfil {\rmfamily\thepage}}%
  \def\sectionmark##1{\markright{\ifnum \c@secnumdepth >\z@
    \thesection\hskip 1em\relax \fi ##1}}}
\fi
\def\scnuc{\let\uppercase=\relax\scshape}
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{Two Column Changes}
% In standard \texttt{article}, the style file \texttt{twocolum.sty} is
% read in when \texttt{twocolumn} has been selected. This has been
% suppressed in the style, so some of the modifications in that file are
% made here.
%    \begin{macrocode}
%<*style>
\if@twocolumn
\sloppy
\flushbottom
\parindent 1em
\leftmargini 2em
\leftmarginv .5em
\leftmarginvi .5em
\fi
%</style>
%    \end{macrocode}
%
% \subsubsection*{Title Page Check}
% In standard \texttt{article}, the style file \texttt{titlepag.sty} is
% read in when \texttt{titlepage} has been selected. This has been
% suppressed, but this is not serious if \texttt{mpshead} is chosen,
% either directly or through the option \texttt{full}. However, without it,
% there will be no title page. There, read in \texttt{titlepag.sty} just to
% be safe. Later \texttt{mpshead.sty} can overwrite it. (Not needed for
% the class.)
%    \begin{macrocode}
%<style>\if@full\else\if@titlepage \input{titlepag.sty} \fi \fi
%    \end{macrocode}
%
% \subsubsection*{Page Layout}
% The margins and text sizes are set to leave 1~inch margin on all sides
% for A4 paper. These specifications are taken from \texttt{a4in.sty}.
% Recall that \TeX{} measures from a point 1~inch from the upper left
% corner of the paper.
%
% (For \LaTeXe, we simply call my \texttt{fullpage} package.)
%
% A distinction between one and two sided mode is not really necessary
% here, but it might be some day if the left and right margins are made
% unequal. For two-sided pages to come out right, the sum of the left and
% right margins must be 453~pt less |\textwidth|, for A4 paper (or 470~pt
% for $8\frac{1}{2}''$ paper).
%    \begin{macrocode}
%<*style>
\topmargin 0pt
\if@twoside
   \oddsidemargin 0pt \evensidemargin 0pt
   \marginparwidth 90pt
\else
   \oddsidemargin 0pt \evensidemargin 0pt
   \marginparwidth 90pt
\fi
\textwidth 453pt
%    \end{macrocode}
%
% The text height is to be 630.7~pt, so that when the headers and footers
% are added (|\headheight|=12~pt, |\headsep|=25~pt, |\footsep|=30~pt)
% there are 2~inches left for the top and bottom margins. The |\textheight|
% should be a multiple of |\baselineskip| to avoid round-off error during
% processing. The three base values are 12, 13.6, 14.5~pt for font sizes
% 10, 11, 12~pt respectively. This calculation must be done before any
% |\baselinestretch| becomes operative (on the next change of font size).
% For \texttt{ms}, this has been set to double spacing, but is not yet
% in effect.
%    \begin{macrocode}
\ifcase \@ptsize
    \textheight 52\baselineskip
%    \end{macrocode}
% Makes 634~pt for 10~pt font size and |\baselineskip|=12~pt, once
% |\topskip|=10~pt is added.
%    \begin{macrocode}
\or
    \textheight 46\baselineskip
%    \end{macrocode}
% Makes 635.6~pt for 11~pt font size and |\baselineskip|=13.6~pt.
%    \begin{macrocode}
\or
    \textheight 43\baselineskip
%    \end{macrocode}
% Makes 633.5~pt for 12~pt font size and |\baselineskip|=14.5~pt.
%    \begin{macrocode}
\fi
%    \end{macrocode}
% Finally add |\topskip| (=10~pt) that also must be included in
% |\textheight|.
%    \begin{macrocode}
\advance\textheight by \topskip
%</style>
%    \end{macrocode}
% This algorithm is used by standard \texttt{article}, but really only
% makes sense when |\baselinestretch| is 1.0.
%
% Here we add the \texttt{fullpage} package for \LaTeXe.
% In compatibility mode, set the paper sizes explicitly
%    \begin{macrocode}
%<*class>
\if@compatibility
   \setlength\paperheight {297mm}
   \setlength\paperwidth  {210mm}
\fi
\RequirePackage[in,myheadings]{fullpage}
%</class>
%    \end{macrocode}
%
% \subsection{New Command: Two Column Test}
% \begin{macro}{\iftwocol}
% Formatting of equations or figures is often to be different for one or
% two column modes. This test allows alternative text to be inserted
% depending on the mode.
%    \begin{macrocode}
\def\iftwocol#1#2{\if@twocolumn #1\else #2\fi}
%    \end{macrocode}
% \end{macro}
%
% \subsection{Input the Full Set of Options}
% The option \texttt{full} stands for the full set of \texttt{preprint}
% options. Up to 6 other files are read in, depending on other options.
% I might consider making this standard some day.
%    \begin{macrocode}
\if@full
%    \end{macrocode}
% The option to print an MPAe/MPS logo and header with the title, and to
% place the abstract over two columns in \texttt{twocolumn} mode.
%    \begin{macrocode}
%<*class>
\if@MPS
  \RequirePackage{mpshead}[2004/07/06]
\else
%</class>
%<style>\input{mpaehead.sty}
%<class>  \RequirePackage{mpaehead}[1998/04/23]
%<class>\fi
%    \end{macrocode}
% The option to make author-year literature citations.
%    \begin{macrocode}
%<style>\input{natbib.sty}
%<class>\RequirePackage{natbib}[1997/07/14]
%    \end{macrocode}
% The option to balance the last two columns on the page; makes sense
% only if \texttt{twocolumn} has been selected. If not, then the special
% commands |\balance| and |\nobalance| must be defined.
%    \begin{macrocode}
\if@twocolumn
%<style>  \input{balance.sty}
%<class>  \RequirePackage{balance}[1997/04/29]
\else
     \def\balance{\relax}
     \def\nobalance{\relax}
\fi
%    \end{macrocode}
% The option to allow counters to be subnumbered. Set the style of
% subnumbers to be of form 4-b. (Note that if \texttt{full} is not
% selected but \texttt{sublabel} is given explicitly as an option, then the
% default style is taken, not this one.)
%    \begin{macrocode}
%<style>\input{sublabel.sty}
%<class>\RequirePackage{sublabel}[1997/04/28]
\def\substyle#1{-\alph{#1}}
%    \end{macrocode}
%
% The option to allow equations, figures, etc.\ to be renumbered in
% appendices.
%    \begin{macrocode}
%<style>\input{appendix.sty}
%<class>\RequirePackage{appendix}[1997/04/29]
%    \end{macrocode}
% The remaining file \texttt{figcaps.sty} was previously only read in for
% manuscript. This is now changed since it contains some definitions needed for
% the \texttt{longtable} environment, even for preprints. By reading it in
% anyway, we avoid having to make up dummies for its special commands. Whether
% it is activated or not depends on the \texttt{ms} option.
%    \begin{macrocode}
%<style>  \input{figcaps.sty}
%<class>  \RequirePackage{figcaps}[1998/09/14]
\if@draft \figcapstrue \else \figcapsfalse \fi
\fi
%    \end{macrocode}
% End of the |\if@full| condition.

% \subsection{Finishing Off}
% For 2.09, it is necessary to define |\bfseries| and |\slshape|
% as well as |\reset@font|.
%    \begin{macrocode}
%<*style>
\@ifundefined{bfseries}{\let\bfseries=\bf}{}
\@ifundefined{slshape}{\let\slshape=\sl}{}
\@ifundefined{scshape}{\let\scshape=\sc}{}
\@ifundefined{rmfamily}{\let\rmfamily=\rm}{}
\@ifundefined{reset@font}{\let\reset@font=\relax}{}
%</style>
%    \end{macrocode}
%
% Call the default font (to invoke |\baselinestretch|) and select the
% default page style to be \texttt{myheadings}. For |twocolumn|, call
% |\flushbottom| to line up the bottom lines.
%    \begin{macrocode}
\reset@font\normalsize
\pagestyle{myheadings}
\if@twocolumn \flushbottom \else \raggedbottom \fi
\if@twoside \flushbottom \fi
%</style|class>
%    \end{macrocode}
%
% \Finale