% MANUAL.TEX -- User input guide for AAS\TeX\ markup package.

\documentstyle[aaspptwo]{article}

\textwidth 7.3in
\hoffset=-0.4in  % This centers the extra wide page
\voffset=-0.4in  % This is because the printer I use prints too low...
\def\baselinestretch{0.96}

\hyphenation{com-pu-scripts}

\begin{document}
\twocolumn

\title{The AAS\TeX\ Macros for\\
       Manuscript Preparation}

\author{Chris Biemesderfer}
\affil{American Astronomical Society}
\authoraddr{P.O. Box 1180, Oracle, AZ 85623}

\vspace{.2in}

The AAS has developed an author markup package to assist authors in
preparing manuscripts for articles that
are intended for submission to the AAS- and ASP-affiliated journals.
It is important that the markup used by authors in electronic
manuscripts (sometimes called compuscripts) be consistent and
standardized so that such manuscripts can be widely accepted
by the journals, ultimately so that they can become part of
the normal production procedures.

This guide contains basic instructions for creating
manuscripts using the AAS\TeX\ markup package, which functions
as substyles to the standard \LaTeX\ {\tt article} style.
Authors are expected to be familiar with the editorial
requirements of the journals so that they can make
appropriate submissions, as well as to have at least
a rudimentary knowledge of \TeX\ (for instance, knowing
how to set up equations using \TeX\ commands).
It is unrealistic to provide a tutorial on \TeX;
readers who are unfamiliar with \TeX\ are advised
that they will need additional sources of information.
A number of useful publications are listed in the
references section of this guide.

\section{Introduction}

The AAS\TeX\ author-prepared package was developed to provide
authors with a consistent means of preparing articles for
submission to AAS and ASP journals.  The most important aspect of the
package is that it defines the set of commands (called {\sl markup\/})
that can be used to identify the structural elements of papers.
When articles are marked up using this set of standard commands,
the papers can be submitted electronically to the editorial
offices, and it can also eventually be passed along to the publisher.

For purposes of producing paper output, the AAS\TeX\ package contains
a number of \LaTeX\ style files that produce variously formatted pages.
There is a ``manuscript'' style, two ``preprint'' styles, and
two ``plano table'' styles.
The manuscript style is used for papers that are submitted to
AAS and ASP journals for review.
The preprint styles render articles in a compact form that may
be suitable for distribution among colleagues.
The plano table styles are used by authors who wish to submit
camera-ready tables to the journals for publication.

\section{General preparation instructions}

Computer manuscripts must include all the necessary components,
e.g., a title, author names and their affiliations,
an abstract, a main body, tables, etc., in the proper
order according to the editorial requirements of the journal.
It is the author's responsibility to ensure that the article
conforms to all editorial specifications regarding content and
organization, mathematical formul\ae, chemical names, etc.

In the sections that follow, we review some essential procedures
that must be followed when preparing \TeX\ input.

\subsection{Running text}

Printing is different from typewriting, and \TeX\ is different
from other word processing tools.  This section consists of
reminders (admonitions) about things that require special
attention so that \TeX\ can format the input properly.

The ends of words and sentences are marked by white space, and
it doesn't matter how many spaces are typed; one is as good as 100.
\TeX\ treats the end of a line in the input file as a space.

Paragraphs are separated by blank lines.
Don't hyphenate words in the input file;
\TeX\ takes care of hyphenation automatically.
Continue to hyphenate modifiers within a line of text, e.g.,
``author-prepared copy.''

Quotation marks should be typed as pairs of opening and
closing single quotes, e.g., {\tt ``quoted text''};
don't use double quotes ({\tt "bad form"}).

Do not underline.
In printing, text is emphasized by changing the type style,
usually to {\sl slanted\/} or {\it italic\/} type.

