Index of /archives/text/CTAN/obsolete/macros/latex209/contrib/aasmacros
Name Last modified Size Description
![[PARENTDIR]](/icons/back.gif)
Parent Directory -
![[ ]](/icons/unknown.gif)
flushrt.sty 1993-01-12 09:00 153
![[ ]](/icons/tex.gif)
samptbls.tex 1993-01-05 09:00 185
![[TXT]](/icons/text.gif)
tighten.sty 1992-08-12 09:00 570
eqsecnum.sty 1993-01-05 09:00 596
mathsec.sty 1991-05-09 09:00 603
graphics.aux 1993-01-12 09:00 1.0K
sample1.tex 1993-01-19 09:00 1.8K
sample2.aux 1993-01-23 09:00 2.3K
Makefile 1993-02-08 09:00 2.4K
art8.sty 1992-12-29 09:00 4.4K
table3.tex 1993-01-03 09:00 5.1K
table2.tex 1993-01-03 09:00 6.5K
graphics.tex 1993-01-12 09:00 7.1K
samp2tbl.tex 1993-01-03 09:00 8.5K
paper1.tex 1991-05-10 09:00 10K
paper2.tex 1991-05-10 09:00 12K
kspp.tex 1993-01-11 09:00 12K
README 1993-02-15 09:00 14K
aaspptwo.sty 1993-01-23 09:00 14K
apjpt.sty 1993-01-18 09:00 14K
aj_pt.sty 1993-01-18 09:00 14K
aaspp.sty 1993-01-23 09:00 14K
aasms.sty 1993-01-23 09:00 14K
art8.doc 1990-09-04 09:00 15K
table1.tex 1993-01-03 09:00 18K
sample2.tex 1993-01-18 09:00 21K
![[ ]](/icons/a.gif)
sgi9259.eps 1991-05-10 09:00 24K
sgi9279.eps 1991-05-10 09:00 29K
manual.tex 1991-09-24 09:00 31K
aasms.doc 1993-01-22 09:00 45K
aaspp.doc 1993-01-22 09:00 45K
apjpt.doc 1993-01-22 09:00 45K
aj_pt.doc 1993-01-22 09:00 45K
aaspptwo.doc 1993-01-22 09:00 46K
sgi9289.eps 1991-05-10 09:00 65K
aastex.tex 1993-02-08 09:00 69K
% README -- Contents of the AASTeX macro package distribution
Thanks for your interest in the AASTeX macros for manuscript preparation.
This directory contains all the files in the distribution. They are
described briefly immediately below. Following the file descriptions
are short installation instructions, the generic recipe for printing the
user guide and samples, and information about contacting us regarding
the distribution.
README This file
aasms.doc Fully documented source for the "manuscript"
substyle. Contains macro definitions + comments.
aasms.sty LaTeX input style file for the "manuscript"
substyle. This is the .doc file stripped of
comments and unnecessary whitespace.
aaspp.doc Fully documented source for the "preprint"
substyle. Contains macro definitions + comments.
aaspp.sty LaTeX input style file for the "preprint"
substyle. This is the .doc file stripped of
comments and unnecessary whitespace.
aaspptwo.doc Documented source for a two-column preprint substyle.
aaspptwo.sty LaTeX input style file for two-column preprint
substyle.
aj_pt.doc Documented source for the AJ plano tables substyle.
aj_pt.sty LaTeX input style file for AJ plano tables substyle.
apjpt.doc Documented source for the ApJ plano tables substyle.
apjpt.sty LaTeX input style file for ApJ plano tables substyle.
art8.doc Documented 8pt style option.
art8.sty LaTeX input style file for the 8pt style option.
eqsecnum.sty Substyle file that enables equations to be
numbered with sections, rather than ordinally.
tighten.sty Substyle file that causes "manuscript" style
papers to be single-spaced rather than double.
epsf.sty A copy of Rokicki's epsf.sty file that is supplied
with dvips. It is included so that style files
can be interpreted, and so that authors can
include proper space for EPS files even if they
do not have dvips.
aastex.tex The user input guide for the package.
sample1.tex Minimal sample paper.
sample2.tex Sample paper with "typical" content and markup.
samp2tbl.tex "Long" table for sample, marked up as a plano
table in the manuscript.
samptbls.tex Plano tables sample. Sets style and includes:
table1.tex Sample plano table #1.
table2.tex Sample plano table #2.
table3.tex Sample plano table #3.
graphics.tex Initial proposal to WGAS and Pubs Board
suggesting standardized use of Encapsulated
PostScript for graphics inclusions.
sgi*.eps Encapsulated PostScript plots for graphics.tex.
kspp.tex Preprint format proposal from K.Sellgren to the
Pubs Board.
paper1.tex LaTeX source for June 1989 AAS poster.
paper2.tex LaTeX source for June 1990 AAS poster.
aastex30.tar.Z All of the above files can be retrieved at once
in this compressed tarfile, if desired.
INSTALLING THE STYLE FILES
The *.sty files must be "installed" so that LaTeX can read them. This
simply means that they must be placed either in (1) the user's working
directory containing the paper being processed [single-user installation],
or (2) in the TeX/LaTeX system input directory [site-wide installation].
Individuals who obtain the files for their personal use should just put
the files in the same directory that they usually use when preparing
papers, memos, etc. with LaTeX.
Sites that expect usage by several authors will probably find it preferable
to install the files in the standard TeX inputs area. In the parlances of
popular OS's, these areas are typically called
/usr/local/lib/tex/inputs Unix and variants
SOME$DISK:[TEX.INPUTS] VMS/Files-11 specification
C:\EMTEX\TEXINPUT DOS
The *.doc files are not actually read by LaTeX. They are the "source code"
files for the corresponding .sty files. The *.sty files are produced
mechanically from the *.doc files; these .sty files are never edited.
Most installations of LaTeX keep .doc and .sty files in the same directory
so that they can be easily found. We suggest doing the same with these.
The user's guide and sample papers could be kept in a system-wide TeX
inputs directory as well, but the system administrator may find it desirable
to change the filenames somewhat, since they are quite generic and prone
to filename collisions.
PRINTING THE GUIDE AND SAMPLES
The User Guide should be printed out for best results in reading it.
The Guide is written using the aaspp substyle from the AASTeX macro
package, and is therefore a LaTeX document. It must be processed by
LaTeX, resulting in a compiled, device-independent format (a .dvi file).
The DVI file has to be translated through a program that knows about the
specific printer you wish to print on; such a program is often called a
"DVI driver".
Suppose you wish to print on a PostScript laser printer, and that the
DVI driver on your computer system is called "dvips". The generic steps
to be followed to get hardcopy are
prompt> latex aastex
prompt> dvips aastex
prompt> print aastex.ps
There are various system- and program-specific eccentricities which
cannot be fully enumerated here. Some things to watch out for:
1. On some systems, TeX and LaTeX do not permit a filename extension
(the .tex) on the input file specification; .tex is assumed.
On other systems, it is optional.
2. Most DVI drivers do not require the .dvi extension on the input
filename. The extension of the output file (the one destined
for a specific printer) is variable, often a site-dependent
configuration parameter.
3. The user interfaces for DVI drivers are quite inconsistent.
Some operate in an interactive mode, asking the user about
variable setup parameters, while some only accept control
input on the command line.
4. On some systems, the DVI translation and printing are combined,
so one would enter only one OS command after running LaTeX.
There is no way for us to know details of your installation, so you must
inquire of the system administrator responsible for LaTeX, or hope that
someone has written the LaTeX "Local Guide" for your site.
ADMINISTRATIVE DETAILS
This package has been prepared by Chris Biemesderfer on behalf of the
AAS Executive Office. It has evolved from a project of the Working
Group on Astronomical Software (WGAS), chaired by Bob Hanisch of the
Space Telescope Science Institute in Baltimore. We would like to
express appreciation to the National Radio Astronomy Observatory and
National Optical Astronomy Observatories for their support of this
project during its germination.
Comments, suggestions, complaints, etc., can be sent electronically.
Community feedback is valuable, and will be retained and evaluated so
that we can coordinate the evolution of the package with the
requirements of editors and publishers as moderated by the AAS
Executive Office and the Publications Board.
cbiemes@noao.edu
7 Jan 1993
REVISION HISTORY
v1.0, Feb 1989
Original test version written at STScI and NRAO.
v2.0, Jun 1990
First public release of package to community following AAS meeting
in Albuquerque.
v2.1, May 1991
Changed style filenames: aasmanuscript -> aasms, aaspreprint -> aaspp
for benefit of DOS users, and to conform to Posix.
Fixed the textheight to compensate for header and footer space
so that page numbers will in fact be on the bottoms of the pages.
Updated journal abbreviations as per scheme agreed upon by various
editors and announced by Helmut Abt in ApJ 357, 1.
Added an assortment of symbols, etc. from Francois Schweizer.
v2.2, Aug 1991
Rewrote the tablenote code, using ideas from a style file posted
to the Usenet in June. This new implementation permits the use
of any identifying letters (or number for that matter) for the
notes, and will print them in the order specified by the user
rather than assuming alphabetical. In the process, fixed a bug
where the buffered tablenotes were not being erased from table
to table.
Revised the way journal abbreviations are typeset. Rather than
simply being a string, they are now processed through a macro and
the journal type style is parameterized.
Moved the WGAS ID footnote to the last page of references from
title page. There have been some "complaints" about this being
present at all, but it is the only way we can keep track of the
use of the package at this point, so we retain it.
v2.3, Aug 1992
Formalized naming convention for style files (see Stynames.spc).
Revisions for compliance with RevTeX markup.
Added some revtex@ parameters for software development and
tracking/reporting purposes. Changed mathsec substyle option
to eqsecnum (mathsec.sty -> eqsecnum.sty). Changed
\mathwithsecnums -> \eqsecnum. Changed \la -> \alt,
\ga -> \agt. Added \text for cased fractions.
Revised aasms to conform with preferences of UofC Press manuscript
editors. Such things as ragged right text, no hyphenation, proper
double spacing in tables, etc. are ensured. (G.Brady)
Fixed bug that resulted in the persistent \footnoterule in table
footnotes. (C.Pilachowski, P.Shopbell)
Added a Makefile to ease development.
v3.0, Dec 1992
Moved page numbers to top of pages, per request from ApJ
editorial office. Created "plaintop" pagestyle for MSs that
numbers pages at the top of the sheet, centered.
Added \tablerefs, \tablecomments, \cutinhead, and \sidehead,
macros to facilitate handling complexities in ApJ/AJ tables.
Added plano tables styles (non-trivial!). This includes some
new author markup that is applicable to "long" tables in MSs
as well. Added a "planotables" environment, and commands
for identifying structural parts of the table: \tablewidth,
\tablecaption, \tablehead, \colhead, \tableheadfrac, \tabletail,
\startdata, \nodata, \nl, \tablevspace, \tablebreak, and, in
the plano style files, \ptlandscape.
Fixed bug with preliminary plano tables that prevented \nodata
symbol to be justified with numerals (usually r). The ellipsis
or em-dash (or whatever) now centers horizontally as well as
vertically. (C.Pilachowski, G.Brady)
Added some internal parameterization and control of automatic
upper-casing of section heads, etc. Authors should NOT be
instructed to upper case anything; the style should do this
when necessary. See remarks in .doc file for more information
about how the style designer can control this "easily".
Footnotes in MSs are same size as body text.
Fixed bug in \altaffiltext so that increment LaTeX footnote now
increments with alternate affiliation footnotes. The first
footnote called out in the text will then be properly numbered
N+1, where N is the number of \altaffiltexts.
Added markup for ionization state: \ion.
Added \singlespace, \doublespace so that leading can be
adjusted by authors. Use of these is not encouraged.
Changed \keywords syntax. Authors are now required to provide
proper punctuation in the keyword list. The earlier attempt at
parsing the keywords was problematic.
Added EPS inclusion macros. These are designed to work with
Rokicki's dvips program. There is some concern that these
should have been designed to work with psfig instead. My
opinion about that is that intermediate layer (psfig) is
redundant with this package and by relying on it we require
authors to have two additional add-on packages (dvips and
psfig) rather than one. The psfig package and the EPS part
of the AASTeX package both serve the same purpose, namely,
to isolate the author from the details of the DVI driver.
The AASTeX package goes a bit farther in explicilty defining
descriptive markup semantics for specifying external plot files.
Revisions for compliance with RevTeX markup.
Changed \tightenlines -> \tighten. Changed \alt -> \lesssim,
\agt -> \gtrsim. Changed \text -> \case. Added \slantfrac.
Changed \applopt -> \ao.
Added slug line markup for assorted administrative details.
\revised, \paperid, \ccc, \cpright, \rectohead, \versohead, and
\slugcomment can all be used in preamble. Formatting for slug
line data has been isolated in internal \@dates, \@runheads,
\@slug, and \@makeslugcmmnt. \@journalname and \cpr@holder
have been added as internal parameters.
Added \authoraddr front matter (or back matter, whatever)
command for specifying author's postal address. This is the
address that is preferred for correspondence.
Added \markcite to correspond with references environment
to provide non-BibTeX-based citation and reference list
markup. \markcite does not do anything typographically in
AAS styles because the citation call-out style is straight
text. This is included partly for symmetry, but mostly
because we want to start training authors to identify
structure in their manuscripts. In the future, browsers
with hypertext-like capabilities will be widely available
to build linkage between citations, references, and the
articles being cited/referenced, and this will facilitate
preparation of the articles for such systems.
Changed \appendix to reset the equation counter and to
redefine \theequation.
Added mathletters environment to support "subequations".
This environment is used to suspend incrementing of the
primary equation counter in favor of a secondary one, so
that related equations can be grouped with the same
identifying number while still being separately identified
with lower case letters. I originally called this new
environment "letteredsubeqn" but changed to "mathletters"
for RevTeX compliance.
Added \eqnum, \tablenum, and \figurenum commands to enable
authors to override LaTeX automatic numbering for equations,
tables and figures. The corresponding LaTeX counter is NOT
auto-incremented when these commands are used. The commands
function by temporarily overriding \the<counter>; formatting
defined by \@eqnnum, \fnum@table, and \fnum@figure is not
affected. Note that these commands must be used *inside* the
appropriate displayed equation or float environment.