A number of common characters are interpreted as commands,
and these must be entered specially, by preceding them with
a backslash (\verb"\"): \$ \& \% \# \{ and \} must be typed
\verb"\$" \verb"\&" \verb"\%" \verb"\#" \verb"\{" and \verb"\}".

Authors should refrain from adding vertical or horizontal space.
Concentrate on the content of the document and identifying its
components with the structural markup commands.
Authors should avoid creating new commands by using \LaTeX\ commands
that create ``private'' markup commands that are not described in this guide.

\subsection{Math}

Mathematical expressions that are part of the running text are
delimited by a single dollar sign (\$),
e.g., \verb"$\pi r^2$" yields $\pi r^2$.
To get the appropriately sized superscript or subscript in the
roman font, use the \verb"\rm" command, e.g., 
\verb"$J_{\rm HF}(t)$" produces $J_{\rm HF}(t)$.

Displayed equations can be delimited in several ways.
The most concise markup is to bracket the equation between
\verb"\[" and \verb"\]" commands,
which is equivalent to placing the formula in a {\tt displaymath}
environment.  These markup commands will produce
{\sl unnumbered} equations.

Numbered equations can be typeset by typing the formula in
an {\tt equation} environment.
A series of related equations that need vertical alignment,
e.g., a derivation where alignment is wanted on the equal sign (=),
can be typeset in an {\tt eqnarray} environment.

While it is possible for authors to assign their own equation numbers,
it is easier to let \LaTeX\ number them automatically.
By default, \LaTeX\ will number equations sequentially from the
beginning of the paper to the end.

It is sometimes appropriate for equation numbering sequences
to carry through sections of the paper only.
Equations can be numbered ({\it sec-eqn}) by placing the command
\verb"\eqsecnum" in the preamble of the document.

\subsection{Tables}

Tables are notoriously difficult to compose,
and great care and patience are usually required
before tabular information can be typeset satisfactorily.
Tables should be placed in separate table environments,
i.e., the tabular material must be enclosed within
\verb"\begin{table}" and \verb"\end{table}" commands.
Tables should have a title or caption and the correct
number of descriptive column headings.
A single horizontal rule should be set after the column headings
with the \verb"\tableline" command.
Do not insert any other horizontal or vertical
lines in the body of the table.

The {\tt planotable} environment is intended to make it easier
to prepare camera-ready tables, although
many authors will find {\tt planotable}
suitable for {\sl all\/} tables.
Authors who are using the plano tables styles to prepare
camera-ready tables are urged to read the plano tables
section carefully.

Notes in tables should be marked by
\verb"\tablenotemark";
corresponding text should appear in a
\verb"\tablenotetext" command.

\subsection{Cross-referencing}

Cross-referencing equations, tables, and figures
in text depends upon the use of ``tags'', which
are defined by the user.  The \verb"\label" command is used
to define cross-reference tags for \LaTeX; \verb"\ref" is used to
refer to them.  Tags are simply text strings that
serve to label equations, tables, and  figures, so that
they may be referred to symbolically in the text.
Authors should place \verb"\label" commands immediately
after the markup command that starts the structure being referenced.
References to page numbers should {\sl not} be made.

\LaTeX\ keeps track of autonumbered counters and cross-reference
information by maintaining an auxiliary file in the same working
directory as the source file.  The auxiliary file will have an
extension of {\tt .aux}.  This file should not be deleted, since
subsequent \LaTeX\ processing uses the auxiliary data to resolve
references, etc.

The auxiliary file mechanism makes it necessary to run \LaTeX\
on a given source file more than once to
ensure that the cross-reference information has been properly resolved.
This is most evident when changes are made that affect the number
or the placement of equations, tables, and the like.
\LaTeX\ will typically issue a warning message that advises
the user to ``rerun to get cross-references right'',
in which case, run \LaTeX\ again.
If the error message appears after two successive \LaTeX\ runs,
it is likely that a reference has been made to an undefined label.

\subsection{Alternate style options}

It is not the objective of the AAS\TeX\ project to develop \LaTeX\ styles
that produce pages that mimic the appearance of specific journals.
Since this is the case, we have chosen
to provide several format options within the preprint styles
themselves so that output format can be varied.
The {\tt aaspp} substyle offers a single-spaced alternative for manuscripts,
for instance.  The primary motivation behind this idea is to provide some
definitions that permit individuals to distribute ``pretty'' preprints
with this package.
In recognition of the fact that beauty is in the eye of the beholder,
there is no intention that any of these styles should define pretty.

Editors prefer a large typeface with
adequate space between typed lines for technical editing marks and
wide margins for editor and author comments.
The use of the {\tt aasms} substyle will produce
double-spaced, full-width output by default.

Authors may prefer a denser form of output for distribution
to colleagues who are primarily interested in reading the paper, as
opposed to copy editing it.
The {\tt aaspp} substyle is similar to the manuscript style,
but it is single-spaced, and it is possible to use a smaller typeface.
For wide text lines (as in the {\tt aaspp} style), it is advisable
to use faces no smaller than 11 points ({\tt 11pt} substyle option).
Author's remarks appear in the upper right corner of the title page,
and no explicit page breaks are inserted in the front matter by the style.

Another alternative is to include the \verb"\tighten" command
in the document preamble when the {\tt aasms} substyle is used;
its effect is to reduce the vertical spacing in the text.
The rest of the formatting will be identical to the manuscript format.

For institutional purposes, it may be preferable for preprints
to be set in two columns, have running heads, etc.
The {\tt aaspptwo} substyle may be used instead to produce
two-column pages.
This style can be used as is, but it can also serve as a point of
departure for \LaTeX\ style writers at institutions that want
preprints of this general nature.

The preparation of ``plano tables'' (camera-ready, or {\sl planographic\/})
is possible by using one of the style files \verb"aj_pt" or \verb"apjpt".
These styles produce tables in formats suitable for the \aj\ and the
\apj, respectively; the \verb"aj_pt" style could be used to create
camera-ready tables for \pasp\ as well.  These styles are intended
primarily for the production of tables that the author wishes to
submit camera-ready; they are not designed to produce journal pages.

\section{Command descriptions}
\setcounter{secnumdepth}{1}

This section describes the commands in the AAS\TeX\ markup
package that an author might enter in an electronic manuscript.
In the interest of completeness, all the structural markup that
is needed to identify components is discussed.
The commands will be described in roughly the same order as they
would appear in a manuscript.
The reader will probably find it helpful to examine the
sample papers (\verb"sample1.tex" and \verb"sample2.tex") as well.

\subsection{Preamble}

Most documents processed with a formatter have a collection of
commands at the beginning of the file that establish settings
for global parameters; this initialization section is sometimes
called the {\sl preamble}.  In \LaTeX\ manuscripts, the
preamble is that portion of the file before the
\verb"\begin{document}" command.

The first piece of markup in the manuscript must declare the
overall style of the document.
\begin{quote}
\verb"\documentstyle[12pt,aasms]{article}"
\end{quote}
The \verb"\documentstyle" command must appear first in any
\LaTeX\ file, and this one specifies the main style to be
the {\tt article} style using twelve point fonts,
with modifications and additions for the {\tt aasms} substyle.
It is preferable to use fonts at twelve points to prevent
illegibility due to exceedingly long lines
(too many characters on a line make it hard to read).
The {\tt aasms} substyle will issue a warning message
if the font size is smaller than twelve points, and the
size will be set to twelve points; the file will still be processed.

Tightening the vertical spacing
in the text results in output that may be attractive for distribution
to colleagues who are primarily interested in reading the paper, as
opposed to copy editing it.  Authors may include~a
\begin{quote}
\verb"\tighten"
\end{quote}
declaration in the preamble to direct the formatter to produce
a somewhat denser manuscript.
If the authors prefer not to insert this markup directly,
the same effect can be achieved with the \verb"tighten"
document substyle.
\begin{quote}
\verb"\documentstyle[aasms,tighten]{article}"
\end{quote}

Double-spaced output for referees and
copy editors is the main objective of this style, hence
the double-spacing occurs by default.
Neither the \verb"\tighten" command nor the \verb"tighten"
substyle should be used for manuscripts
submitted to the editorial office for scientific review.

\subsubsection{Preprint format}

A single-column preprint format can be specified with the {\tt aaspp}
substyle option.
\begin{quote}
\verb"\documentstyle[11pt,aaspp]{article}"
\end{quote}
The size of the typeface used is under author control by way of
\LaTeX's {\tt NNpt} article subtyles (where {\tt NN} is 10, 11, or 12).
Use of 10 point type is not recommended with the {\tt aaspp} style.

Authors may wish to adjust vertical spacing within a preprint,
for instance, double-spacing text while single-spacing tables.
Authors who want to alternate between single and double
spacing in the manuscript may use the following commands.
\begin{quote}
\verb"\singlespace"\\
\verb"\doublespace"
\end{quote}
\verb"\singlespace" sets the vertical spacing to a smaller value,
while \verb"\doublespace" causes double-spacing.
These are different from \verb"\tighten", which is intended for use
in the preamble of the article.

\subsubsection{Two-column format}

The {\tt aaspptwo} substyle has the principle function of setting
up two-column output.
\begin{quote}
\verb"\documentstyle[aaspptwo]{article}"
\end{quote}
Although it is quite obvious, it is important to remember
that text lines are considerably shorter when two of them are typeset
side by side on a page.  Long equations, wide tables and figures, and
the like, may not typeset in this format without some adjustments.
The expenditure of great effort to adapt copy and markup for
two-column pages is probably counterproductive.
Remember that the main
goal of this package at this point is to produce ``correct'' draft
(or referee) format pages;
it is the responsibility of the editors and publishers to
produce publication format papers for the journals.

The {\tt aaspptwo} substyle does not
impose a format for the article's front matter,
although there is often merit in setting the title, author, abstract,
and keyword material on a separate page at full text width.
The author may supply the
\verb"\twocolumn" command wherever desired.
\begin{quote}
\verb"\twocolumn"
\end{quote}
Note that the two-column format begins at the point \verb"\twocolumn"
appears in the text, and if that point is before the front matter,
title and author and so forth will be typeset in two-column mode
along with the rest of the paper; that's how this manual is prepared,
for example.
For purposes of producing ``pretty'' output, it is probably desirable
to put the \verb"\twocolumn" command after the abstract and keywords,
just before the body of the paper.
If \verb"\twocolumn" is not specified explicitly in {\tt aaspptwo}
style documents, the introductory material of the paper will be set
in one-column mode; the first \verb"\section" command (presumably
demarcating the beginning of the main body of the article) will
engage the two-column mode.

\subsubsection{Slug line data}

Journal and article identification information is established by the
editorial staff.  The following markup will be used by personnel at the
editorial office to record slug-line data;
these commands appear in the manuscript preamble.
These pieces of markup can be used to facilitate communication between
the editorial office and the publisher.

\begin{quote}
\verb"\received{RECEIPT DATE}"\\
\verb"\revised{REVISION DATE}"\\
\verb"\accepted{ACCEPT DATE}"
\end{quote}

For preprints and manuscripts in draft/referee format, etc.,
the slug-line information is irrelevant and generally in those styles
of that nature, the data are never formatted or printed.
Receipt and acceptance dates (or blank lines representing them) are
printed on {\tt aasms} articles, that is, on true manuscripts.
The {\tt aaspp} and {\tt aaspptwo} styles do not print the rules or the dates.
Authors do not know what these dates are, however,
so there is no reason for the author to include
\verb"\received" and \verb"\accepted" commands in manuscripts.
Editorial staff will insert the correct information as appropriate.

\begin{quote}
\verb"\journalid{VOL}{JOURNAL DATE}"\\
\verb"\articleid{START PAGE}{END PAGE}"\\
\verb"\paperid{MANUSCRIPT ID}"
\end{quote}

The \verb"\journalid" and \verb"articleid" commands are used to identify
the volume and page numbers of a scheduled article.
The manuscript identification number used to track the manuscript is
specified in the \verb"\paperid" command.

\begin{quote}
\verb"\cpright{TYPE}{YEAR}"\\
\verb"\ccc{CODE}"
\end{quote}
Copyright information is specified through the commands \verb"\cpright"
and \verb"\ccc".  The ``type'' of copyright and the corresponding year
are given in \verb"\cpright"; valid copyright types are as follows.
\begin{quote}
\begin{tabular}{l@{\quad}p{2in}}
\tt AAS & Copyright has been asigned to the AAS.\\
\tt ASP & Copyright has been asigned to the ASP.\\
\tt Crown & Crown (UK) copyright has been asigned to the AAS.\\
\tt PD & The article is in the public domain.\\
\tt none & No copyright is claimed for the article.\\
\end{tabular}
\end{quote}
The copyright type is case-sensitive, so the type string must be
entered exactly as given above.
The Copyright Clearing Center code may be given in the \verb"\ccc"
command; the code is taken as regular text, so any special characters,
notably `\$', must be properly specified.

Authors are invited to supply running head information.
There are generally two different kinds of data in running heads;
what is called here the left head contains an author list (last
names, possibly truncated as ``et al.''), while the right head
is an abbreviated form of the paper title.
\begin{quote}
\verb"\lefthead{TEXT}"\\
\verb"\righthead{TEXT}"
\end{quote}
Editors and publishers impose varying requirements
on the brevity of these data;
authors are asked to keep these items as short as possible.

Authors who wish to include a short remark on the title page,
such as the name and date of the journal in which an article
has been scheduled, may do so with the following command.
\begin{quote}
\verb"\slugcomment{TEXT}"
\end{quote}
In the {\tt aasms} style, such comments appear after the dates;
in the {\tt aaspp} style, they are placed at the upper right corner
of the title page.

\subsection{Starting the main body}

None of the markup that appears in the preamble actually typesets
anything; the preamble is only a control section.
The author must include a
\begin{quote}
\verb"\begin{document}"
\end{quote}
command to identify the beginning of the main textual
portion of the manuscript.

\subsection{Title, byline, abstract, etc.}

Title and author identification are by way of the markup commands
\verb"\title" and \verb"\author".
The authors' principal affiliation is specified with
a separate command \verb"\affil".
Each \verb"\author" command
should be followed by a corresponding \verb"\affil".
\begin{quote}
\verb"\title{LUCID TEXT}"\\[.5ex]
\verb"\author{NAME(S)}"\\
\verb"\affil{AFFILIATION}"\\
\verb"\authoraddr{ADDRESS}"\\[.5ex]
\verb"\and"
\end{quote}

Line breaks are permitted in the title if the author wishes
to specify them with the \verb"\\" command.  Long titles will
be broken automatically, so the \verb"\\" markup is not required.
If the title is explicitly broken over several lines, the
preferred style for titles in AAS and ASP journals is the so-called
``inverted pyramid'' style.  In this style, the longest line
is the first (or top) line, and each succeeding line is shorter.
The text of the title should be entered in mixed case;
it will be converted to uppercase by the publisher.
Footnotes are permissible in titles; be careful to ensure that
alternate affiliations (see below) are properly numbered if a
footnote to the title is specified.

Authors' names are given in \verb"\author" commands,
and should be entered in mixed case.
Names that appear together in the author list for authors who
have the same primary affiliation should be specified in a single
\verb"\author" command.
Each author group (\verb"\author" command)
should be followed by an \verb"\affil" command, giving the principal
affiliation of that author.  Physical and postal address information
for the institution specified may be included with its name.
The address can be broken over several lines by using the
\verb"\\" command to indicate the line breaks.
Usually, however, postal information will fit on one line.
When there is more than one \verb"\author" command, the last
one should be preceded by an \verb"\and" command.

When there is a lengthy author list, all authors' names may be
specified in a single \verb"\author" command, with affiliations
specified using the \verb"\altaffilmark" mechanism described below.
In this case, no \verb"\affil" commands would be used, and the
affiliations would all be listed in a footnote block at the bottom
of the title page.  The style file performs this formatting.

Postal addresses for individual authors may be specified in
\verb"\authoraddr" commands.  This command does not produce
any formatted text in most AAS\TeX\ styles, and can be used to specify the
corresponding address of the first author for purposes of
editorial communication.

Authors often have affiliations in addition to their principal employer,
and these are specified with the \verb"\altaffilmark"
and \verb"\altaffiltext" commands.
These behave like the \verb"\footnotemark"
and \verb"\footnotetext" commands of \LaTeX.
\verb"\altaffilmark" is appended to author's names in the \verb"\author"
lists, and generates superscript identification numbers.
The text for the individual alternate affiliations is generated by the
\verb"\altaffiltext" command.
\begin{quote}
\verb"\altaffilmark{TAG NUMBER(S)}"\\
\verb"\altaffiltext{NUMERICAL TAG}{TEXT}"
\end{quote}
It is up to the author to make sure that \verb"\altaffilmark" numbers
attached to authors' names correspond to the correct alternate affiliation,
i.e., that each {\small TAG NUMBER} match the {\small NUMERICAL TAG} for
the corresponding {\small TEXT}.

\subsubsection{Abstract}

The paper abstract should be enclosed in an {\tt abstract} environment.
\begin{quote}
\verb"\begin{abstract}"\\
{\it abstract text\/}\\
\verb"\end{abstract}"
\end{quote}

\subsubsection{Keywords}

Keywords, subject headings, etc., are accommodated
as a single piece of text.
\begin{quote}
\verb"\keywords{TEXT}"
\end{quote}
Authors must supply keywords delimited by the appropriate punctuation
required by the journal.  Keywords should be specified in alphabetical order.
The \verb"\keywords" command
supplies the proper leading text (``Keywords:'', ``Subject headings:'',
etc.), according to the style.

\subsection{Sections}

The {\tt article} style for AAS\TeX\ manuscripts supports four levels of
sectioning.
\begin{quote}
\verb"\section{HEADING}"\\[.5ex]
\verb"\subsection{HEADING}"\\[.5ex]
\verb"\subsubsection{HEADING}"\\[.5ex]
\verb"\paragraph{HEADING}"
\end{quote}
Section headings should be given in mixed case.
Note that these commands delimit sections by marking the
{\sl beginning\/} of each section;
there are not separate commands to identify the ends.

In addition, AAS\TeX\ manuscript styles support an
\verb"\acknowledgments" section.
\begin{quote}
\verb"\acknowledgments"
\end{quote}
In the AAS\TeX\ substyles, acknowledgments are set off from the
concluding main body text simply by vertical space
(no heading or type size change).
For use in producing output for specific journals,
this command might generate text saying ``Acknowledg[e]ments''.

\subsubsection{Appendices}

When one or more appendices are needed in a paper, the end of the
main body text must be marked.
\begin{quote}
\verb"\appendix"
\end{quote}
Note that the \verb"\appendix" command has no arguments;
sections in the appendix must be headed with \verb"\section"
commands containing the section headings, as described before.
The \verb"\appendix" command takes care of a number of internal
housekeeping concerns, such as identifying sections with letters
instead of numerals, resetting the equation counter, etc.

\subsection{Citations}

Citations in the text may be called out with either a \verb"\markcite"
command or a \verb"\cite" command.
\begin{quote}
\verb"\markcite{TEXT}"\\[.5ex]
\verb"\cite{TAG}"
\end{quote}
Which of these is used depends on the form chosen for the reference list
(described below).  \verb"\markcite" corresponds to the use of the
{\tt references} environment, while \verb"\cite" would be used in
conjunction with {\tt thebibliography}.

The conventional method used by authors to manage the citations and
reference list in a paper is a manual one.  For these authors, the
{\tt references} environment and \verb"\markcite" are appropriate.
The text supplied in the \verb"\markcite" command is the text that
will be inserted in the body at that point; this text should include
any necessary punctuation.

\LaTeX's {\tt thebibliography} environment allows authors to identify
references symbolically using unique tags (the author makes these up).
If this mechanism is used, the {\small TAG} given in the \verb"\cite"
command must correspond to a {\small TAG} given in a \verb"\bibitem"
command in the {\tt thebibliography} environment (see below).

In many cases, citations may be called out explicitly by the author
without any markup, since they are usually just running text
for AAS and ASP journals.  However, the use of \verb"\markcite" is still
encouraged, even for journals where no special formatting of
citation call-outs is required.
This will make the electronic texts more useful in the future
in the event that they are perused with on-line browsers.

\subsection{Equations}

Displayed equations can be typeset in many ways using the standard
displayed math environments of \LaTeX;
these three are probably of greatest use.
\begin{quote}
\verb"\begin{displaymath}"\\
\verb"\end{displaymath}"\\[.5ex]
\verb"\begin{equation}"\\
\verb"\end{equation}"\\[.5ex]
\verb"\begin{eqnarray}"\\
\verb"\end{eqnarray}"
\end{quote}
The {\tt displaymath} environment will break out a single,
unnumbered formula.  The equation will appear the same if it
is set in an {\tt equation} environment, and it will be
autonumbered by \LaTeX.
In order to set several formul\ae\ in which vertical alignment
is required, use the {\tt eqnarray} environment.

Authors occasionally wish to group related equations together and
identify them with letters appended to the same equation number,
as opposed to having each with a separate numeral.
When this is desired, such related equations should still be set
in {\tt equation} or {\tt eqnarray} environments (whichever is
appropriate may be used), and this grouping should be placed within
a {\tt mathletters} environment.
\begin{quote}
\verb"\begin{mathletters}"\\
{\it {\tt equation} or {\tt eqnarray} environment(s)\/}\\
\verb"\end{mathletters}"
\end{quote}

It is possible to override \LaTeX's automatic numbering within
{\tt equation} or {\tt eqnarray} environments.
\begin{quote}
\verb"\eqnum{TEXT}"
\end{quote}
When \verb"\eqnum" is specified inside an {\tt equation} environment,
or on a particular equation within an {\tt eqnarray}, the text supplied
as an argument to \verb"\eqnum" is used as the equation identifier.
\LaTeX's equation counter is {\sl not\/} incremented when \verb"\eqnum"
is used.
\verb"\eqnum" must be used {\sl inside\/} the environment.

When unnumbered equations are desired, authors can use either the
{\tt displaymath} environment (for single displayed equations) or place
a \verb"\nonumber" command before the equation delimiter (\verb"\\")
in a particular equation in an {\tt eqnarray}.
\LaTeX's equation counter is {\sl not\/} incremented when
\verb"\nonumber" is used.

If, as a consequence of the use of \verb"\eqnum" or \verb"\nonumber",
\LaTeX's equation counter gets out of the author's intended sequence,
the counter may be reset to a particular value.
\begin{quote}
\verb"\setcounter{equation}{NUMBER}"
\end{quote}
The equation counter should be set to the number corresponding to the
last equation that was formatted, so it is most appropriate for this
command to appear immediately after an {\tt equation} or {\tt eqnarray}
environment ends.
\verb"\setcounter{equation}" must be used {\sl outside\/} the math
environments.

Sometimes it is appropriate to number equations by section,
rather than sequentially through the whole paper.
When this is required,
\begin{quote}
\verb"\eqsecnum"
\end{quote}
should be specified in the document preamble.
As is the case with tightening the interline spacing
(\verb"\tighten", above), authors need not insert
the extra markup command in the text.
The same effect can be achieved with the \verb"eqsecnum"
document substyle.
\begin{quote}
\verb"\documentstyle[aasms,eqsecnum]{article}"
\end{quote}

\subsection{Bibliography}

As discussed briefly in the preceding section on citations,
there are two main methods for managing citations and references.
Many authors are comfortable with the standard
process of entering citations in the proper format directly
in the body of an article, and then organizing the reference
list themselves.
Such authors would use \verb"\markcite" for the citation call-outs
in the text, and employ the {\tt references} environment for the
reference list.  The {\tt references} environment simply sets off
the list of references and adjusts spacing parameters.
\begin{quote}
\verb"\begin{references}"\\
\verb"\reference" {\it bibliographic data\/}\\
\verb"   ."\\
\verb"   ."\\
\verb"\end{references}"
\end{quote}
Each reference is preceded by a \verb"\reference" command.

Observe that the {\it bibliographic data\/} supplied by the author must
conform to the standards of the journal.  We have elected not to burden
authors with tedious markup commands
to delimit the bibliographic fields because many of the journals we have
targeted in this project have agreed to reduce typographic overhead (bolding,
italicizing, etc.) in reference lists (Abt 1990).
It is the responsibility of the author to get these fields in the proper
order with the correct punctuation; the information will be typeset as is,
i.e., in roman with no size or style changes.

It is also possible to use the semantics
of \LaTeX's {\tt thebibliography} environment,
marking citations with \verb"\cite" and associating references
with them via \verb"\bibitem".  The \verb"\cite"-\verb"\bibitem"
mechanism associates citations and references symbolically
while maintaining proper citation syntax within the paper.
The author must create the citation label for each reference
in proper journal format in the \verb"\bibitem" command.
\begin{quote}
\verb"\begin{thebibliography}"\\
\verb"\bibitem[LABEL]{TAG} \reference" {\it bibliographic data\/}\\
\verb"   ."\\
\verb"   ."\\
\verb"\end{thebibliography}"
\end{quote}
where {\small LABEL} must adhere to journal standards, e.g., ``Abt 1986''.
Note that it is not possible to use \verb"\bibitem"s
within the {\tt references} environment,
nor will \verb"\cite" commands work properly in the main body
if \verb"\bibitem"s are not properly specified.
This technique can be a bit tricky, and there are limitations on the
way that the citation {\small LABEL} is formatted.
Authors are advised to consult the \LaTeX\ manual (Lamport 1985).

Citation management can be complex, and systems have been
developed to assist authors in preparing bibliographies.
The program that manages references within the \TeX\ family
is called BIB\TeX, and it is designed to work in conjunction
with the citation and reference list capabilities of \LaTeX.
At the present time, there
is no compelling reason to force an implementation based on BIB\TeX,
although it should be possible to build reference lists with
BIB\TeX\ if authors choose.
(It is also possible to define a bibliographic style for BIB\TeX\ so
that citations and reference lists are formatted correctly automatically.)

An identifier denoting that the article  was
prepared with the AAS\TeX\ package appears as a footnote
on the last page of references.

\subsubsection{Abbreviations for journals}

There are markup commands for many of the oft-referenced journals so that
authors may use the markup names as a shorthand rather than having to look
up a particular journal's specific abbreviation.
In principle, all the journals should be using the
same abbreviations as well, but it is fair to anticipate some changes in the
specific abbreviations before a set is finally settled on.  As long as
these commands are kept up to date, authors need not be concerned about
such editorial preferences and changes.

\begin{center}
\begin{tabular}{ll}
\verb"\aj" & Astronomical Journal\\
\verb"\araa" & Annual Review of Astronomy\\
  & \hspace*{1em} and Astrophysics\\
\verb"\apj" & Astrophysical Journal\\
\verb"\apjl" & \rule[.5ex]{2em}{.4pt}, Letters to the Editor\\
\verb"\apjs" & \rule[.5ex]{2em}{.4pt}, Supplement Series\\
\verb"\ao" & Applied Optics\\
\verb"\apss" & Astrophysics and Space Science\\
\verb"\aap" & Astronomy and Astrophysics\\
\verb"\aaps" & \rule[.5ex]{2em}{.4pt}, Supplement Series\\
\verb"\azh" & Astronomicheskii Zhurnal\\
\verb"\baas" & Bulletin of the AAS\\
\verb"\jrasc" & Journal of the RAS of Canada\\
\verb"\memras" & Memoirs of the RAS\\
\verb"\mnras" & Monthly Notices of the RAS\\
\verb"\pra" & Physical Review A: General Physics\\
\verb"\prb" & Physical Review B: Solid State\\
\verb"\prc" & Physical Review C:\\
\verb"\prd" & Physical Review D:\\
\verb"\prl" & Physical Review Letters\\
\verb"\pasp" & Publications of the ASP\\
\verb"\pasj" & Publications of the ASJ\\
\verb"\qjras" & Quarterly Journal of the RAS\\
\verb"\skytel" & Sky and Telescope\\
\verb"\sovast" & Soviet Astronomy\\
\verb"\ssr" & Space Science Reviews\\
\verb"\zap" & Zeitschrift f\"ur Astrophysik\\
\end{tabular}
\end{center}

\subsection{Tables}

There is support in the AAS\TeX\ package for tables via two mechanisms:
\LaTeX's standard {\tt table} and {\tt tabular} environments,
and a {\tt planotable} environment that facilitates the formatting
of lengthy tabular material.  Short tables may be marked up using
either mechanism; long tables will require the use of {\tt planotable}.

\LaTeX\ permits the preparation of fairly complex tables with
arbitrary spacing, straddle heads and rules, and the like.
Authors who need to specify complicated column headings and
so forth are advised to consult the \LaTeX\ manual (Lamport 1985)
for details.
Most of the capabilities are applicable to AAS\TeX's {\tt planotable}
environment as well as \LaTeX's {\tt tabular}.

\subsubsection{Long tables, plano tables}

This section describes the use of the {\tt planotable} environment.
This environment is so named because it was originally developed to
aid authors in preparing camera-ready tables for an article; such
camera-ready material would be produced in the same way as planographic
figures, hence the term ``plano table''.

There are several desiderata that are somewhat above and beyond LaTeX's
{\tt tabular} environment that facilitate the formatting of such tables.
Among these are breaking long tables across pages, using footnotes
in a table, specifying comments and references for tables, etc.

There are special \LaTeX\ substyle options within the AAS\TeX\ package
that authors can use to produce plano table output suitable for
photographic reproduction in specific AAS and ASP journals; these are the
\verb"aj_pt" and \verb"apjpt" substyles.
\begin{quote}
\verb"\documentstyle[aj_pt]{article}"\\[.5ex]
\verb"\documentstyle[apjpt]{article}"
\end{quote}
When tabular material is prepared with one of these style files,
the pages produced will be suitable for submission to the
journal as camera-ready ``art''.
These special styles are intended for producing plano tables {\sl only\/};
manuscripts should {\sl not\/} be formatted with the \verb"aj_pt" or
the \verb"apjpt" substyle;
Plano tables should be formatted separately from the manuscript.

Very long tables can be formatted within manuscripts using the same
markup commands as plano tables; the output looks different, of course.
The {\tt planotable} environment is delimited by \LaTeX's familiar
\verb"\begin" and \verb"\end" constructs.
\begin{quote}
\verb"\begin{planotable}{COLS}"\\
\verb"\end{planotable}"
\end{quote}
{\small COLS} specifies the justification for each column.
One of the letters `l', `c', or `r' is given for each column,
indicating left, center, or right justification.  Authors are
referred to the \LaTeX\ manual (Lamport 1985) for further information.

There are several items in a {\tt planotable} environment that
must be given before the data for the table.

\begin{quote}
\verb"\tablewidth{DIMEN}"\\
\verb"\tablecaption{TEXT}"
\end{quote}

The width of a plano table is defined by \verb"\tablewidth";
the default width is the width of the body text.
The table can be set to its natural width by specifying
a {\small DIMEN} of 0pt.

The caption (actually, the title) of the table is specified
in \verb"\tablecaption".
The intent is for the text of \verb"\tablecaption" to be brief;
explanatory notes may be specified in the end notes to the table
(\verb"\tablecomments", see below).

\begin{quote}
\verb"\tablehead{TEXT}"\\
\verb"\colhead{HEADING}"
\end{quote}

Column headings are specified within a \verb"\tablehead".
Within the \verb"\tablehead", each column heading can be given
in a \verb"\colhead", which will ensure that the heading is centered
on the natural width of the column; this is the typical disposition
of column headings, and the use of \verb"\colhead" is encouraged.
There should be a heading for each column, so there should be as
many \verb"\colhead" commands in the \verb"\tablehead" as there
are data columns.
If more complicated column headings are required, 
any valid {\tt tabular} commands that constitute a proper
head line for the table may be used.
Consult the \LaTeX\ manual (Lamport 1985) for details about using
the {\tt tabular} environment to prepare tables.

\begin{quote}
\verb"\tableheadfrac{NUM}"
\end{quote}

It is possible that a complicated table heading will overflow
the vertical space allotted for the table heading.
The fraction of the page allocated
for the table heading may be changed with \verb"\tableheadfrac".
The {\small NUM} argument to \verb"\tableheadfrac" should be the
decimal fraction of the page used for heading information.
The default value is .1, meaning that 10\% of the page height
is reserved for the table heading.  It should rarely be necessary
to change this value.

After the table title and column headings are specified, data lines
can be entered.
There are some concessions that must be made in the markup language
in order to enable the automatic page breaking.
\begin{quote}
\verb"\startdata"
\end{quote}
The body of the plano table (the beginning of the data lines) is
indicated by a \verb"\startdata" command.
\verb"\startdata" produces a table title (caption), the column headings
are formatted, and tabular formatting is engaged.

\begin{quote}
\verb"\nl"\\
\verb"\tablevspace{DIMEN}"
\end{quote}

Data elements within a row of the table are separated with \& (ampersand)
characters.  The end of each row is indicated with \verb"\nl".
Extra vertical space can be inserted between rows with a
\verb"\tablevspace" command; the argument is a dimension,
and may be specified in any units that are legitimate in \LaTeX.

\begin{quote}
\verb"\tablebreak"\\
\verb"\nodata"
\end{quote}

If a page break needs to be forced in a plano table,
\verb"\tablebreak" should be used instead of \verb"\nl".
This is sometimes necessary when several rows of data are
associated with a single object or item; such logical groupings
should not be broken across pages, and \verb"\tablebreak" can
be used to ensure that the page breaks are rational in these cases.

The journals often require that elements for which there are no data
be explicitly marked.  This is to differentiate such elements from
blank elements, which are frequently interpreted as implicitly
repeating the entry in the corresponding element in the row preceding.
Data elements for which there are no data should contain
a \verb"\nodata" command; an appropriate symbol will be placed in
that data element.

Within the plano table body, two kinds of ``specialty'' heads are
recognized.
\begin{quote}
\verb"\cutinhead{TEXT}"\\
\verb"\sidehead{TEXT}"
\end{quote}

A cut-in head is a piece of text that is centered on the table width;
it is spaced above and below from the data rows that precede and
follow it, and there may be rules associated, depending on the
journal or manuscript style.  All of these formatting particulars
are managed by the style files.  The author need only specify the
text to be centered with a \verb"\cutinhead" command.
Similarly, a side head is a piece of text that is left-justified.

Table footnotes (more properly, table {\sl endnotes\/})
may be used in the {\tt planotable} environment;
their use is described in detail in the section on
{\it Table footnotes\/}, below.
The markup commands for such endnotes are as follows.
\begin{quote}
\verb"\tablenotemark{TAG LETTER(S)}"\\
\verb"\tablenotetext{ALPHA TAG}{TEXT}"\\
\verb"\tablecomment{TEXT}"\\
\verb"\tablerefs{TEXT}"
\end{quote}

It is possible to override \LaTeX's automatic numbering within the
{\tt planotable} environment.
\begin{quote}
\verb"\tablenum{TEXT}"
\end{quote}
When \verb"\tablenum" is specified inside a {\tt planotable} environment,
the text supplied as an argument to \verb"\tablenum" is used as the
table identifier.
\LaTeX's equation counter is {\sl not\/} incremented when \verb"\tablenum"
is used.
\verb"\tablenum" must be used {\sl inside\/} the {\tt planotable} environment.

\subsubsection{Short tables}

Short tables (smaller than one manuscript page)
may be marked and composed using the standard \LaTeX\ tools for tables.
Tables should appear in {\tt table} environments.
\begin{quote}
\verb"\begin{table}"\\
\verb"\end{table}"
\end{quote}
The {\tt table} environment encloses not only the tabular
material but also any title (caption) or footnote information
associated with the table.

Titles or captions for short tables are indicated with
\begin{quote}
\verb"\caption{TEXT}"
\end{quote}
Tables will be identified with arabic numerals, e.g., ``Table 2'';
the identifying text, including the number, is generated automatically
by \verb"\caption" within the \verb"table" environment.

Tabular information is typeset within the
{\tt tabular} environment.
\begin{quote}
\verb"\begin{tabular}{COLS}"\\
\verb"\end{tabular}"
\end{quote}
where {\small COLS} specifies the justification for each column.
One of the letters `l', `c', or `r' is given for each column,
indicating left, center, or right justification.
Consult the \LaTeX\ manual (Lamport 1985) for details about using
the {\tt tabular} environment to prepare tables.
There should be only one {\tt tabular} table per {\tt table} environment.
If the journal requests manuscripts with only one table per page,
the author may need to insert a \verb"\clearpage" command after
especially short tables.

There is a \verb"\tableline" command for use in {\tt tabular}
environments.
\begin{quote}
\verb"\tableline"
\end{quote}
This command produces the horizontal rule(s) between the column headings
and the body of the table.
Authors are discouraged from using any \verb"\hlines" themselves;
vertical rules are typically forbidden by editorial preference.

It is possible to override \LaTeX's automatic numbering within the
{\tt table} environment.
\begin{quote}
\verb"\tablenum{TEXT}"
\end{quote}
When \verb"\tablenum" is specified inside a {\tt table} environment,
the text supplied as an argument to \verb"\tablenum" is used as the
table identifier.
\LaTeX's equation counter is {\sl not\/} incremented when \verb"\tablenum"
is used.
\verb"\tablenum" must be used {\sl inside\/} the {\tt table} environment.

\subsubsection{Table footnotes}

AAS\TeX\ supports footnotes (endnotes) that are associated with tables;
this support applies to both the {\tt planotable} environment
and the standard \LaTeX\ {\tt table} environment.
Footnotes for tables are usually identified by lower case letters
rather than numbers.
Marking and assigning associated text is achieved with
the \verb"\tablenotemark" and \verb"\tablenotetext"
commands, in which the note identifier is required
(cf.\ \verb"\altaffilmark" and \verb"\altaffiltext").
The \verb"\tablenotetext" {\sl must} be specified before
the enclosing \verb"\end{table}", since the text of
notes to tables are displayed by that command.
\begin{quote}
\verb"\tablenotemark{TAG LETTER(S)}"\\
\verb"\tablenotetext{ALPHA TAG}{TEXT}"
\end{quote}
Note that the {\small TAG LETTER} should be the same as the
{\small ALPHA TAG} for the corresponding {\small TEXT}.
It is the responsibility of the author to get the correspondence correct.

AAS\TeX\ also supports special kinds of table endnotes.
Sometimes authors tabulate things which have corresponding references,
and it may be desirable to associate these references with the table
rather than (or in addition to) the formal reference list.
Occasionally, authors wish to append a short paragraph of explanatory
notes that pertain to the entire table, but which are different than
the caption.
\begin{quote}
\verb"\tablerefs{REFERENCE LIST}"\\
\verb"\tablecomments{TEXT}"
\end{quote}

The table endnotes are coupled to the table in which they occur, rather
than being associated with a particular page, and they are printed with
the table (relatively close to the caption) instead of appearing at the
extreme bottom of the page.  This is done to ensure that the notes wind
up on the same page as the table, since tables are floats and can migrate
from one page to another.

\subsection{Figures}

At this time, the most widely used means of including
non-textual data in electronic manuscripts is to insert such
information as PostScript.\footnote{PostScript
is a registered trademark of Adobe Systems Incorporated.}
There is limited support for handling PostScript figures in
this version of the AAS\TeX\ markup package.

If the author wishes for the PostScript figure to be inserted in the
page being produced, it is necessary to use the {\it dvips\/} program.
This program is available in the public domain via anonymous FTP
from labrea.stanford.edu.
It is also necessary that the graphics files being included conform
to the Encapsulated PostScript standard (Adobe 1990).
Encapsulated PostScript will be referred to as `EPS' in what follows.

There are three commands for including EPS files in AAS\TeX\ manuscripts,
and these should be placed within a {\tt figure} environment.
\begin{quote}
\verb"\begin{figure}"\\
\verb"\plotone{EPSFILE}"\\
\verb"\plottwo{EPSFILE}{EPSFILE}"\\
\verb"\plotfiddle{EPSFILE}{VSIZE}"\\
\hspace*{2em}\verb"{ROT}{HSF}{VSF}{HTRANS}{VTRANS}"\\
\verb"\caption{TEXT}"\\
\verb"\end{figure}"
\end{quote}
\verb"\plotone" inserts the graphic in the named {\small EPSFILE},
scaled (in both dimensions) so that the horizontal
dimension fits in the body text width;
the vertical dimension is scaled to maintain the aspect ratio.
\verb"\plottwo" inserts two plots next to each other.
Scale factors are determined automatically from information in the
EPS file.

For the adventuresome, there is also \verb"\plotfiddle", which can be
used to override any automatic scaling, or to compensate for the fact
that scaling data in the EPS file may be erroneous.
When this method is used, the author must specify the {\sl vertical\/}
space allotment for the graphic.
The scaling and placement of the figure are controlled by these parameters:
\begin{quote}
\begin{tabular}{l@{\quad}p{2in}}
\tt VSIZE & vertical white space to allow for plot (\LaTeX\ dimension)\\
\tt ROT & rotation angle (degrees)\\
\tt HSF & horizontal scale (percentage)\\
\tt VSF & vertical scale (percentage)\\
\tt HTRANS & horizontal translation (PS points)\\
\tt VTRANS & vertical translation (PS points)\\
\end{tabular}
\end{quote}
PostScript points are 1/72 inches, so an {\small HTRANS} of 72 moves
the graphic 1 inch to the right.  The PostScript reference point is
the lower left corner of the page, so a {\small VTRANS} of 72 moves
the graphic {\sl up} 1 inch.

Authors are referred to the submission instructions for the appropriate
editorial office if EPS figures will be submitted along with a manuscript
via email.  These instructions can be obtained by sending a request by
email to one of the addresses given in the {\small README} file.

Figures may still be submitted on paper in the usual way,
with or without a companion paper manuscript.
When an author submits figures on paper, only the figure captions
need to be generated with the text of the paper.
They should be produced by using the \verb"\caption" command within an
otherwise empty {\tt figure} environment.
\begin{quote}
\verb"\begin{figure}"\\
\verb"\caption{TEXT}"\\
\verb"\end{figure}"
\end{quote}
When the {\tt figure} environment is used, the figure identification,
e.g., ``Figure 1'', is generated automatically by \verb"\caption".
It is usually acceptable for several figure captions to appear
on the same page.

It is possible to override \LaTeX's automatic numbering within the
{\tt figure} environment.
\begin{quote}
\verb"\figurenum{TEXT}"
\end{quote}
When \verb"\figurenum" is specified inside a {\tt figure} environment,
the text supplied as an argument to \verb"\figurenum" is used as the
figure identifier.
\LaTeX's equation counter is {\sl not\/} incremented when \verb"\figurenum"
is used.
\verb"\figurenum" must be used {\sl inside\/} the {\tt figure} environment.

Footnotes are {\sl not} supported for figures.

\subsection{Miscellaneous}

When discussing atomic species, ionization levels can be indicated
with the following command.
\begin{quote}
\verb"\ion{ELEMENT}{LEVEL}"
\end{quote}
The ionization state is specified as the second argument,
and should be given as a numeral.
For example, \ion{Ca}{3} is specified by typing \verb"\ion{Ca}{3}".

AAS\TeX\ contains two commands that permit authors to specify alternate
forms for fractions.  Authors submitting manuscripts electronically
will generally find it unnecessary to use any markup other than the
standard \LaTeX\ \verb"\frac".
\begin{quote}
\verb"\case{NUM}{DENOM}"\\
\verb"\slantfrac{NUM}{DENOM}"
\end{quote}
\LaTeX\ will set fractions in displayed math as built-up fractions;
it is sometimes desirable to use case fractions in displayed equations.
In such instances, one should use \verb"\case" rather than \verb"\frac".
Occasionally, authors wish to typeset fractions with a solidus but in
which the type size is reduced and the numerals are oriented diagonally.
In this case, \verb"\slantfrac" should be used instead of \verb"\frac".
Note that this is different from a shilled fraction, which authors can
produce without any special markup.
\begin{displaymath}
\renewcommand{\arraystretch}{1.4}
\begin{array}{llc}
\mbox{Built-up} & \verb"\frac{1}{2}" & \displaystyle\frac{1}{2} \\[.5ex]
\mbox{Case} & \verb"\case{1}{2}" & \case{1}{2} \\
\mbox{Slant} & \verb"\slantfrac{1}{2}" & \slantfrac{1}{2} \\
\mbox{Shilled} & \verb"1/2" & 1/2 \\
\end{array}
\end{displaymath}

The AAS\TeX\ package also contains a collection of assorted macros
for special symbols (or abbreviations) that authors tend to work
out for themselves anyway.
Some of the definitions come from the {\it A\&A\/} package (Springer 1989);
some are contributions from individuals.  We have
tried to select a tractable number that were useful and also somewhat
difficult to get right because fussy kerning or some such is required.

\begin{center}
\begin{tabular}{ll@{\hspace*{3em}}ll}
\verb"\deg" & \deg & 
\verb"\sq" & \sq \\
\verb"\sun" & \sun &
\verb"\earth" & \earth \\
\verb"\arcmin" & \arcmin & 
\verb"\arcsec" & \arcsec \\
\verb"\fd" & \fd & 
\verb"\fh" & \fh \\
\verb"\fm" & \fm & 
\verb"\fs" & \fs \\
\verb"\fdg" & \fdg & 
\verb"\farcm" & \farcm \\
\verb"\farcs" & \farcs & 
\verb"\fp" & \fp \\
\verb"\micron" & \micron & \\[.8ex]
\verb"\onehalf" & \onehalf &
\verb"\ubvr" & \ubvr \\
\verb"\onethird" & \onethird &
\verb"\ub" & \ub \\
\verb"\twothirds" & \twothirds &
\verb"\bv" & \bv \\
\verb"\onequarter" & \onequarter &
\verb"\vr" & \vr \\
\verb"\threequarters" & \threequarters &
\verb"\ur" & \ur \\[.8ex]
\verb"$\lesssim$" & $\lesssim$ &
\verb"$\gtrsim$" & $\gtrsim$ \\ 
\end{tabular}
\end{center}
Most of these commands can be used in running text as well as when
setting mathematical expressions.
\verb"\lesssim" and \verb"\gtrsim" can only be used in math mode,
which is sensible since they are relations.
It is possible to use \verb"\earth" and \verb"\sun" as subscripts,
e.g., \verb"$1.4 M_{\sun}$" yields $1.4 M_{\sun}$.

\subsection{Concluding the file}

The last thing in the electronic manuscript file should be the
\begin{quote}
\verb"\end{document}"
\end{quote}
command, which appears after all the back matter of the paper.
This command directs the formatter to perform assorted termination
activities and finish processing.

\section{Additional documentation}

The preceding detailed explanation of the markup commands in this
package has certain merit, but many authors will prefer to examine
the sample papers that are included with the style files.
The files of interest are described below.

The file \verb"sample1.tex" is a paper prepared
with the AAS\TeX\ package utilizing a minimal amount of markup.
The most salient thing to observe about this example is that,
apart from the document style declarations, no formatting
instructions are given in the file.

A more comprehensive example requiring nearly all of the capabilities
of the package (in terms of markup as well as formatting)
is in \verb"sample2.tex".
This file is annotated with comments that describe
the purpose of most of the markup.
\verb"sample2.tex" includes \verb"samp2tbl.tex", which
contains an example of a long table marked up using the
{\tt planotable} environment.
This demonstrates the use of {\tt planotable} for long tables
in manuscripts.

A set of three tables prepared as ``plano'' tables are contained in
the files \verb"table1.tex", \verb"table2.tex", and
\verb"table3.tex".  They can be formatted by running \LaTeX\ on
the \verb"samptbls.tex" file, into which they are included.
The document style in \verb"samptbls.tex" is {\tt apjpt} in the
distribution, but this can be changed to \verb"aj_pt" to see the
effects of differing requirements among journals.
Page breaks are explicitly indicated in \verb"table1.tex",
and they are set for the \apj\ style; due to the different
type size used in the \aj, the pages break somewhat irrationally
when the \verb"aj_pt" style is used.  It is left as an exercise
to the reader to make sense of this.

Also included in the distribution are files for two
AAS meeting posters, marked up as they would be for submission;
they are called \verb"paper1.tex" and \verb"paper2.tex".
One of these (\verb"paper2.tex") includes a discussion of some
of the issues surrounding standardized markup for electronic
manuscripts (Hanisch and Biemesderfer 1990).
This user guide (\verb"aastex.tex")
is also marked up with the AAS\TeX\ package,
although it is not exemplary as a scientific paper.

A number of the markup commands described in the preceding
sections are standard \LaTeX\ commands, and the reader who is
unfamiliar with their syntax is referred to the \LaTeX\
manual (Lamport 1985) for details.  A cribsheet listing all
the \LaTeX\ commands (and some pertinent plain \TeX\ commands)
with short descriptions of each is published by the \TeX\ Users
Group (Botway and Biemesderfer 1989).

Authors who wish to know the ins and outs of \TeX\ itself
should read the {\it\TeX book} (Knuth 1984), probably more than once.
There is a good deal of information about typography in general
in this source.  Many details of mathematical typography are
discussed in a book by Swanson (1971).

\begin{references}
\reference Abt, H.  1990, \apj, 357, 1 (editorial)
\reference Adobe Systems, Inc.  1990, PostScript Language Reference
    Manual, Appendix H (Reading, MA: Addison-Wesley)
\reference Biemesderfer, C. and Hanisch R.  1989, \baas, 21, 780
\reference Botway, L. and Biemesderfer, C.  1989,
    {\rm \LaTeX\ Command Summary} (Providence, RI: \TeX\ Users Group)
\reference Hanisch, R. and Biemesderfer, C.  1990, \baas, 22, 829
\reference Knuth, D.  1984, {\rm The \TeX book} (Reading, MA: Addison-Wesley)
\reference Lamport, L.  1985,
    {\rm \LaTeX: A Document Preparation System\/} (Reading, MA: Addison-Wesley)
\reference Springer-Verlag.  1989,
    {\rm Springer-Verlag \TeX\ AA macro package 1989}
    (Springer: Heidelberg)
\reference Springer-Verlag.  1990,
    {\rm Springer-Verlag \LaTeX\ AA macro package 1990}
    (Springer: Heidelberg)
\reference Swanson, E.  1979, {\rm Mathematics into Type} (Providence, RI:
    American Mathematical Society)
\end{references}

\newpage
\appendix

\section{Special symbols}

The \LaTeX\ language has a wide variety of special symbols
for which markup commands have already been defined.
These range from diacritics to exotic mathematical operators.

This section groups \LaTeX's symbols together more or less
according to function.
Some of these symbols are primarily for use in text;
most of them are mathematical symbols, and can only be
used in \LaTeX's math mode.
These tables are excerpted from the \LaTeX\ Command Summary
(Botway 1989).

\begin{table}[h]
\caption{Text-mode accents}
\begin{center}
\begin{tabular}{*{2}{ll@{\hspace{4em}}}ll}
\`{o} & \verb"\`{o}" & \={o} & \verb"\={o}" & \t{oo} & \verb"\t{oo}" \\
\'{o} & \verb"\'{o}" & \.{o} & \verb"\.{o}" & \c{o}  & \verb"\c{o}" \\
\^{o} & \verb"\^{o}" & \u{o} & \verb"\u{o}" & \d{o}  & \verb"\d{o}" \\
\"{o} & \verb#\"{o}# & \v{o} & \verb"\v{o}" & \b{o}  & \verb"\b{o}" \\
\~{o} & \verb"\~{o}" & \H{o} & \verb"\H{o}" & & \\
\end{tabular}
\end{center}
\end{table}

\begin{table}[h]
\caption{National symbols}
\begin{center}
\begin{tabular}{*{2}{ll@{\hspace{4em}}}ll}
\oe & \verb"\oe" & \aa & \verb"\aa" & \l  & \verb"\l" \\
\OE & \verb"\OE" & \AA & \verb"\AA" & \L  & \verb"\L" \\
\ae & \verb"\ae" & \o  & \verb"\o"  & \ss & \verb"\ss" \\
\AE & \verb"\AE" & \O  & \verb"\O"  & & \\
\end{tabular}
\end{center}
\end{table}

\begin{table}[h]
\caption{Miscellaneous symbols}
\begin{center}
\begin{tabular}{*{2}{ll@{\hspace{4em}}}ll}
\dag  & \verb"\dag"  & \S & \verb"\S" & \copyright & \verb"\copyright" \\
\ddag & \verb"\ddag" & \P & \verb"\P" & \pounds    & \verb"\pounds" \\
\#    & \verb"\#"    & \$ & \verb"\$" & \%         & \verb"\%" \\
\&    & \verb"\&"    & \_ & \verb"\_" & & \\
\{    & \verb"\{"    & \} & \verb"\}" & & \\
\end{tabular}
\end{center}
\end{table}

\begin{table}[h]
\caption{Math-mode accents}
\begin{center}
\begin{tabular}{ll@{\hspace{4em}}ll}
$\hat{a}$   & \verb"\hat{a}"   & $\dot{a}$   & \verb"\dot{a}"   \\
$\check{a}$ & \verb"\check{a}" & $\ddot{a}$  & \verb"\ddot{a}"  \\
$\tilde{a}$ & \verb"\tilde{a}" & $\breve{a}$ & \verb"\breve{a}" \\
$\acute{a}$ & \verb"\acute{a}" & $\bar{a}$   & \verb"\bar{a}"   \\
$\grave{a}$ & \verb"\grave{a}" & $\vec{a}$   & \verb"\vec{a}"   \\
\end{tabular}
\end{center}
\end{table}

\begin{table}[h]
\caption{Greek letters (math mode)}
\begin{center}
\begin{tabular}{cl@{\hspace{3em}}cl}
$\alpha$   & \verb"\alpha"   & $\nu$      & \verb"\nu"      \\
$\beta$    & \verb"\beta"    & $\xi$      & \verb"\xi"      \\
$\gamma$   & \verb"\gamma"   & $o$        & \verb"o"        \\
$\delta$   & \verb"\delta"   & $\pi$      & \verb"\pi"      \\
$\epsilon$ & \verb"\epsilon" & $\rho$     & \verb"\rho"     \\
$\zeta$    & \verb"\zeta"    & $\sigma$   & \verb"\sigma"   \\
$\eta$     & \verb"\eta"     & $\tau$     & \verb"\tau"     \\
$\theta$   & \verb"\theta"   & $\upsilon$ & \verb"\upsilon" \\
$\iota$    & \verb"\iota"    & $\phi$     & \verb"\phi"     \\
$\kappa$   & \verb"\kappa"   & $\chi$     & \verb"\chi"     \\
$\lambda$  & \verb"\lambda"  & $\psi$     & \verb"\psi"     \\
$\mu$      & \verb"\mu"      & $\omega$   & \verb"\omega"   \\[4ex]

$\varepsilon$ & \verb"\varepsilon" & $\varsigma$ & \verb"\varsigma" \\
$\vartheta$   & \verb"\vartheta"   & $\varphi$   & \verb"\varphi"   \\
$\varrho$     & \verb"\varrho"     & & \\[4ex]

$\Gamma$  & \verb"\Gamma"  & $\Sigma$   & \verb"\Sigma"   \\
$\Delta$  & \verb"\Delta"  & $\Upsilon$ & \verb"\Upsilon" \\
$\Theta$  & \verb"\Theta"  & $\Phi$     & \verb"\Phi"     \\
$\Lambda$ & \verb"\Lambda" & $\Psi$     & \verb"\Psi"     \\
$\Xi$     & \verb"\Xi"     & $\Omega$   & \verb"\Omega"   \\
$\Pi$     & \verb"\Pi"     & & \\
\end{tabular}
\end{center}
\end{table}

\begin{table}
\caption{Binary operations (math mode)}
\begin{center}
\begin{tabular}{cl@{\hspace{3em}}cl}
$\pm$       & \verb"\pm"       & $\cap$             & \verb"\cap"           \\
$\mp$       & \verb"\mp"       & $\cup$             & \verb"\cup"           \\
$\setminus$ & \verb"\setminus" & $\uplus$           & \verb"\uplus"         \\
$\cdot$     & \verb"\cdot"     & $\sqcap$           & \verb"\sqcap"         \\
$\times$    & \verb"\times"    & $\sqcup$           & \verb"\sqcup"         \\
$\ast$      & \verb"\ast"      & $\triangleleft$    & \verb"\triangleleft"  \\
$\star$     & \verb"\star"     & $\triangleright$   & \verb"\triangleright" \\
$\diamond$  & \verb"\diamond"  & $\wr$              & \verb"\wr"            \\
$\circ$     & \verb"\circ"     & $\bigcirc$         & \verb"\bigcirc"       \\
$\bullet$   & \verb"\bullet"   & $\bigtriangleup$   & \verb"\bigtriangleup" \\
$\div$      & \verb"\div"      & $\bigtriangledown$ & \verb"\bigtriangledown" \\
$\lhd$      & \verb"\lhd"      & $\rhd$             & \verb"\rhd"           \\
$\vee$      & \verb"\vee"      & $\odot$            & \verb"\odot"          \\
$\wedge$    & \verb"\wedge"    & $\dagger$          & \verb"\dagger"        \\
$\oplus$    & \verb"\oplus"    & $\ddagger$         & \verb"\ddagger"       \\
$\ominus$   & \verb"\ominus"   & $\amalg$           & \verb"\amalg"         \\
$\otimes$   & \verb"\otimes"   & $\unlhd$           & \verb"\unlhd"         \\
$\oslash$   & \verb"\oslash"   & $\unrhd$           & \verb"\unrhd"         \\
\end{tabular}
\end{center}
\end{table}

\begin{table}
\caption{Relations (math mode)}
\begin{center}
\begin{tabular}{cl@{\hspace{4em}}cl}
$\leq$        & \verb"\leq"        & $\geq$        & \verb"\geq"        \\
$\prec$       & \verb"\prec"       & $\succ$       & \verb"\succ"       \\
$\preceq$     & \verb"\preceq"     & $\succeq$     & \verb"\succeq"     \\
$\ll$         & \verb"\ll"         & $\gg$         & \verb"\gg"         \\
$\subset$     & \verb"\subset"     & $\supset$     & \verb"\supset"     \\
$\subseteq$   & \verb"\subseteq"   & $\supseteq$   & \verb"\supseteq"   \\
$\sqsubset$   & \verb"\sqsubset"   & $\sqsupset$   & \verb"\sqsupset"   \\
$\sqsubseteq$ & \verb"\sqsubseteq" & $\sqsupseteq$ & \verb"\sqsupseteq" \\
$\in$         & \verb"\in"         & $\ni$         & \verb"\ni"         \\
$\vdash$      & \verb"\vdash"      & $\dashv$      & \verb"\dashv"      \\
$\smile$      & \verb"\smile"      & $\mid$        & \verb"\mid"        \\
$\frown$      & \verb"\frown"      & $\parallel$   & \verb"\parallel"   \\
$\neq$        & \verb"\neq"        & $\perp$       & \verb"\perp"       \\
$\equiv$      & \verb"\equiv"      & $\cong$       & \verb"\cong"       \\
$\sim$        & \verb"\sim"        & $\bowtie$     & \verb"\bowtie"     \\
$\simeq$      & \verb"\simeq"      & $\propto$     & \verb"\propto"     \\
$\asymp$      & \verb"\asymp"      & $\models$     & \verb"\models"     \\
$\approx$     & \verb"\approx"     & $\doteq$      & \verb"\doteq"      \\
              &                    & $\Join$       & \verb"\Join"       \\
\end{tabular}
\end{center}
\end{table}

\begin{table}
\caption{Variable-sized symbols (math mode)}
\begin{center}
\begin{displaymath}
\begin{array}{ccl@{\hspace{2em}}ccl}
\sum & \displaystyle \sum & \hbox{\verb"\sum"} &
	\bigcap & \displaystyle \bigcap & \hbox{\verb"\bigcap"} \\[.7ex]
\prod & \displaystyle \prod & \hbox{\verb"\prod"} &
	\bigcup & \displaystyle \bigcup & \hbox{\verb"\bigcup"} \\[.7ex]
\coprod & \displaystyle \coprod & \hbox{\verb"\coprod"} &
	\bigsqcup & \displaystyle \bigsqcup & \hbox{\verb"\bigsqcup"} \\[.7ex]
\int & \displaystyle \int & \hbox{\verb"\int"} &
	\bigvee & \displaystyle \bigvee & \hbox{\verb"\bigvee"} \\[.7ex]
\oint & \displaystyle \oint & \hbox{\verb"\oint"} &
	\bigwedge & \displaystyle \bigwedge & \hbox{\verb"\bigwedge"} \\[.7ex]
\bigodot & \displaystyle \bigodot & \hbox{\verb"\bigodot"} &
	\bigotimes & \displaystyle \bigotimes & \hbox{\verb"\bigotimes"} \\[.7ex]
\bigoplus & \displaystyle \bigoplus & \hbox{\verb"\bigoplus"} &
	\biguplus & \displaystyle \biguplus & \hbox{\verb"\biguplus"} \\
\end{array}
\end{displaymath}
\end{center}
\end{table}

\begin{table}
\caption{Delimiters (math mode)}
\begin{center}
\begin{tabular}{lc@{\hspace{2em}}lc}
$($            & \verb"("            & $)$            & \verb")" \\
$[$            & \verb"["            & $]$            & \verb"]" \\
$\{$           & \verb"\{"           & $\}$           & \verb"\}" \\
$\lfloor$      & \verb"\lfloor"      & $\rfloor$      & \verb"\rfloor" \\
$\lceil$       & \verb"\lceil"       & $\rceil$       & \verb"\rceil" \\
$\langle$      & \verb"\langle"      & $\rangle$      & \verb"\rangle" \\
$/$            & \verb"/"            & $\backslash$   & \verb"\backslash" \\
$\vert$        & \verb"\vert"        & $\Vert$        & \verb"\Vert" \\
$\uparrow$     & \verb"\uparrow"     & $\Uparrow$     & \verb"\Uparrow" \\
$\downarrow$   & \verb"\downarrow"   & $\Downarrow$   & \verb"\Downarrow" \\
$\updownarrow$ & \verb"\updownarrow" & $\Updownarrow$ & \verb"\Updownarrow" \\
\end{tabular}
\end{center}
\end{table}

\begin{table}
\caption{Function names (math mode)}
\begin{verbatim}
  \arccos   \csc    \ker      \min
  \arcsin   \deg    \lg       \Pr
  \arctan   \det    \lim      \sec
  \arg      \dim    \liminf   \sin
  \cos      \exp    \limsup   \sinh
  \cosh     \gcd    \ln       \sup
  \cot      \hom    \log      \tan
  \coth     \inf    \max      \tanh
\end{verbatim}
\end{table}

\begin{table}
\caption{Arrows (math mode)}
\begin{center}
\begin{tabular}{clcl}
$\leftarrow$ & \verb"\leftarrow" & $\longleftarrow$ & \verb"\longleftarrow" \\
$\Leftarrow$ & \verb"\Leftarrow" & $\Longleftarrow$ & \verb"\Longleftarrow" \\
$\rightarrow$ & \verb"\rightarrow" &
	$\longrightarrow$ & \verb"\longrightarrow" \\
$\Rightarrow$ & \verb"\Rightarrow" &
	$\Longrightarrow$ & \verb"\Longrightarrow" \\
$\leftrightarrow$ & \verb"\leftrightarrow" &
	$\longleftrightarrow$ & \verb"\longleftrightarrow" \\
$\Leftrightarrow$ & \verb"\Leftrightarrow" &
	$\Longleftrightarrow$ & \verb"\Longleftrightarrow" \\
$\mapsto$ & \verb"\mapsto" & $\longmapsto$ & \verb"\longmapsto" \\
$\hookleftarrow$ & \verb"\hookleftarrow" &
	$\hookrightarrow$ & \verb"\hookrightarrow" \\
$\leftharpoonup$ & \verb"\leftharpoonup" &
	$\rightharpoonup$ & \verb"\rightharpoonup" \\
$\leftharpoondown$ & \verb"\leftharpoondown" &
	$\rightharpoondown$ & \verb"\rightharpoondown" \\
$\rightleftharpoons$ & \verb"\rightleftharpoons" &
	$\leadsto$ & \verb"\leadsto" \\
$\uparrow$ & \verb"\uparrow" & $\Updownarrow$ & \verb"\Updownarrow"\\
$\Uparrow$ & \verb"\Uparrow" & $\nearrow$ & \verb"\nearrow"\\
$\downarrow$ & \verb"\downarrow" & $\searrow$ & \verb"\searrow" \\
$\Downarrow$ & \verb"\Downarrow" & $\swarrow$ & \verb"\swarrow"\\
$\updownarrow$ & \verb"\updownarrow" & $\nwarrow$ & \verb"\nwarrow"\\
\end{tabular}
\end{center}
\end{table}

\begin{table}
\caption{Miscellaneous symbols (math mode)}
\begin{center}
\begin{tabular}{cl@{\hspace{3em}}cl}
$\aleph$   & \verb"\aleph"   & $\prime$       & \verb"\prime"       \\
$\hbar$    & \verb"\hbar"    & $\emptyset$    & \verb"\emptyset"    \\
$\imath$   & \verb"\imath"   & $\nabla$       & \verb"\nabla"       \\
$\jmath$   & \verb"\jmath"   & $\surd$        & \verb"\surd"        \\
$\ell$     & \verb"\ell"     & $\top$         & \verb"\top"         \\
$\wp$      & \verb"\wp"      & $\bot$         & \verb"\bot"         \\
$\Re$      & \verb"\Re"      & $\|$           & \verb"\|"           \\
$\Im$      & \verb"\Im"      & $\angle$       & \verb"\angle"       \\
$\partial$ & \verb"\partial" & $\triangle$    & \verb"\triangle"    \\
$\infty$   & \verb"\infty"   & $\backslash$   & \verb"\backslash"   \\
$\Box$     & \verb"\Box"     & $\Diamond$     & \verb"\Diamond"     \\
$\forall$  & \verb"\forall"  & $\sharp$       & \verb"\sharp"       \\
$\exists$  & \verb"\exists"  & $\clubsuit$    & \verb"\clubsuit"    \\
$\neg$     & \verb"\neg"     & $\diamondsuit$ & \verb"\diamondsuit" \\
$\flat$    & \verb"\flat"    & $\heartsuit$   & \verb"\heartsuit"   \\
$\natural$ & \verb"\natural" & $\spadesuit$   & \verb"\spadesuit"   \\
$\mho$     & \verb"\mho"     & & \\
\end{tabular}
\end{center}
\end{table}

\end{document}
