\documentstyle[12pt]{article}
\topmargin 0 pt 
\oddsidemargin 0pt \evensidemargin 0pt
 \marginparwidth 90pt
\textwidth 453pt
\textheight 663pt
\pagestyle{myheadings}
\def\sLaTeX{L\kern-.36em\raise.3ex\hbox{\small\sl A}\kern-.15em\TeX}
\markright{\protect\sLaTeX\ 
Document Styles {\protect\tt art-jgr} and {\protect\tt art-grl}}
\thispagestyle{plain}
\parindent=0pt \parskip=1em
\def\b{\tt \backslash}
\chardef\backslash=`\\
\def\g{]}
\chardef\<=`\{
\chardef\>=`\}
\def\BibTeX{{\rm B\kern-.05em{\sc i\kern-.025em b}\kern-.08em
    T\kern-.1667em\lower.7ex\hbox{E}\kern-.125emX}}

\begin{document}
\begin{center}
\large\bf
L\kern-.36em\raise.3ex\hbox{\normalsize\bf A}\kern-.15em\TeX\ 
Document Styles {\tt art-jgr} and {\tt art-grl} \\and the Use of 
B\kern-.05em{\normalsize\bf I}\kern-.025em{\normalsize\bf B}\kern-.08em\TeX
\end{center}

This document describes the \LaTeX\ document styles {\tt art-jgr} and {\tt
art-grl} that I have written for producing camera-ready copy in JGR and GRL
formats. They may also be used to make manuscripts or preprints that looks
exactly like a JGR or GRL reprint.

A sample file is provided illustrating how the extra commands are used.
By changing the options in the \verb!\documentstyle! line, it may be formatted
as one-column (camera-ready copy), two-column (as reprint), and draft (as
manuscript), both for JGR and for GRL. Some other variations are shown, such as
how the author names appear, as well as with and without \BibTeX, with the
`other' method commented out. The user may experiment with these alternatives
him/herself.

The document styles are called in one of several ways:

\begin{description}\sloppy
\item[\b documentstyle[draft\g \<art-jgr\>]
  Makes a manuscript version, double spaced, with title and abstract each on
  their own pages. This should be the original form for making up working 
  manuscripts for submission.
\item[\b documentstyle[12pt,draft\g \<art-jgr\>]
  Same as above, but with bigger type. With {\tt draft} option, {\tt11pt} and
  {\tt12pt} are different.
\item[\b documentstyle\<art-jgr\>]
  Camera-ready copy is produced, just as JGR wants it for publication.
  This is for the last step of paper submission, when all corrections have
  been made. 
\item[\b documentstyle[11pt\g \<art-jgr\>]
  The same as above but magnified by 25\%. This is so better resolution
  is achieved after JGR reduces the output. One may also call for {\tt 12pt}
  but the result is the same as for {\tt11pt}.
\item[\b documentstyle[twocolumn\g \<art-jgr\>]
  A preprint is produced looking just like a JGR reprint.
  Figures and tables should be included within the text, not at the end.
  This feature is not really required, but may be used to see how the final
  reprint will appear, and to estimate how many pages it needs.
\item[\b documentstyle[\<art-grl\>] All the possibilities listed above
  are also available for {\tt art-grl} as well except that camera-ready copy
  comes in only one size: no 25\% magnification.
\end{description}

Additional options available:
\begin{description}
\item[\tt a4] to set up the page size for European A4 paper.

\item[\tt secnum] to print section numbers, default being no numbers.
  \end{description}

\newpage
\begin{center}
\large New commands that are available with these options
\end{center}
\begin{description}
\item[\b printfigures] in preamble, adds the figures, one per page at the very
  end of the paper, in addition to the page of figure captions; is only
  meaningful when the {\tt figure} and {\tt plate} environments contain more
  than just a caption.

\item[\b figmarkoff] turns off the automatic marginal notes beside each
  figure, table, and plate definition.

\item[\b figmarkon] turns the marginal notes back on.

\item[\b title\<{\em Title}\>] as in {\tt article}.

\item[\b author\<{\em authorlist}\>] see samples for the proper application.

\item[\b titlemark\<{\em symbol}\>] writes a footnote symbol in the author list.

\item[\b titlenote\<{\em text}\>] writes text for a footnote in the author list.

\item[\b paperno\<{\em agu\_no}\>] inserts the AGU paper number, necessary for
  the JGR supplemental abstract.

\item[\b copyright\<{\em text}\>] writes the copyright notice with given text.

\item[\b date\<{\em text}\>] writes additional information on title page or 
  above title; e.g., ``Submitted to J.G.R. on 12 December 1989.''

\item[\b iftwocol\<{\em yes}\>\<{\em no}\>] allows alternative texts for
  {\tt twocolumn} mode (preprint) or other ({\tt draft} or camera-ready).

\item[\b sublabon\<{\em counter}\>] switches automatic numbering for the
  specified counter to the form 4{\it a}, 4{\it b}, 4{\it c}, etc.  One may
  specify {\em counter\/} as one of {\tt equation}, {\tt figure}, {\tt plate},
  {\tt table}.  The main number ceases to change and only the letter
  increments.

\item[\b sublaboff\<{\em counter}\>] switches off the sub-labelling for
  the specified counter.
  
\item[\b begin\<acknowledgements\>...\b end\<acknowledgements\>] for entering
  the awknowlegements. May be typed either in the British or American way
  ({\tt acknowledgments}). In either case, the American spelling is put into
  the output.

\item[\b begin\<references\>...\b end\<references\>] for the list of
  references if \BibTeX\ is {\em not\/} being used. Even without \BibTeX, the
  standard {\tt thebibliography} should rather be used.

\item[\b begin\<authorlist\>...\b end\<authorlist\>] writes the author list
  with full addresses at the end of the text, as required by JGR and GRL.

\item[\b received\<{\em date 1}\>\<{\em date 2}\>\<{\em date 3}\>] writes the
  ``Dates received, revised, accepted'' at the end of text, as required by JGR
  and GRL.

\item[\b runninghead\<{\em text}\>\<{\em num}\>] writes the text for the
  running head {\em num\/} times (so that JGR can cut them out and paste them
  at the top of each page.

\item[\b balance] sees to it that in {\tt twocolumn} mode the two columns
  on the last page are equally long. It must be given somewhere within the
  first column of the last page.

\end{description}

%\newpage
\begin{center}
\large Figures, Plates, Tables
\end{center}
In addition to {\tt figure}, there is a new {\tt plate} environment that works
just the same way.

Figures, plates, and tables should be put in the text within an appropriate
environment at that location where they are first referred to. The figure and
plate captions will then be pri\documentstyle[12pt]{article}
\topmargin 0 pt
\oddsidemargin 0pt \evensidemargin 0pt
 \marginparwidth 90pt
\textwidth 453pt
\textheight 663pt
\pagestyle{myheadings}
\def\sLaTeX{L\kern-.36em\raise.3ex\hbox{\small\sl A}\kern-.15em\TeX}
\markright{\protect\sLaTeX\
Document Styles {\protect\tt art-jgr} and {\protect\tt art-grl}}
\thispagestyle{plain}
\parindent=0pt \parskip=1em
\def\b{\tt \backslash}
\chardef\backslash=`\\
\def\g{]}
\chardef\<=`\{
\chardef\>=`\}
\def\BibTeX{{\rm B\kern-.05em{\sc i\kern-.025em b}\kern-.08em
    T\kern-.1667em\lower.7ex\hbox{E}\kern-.125emX}}

\begin{document}
\begin{center}
\large\bf
L\kern-.36em\raise.3ex\hbox{\normalsize\bf A}\kern-.15em\TeX\
Document Styles {\tt art-jgr} and {\tt art-grl} \\and the Use of
B\kern-.05em{\normalsize\bf I}\kern-.025em{\normalsize\bf B}\kern-.08em\TeX
\end{center}

This document describes the \LaTeX\ document styles {\tt art-jgr} and {\tt
art-grl} that I have written for producing camera-ready copy in JGR and GRL
formats. They may also be used to make manuscripts or preprints that looks
exactly like a JGR or GRL reprint.

A sample file is provided illustrating how the extra commands are used.
By changing the options in the \verb!\documentstyle! line, it may be formatted
as one-column (camera-ready copy), two-column (as reprint), and draft (as
manuscript), both for JGR and for GRL. Some other variations are shown, such as
how the author names appear, as well as with and without \BibTeX, with the
`other' method commented out. The user may experiment with these alternatives
him/herself.

The document styles are called in one of several ways:

\begin{description}\sloppy
\item[\b documentstyle[draft\g \<art-jgr\>]
  Makes a manuscript version, double spaced, with title and abstract each on
  their own pages. This should be the original form for making up working
  manuscripts for submission.
\item[\b documentstyle[12pt,draft\g \<art-jgr\>]
  Same as above, but with bigger type. With {\tt draft} option, {\tt11pt} and
  {\tt12pt} are different.
\item[\b documentstyle\<art-jgr\>]
  Camera-ready copy is produced, just as JGR wants it for publication.
  This is for the last step of paper submission, when all corrections have
  been made.
\item[\b documentstyle[11pt\g \<art-jgr\>]
  The same as above but magnified by 25\%. This is so better resolution
  is achieved after JGR reduces the output. One may also call for {\tt 12pt}
  but the result is the same as for {\tt11pt}.
\item[\b documentstyle[twocolumn\g \<art-jgr\>]
  A preprint is produced looking just like a JGR reprint.
  Figures and tables should be included within the text, not at the end.
  This feature is not really required, but may be used to see how the final
  reprint will appear, and to estimate how many pages it needs.
\item[\b documentstyle[\<art-grl\>] All the possibilities listed above
  are also available for {\tt art-grl} as well except that camera-ready copy
  comes in only one size: no 25\% magnification.
\end{description}

Additional options available:
\begin{description}
\item[\tt a4] to set up the page size for European A4 paper.

\item[\tt secnum] to print section numbers, default being no numbers.
  \end{description}

\newpage
\begin{center}
\large New commands that are available with these options
\end{center}
\begin{description}
\item[\b printfigures] in preamble, adds the figures, one per page at the very
  end of the paper, in addition to the page of figure captions; is only
  meaningful when the {\tt figure} and {\tt plate} environments contain more
  than just a caption.

\item[\b figmarkoff] turns off the automatic marginal notes beside each
  figure, table, and plate definition.

\item[\b figmarkon] turns the marginal notes back on.

\item[\b title\<{\em Title}\>] as in {\tt article}.

\item[\b author\<{\em authorlist}\>] see samples for the proper application.

\item[\b titlemark\<{\em symbol}\>] writes a footnote symbol in the author list.

\item[\b titlenote\<{\em text}\>] writes text for a footnote in the author list.

\item[\b paperno\<{\em agu\_no}\>] inserts the AGU paper number, necessary for
  the JGR supplemental abstract.

\item[\b copyright\<{\em text}\>] writes the copyright notice with given text.

\item[\b date\<{\em text}\>] writes additional information on title page or
  above title; e.g., ``Submitted to J.G.R. on 12 December 1989.''

\item[\b iftwocol\<{\em yes}\>\<{\em no}\>] allows alternative texts for
  {\tt twocolumn} mode (preprint) or other ({\tt draft} or camera-ready).

\item[\b sublabon\<{\em counter}\>] switches automatic numbering for the
  specified counter to the form 4{\it a}, 4{\it b}, 4{\it c}, etc.  One may
  specify {\em counter\/} as one of {\tt equation}, {\tt figure}, {\tt plate},
  {\tt table}.  The main number ceases to change and only the letter
  increments.

\item[\b sublaboff\<{\em counter}\>] switches off the sub-labelling for
  the specified counter.

\item[\b begin\<acknowledgements\>...\b end\<acknowledgements\>] for entering
  the awknowlegements. May be typed either in the British or American way
  ({\tt acknowledgments}). In either case, the American spelling is put into
  the output.

\item[\b begin\<references\>...\b end\<references\>] for the list of
  references if \BibTeX\ is {\em not\/} being used. Even without \BibTeX, the
  standard {\tt thebibliography} should rather be used.

\item[\b begin\<authorlist\>...\b end\<authorlist\>] writes the author list
  with full addresses at the end of the text, as required by JGR and GRL.

\item[\b received\<{\em date 1}\>\<{\em date 2}\>\<{\em date 3}\>] writes the
  ``Dates received, revised, accepted'' at the end of text, as required by JGR
  and GRL.

\item[\b runninghead\<{\em text}\>\<{\em num}\>] writes the text for the
  running head {\em num\/} times (so that JGR can cut them out and paste them
  at the top of each page.

\item[\b balance] sees to it that in {\tt twocolumn} mode the two columns
  on the last page are equally long. It must be given somewhere within the
  first column of the last page.

\end{description}

%\newpage
\begin{center}
\large Figures, Plates, Tables
\end{center}
In addition to {\tt figure}, there is a new {\tt plate} environment that works
just the same way.

Figures, plates, and tables should be put in the text within an appropriate
environment at that location where they are first referred to. The figure and
plate captions will then be printed at the end in camera-ready and draft
modes. Similarly, all the tables will appear after the figure captions.
A marginal note is printed where the environment is defined, unless
\verb!\figmarkoff! has been given.

Each {\tt figure} and {\tt plate} environment must contain {\em one and only
one\/} \verb!\caption!  command. They may also contain picture generating
commands ({\tt picture} mode) or importing commands. These will be ignored on
the page of figure captions. However, if \verb!\printfigures! is given in the
preamble, then all the figures will be outputted at the very end of the paper,
one per page, no page numbers, page width 15~cm.

Examples:\\
\hspace*{1em}\begin{minipage}{250pt}
\begin{verbatim}
\begin{figure}
  \vspace{6cm}
  \caption{\label{fig:samp1}
    Text of the Figure caption...}
\end{figure}
\end{verbatim}
\end{minipage}\hfill\parbox{170pt}{\sloppy Leaves enough space to paste in a
figure later. This will be for {\tt twocolumn} preprint mode. In the other
modes, only the caption is printed on a special page at the end.}

\hspace*{1em}\begin{minipage}{250pt}
\begin{verbatim}
\begin{figure}
  \setlength{\fboxsep}{0pt}
  \setlength{\unitlength}{1cm}
  \fbox{\begin{picture}(8,6)
    \put(4,3){\makebox(0,0){Paste Here}}
  \end{picture}}
  \caption{\label{fig:samp1}
    Text of the Figure caption...}
\end{figure}
\end{verbatim}\end{minipage}\hfill
\parbox{170pt}{\sloppy Makes a box around the area for the figure, in this case
$8\times6$~cm, with some text in the center. This box will be missing from the
page of figure captions, but will appear at the very end if
{\b printfigures} is in the preamble.}

\hspace*{1em}\begin{minipage}{250pt}
\begin{verbatim}
\begin{figure}
  \epsfysize9cm \epsfbox{sample.eps}
  \caption{\label{fig:samp1}
    Text of the Figure caption...}
\end{figure}
\end{verbatim}\end{minipage}\hfill
\parbox{170pt}{\sloppy Imports an encapsulated Post\-Script file {\tt
sample.eps} and scales it to a height of 9~cm. Again this diagram is missing
on the figure captions page, but appears at the very end if {\b printfigures}
has been given in the preamble.}

\newpage
\begin{center}
\large \BibTeX
\end{center}
In order to use \BibTeX, the author must put all the literature references
into one or more bibliographical data bases. An example with fictitious
entries is included with these package ({\tt sample.bib}). A complete
description of how to use \BibTeX\ is given in the \LaTeX\ manual, but there
are some extra features that I have added.

References to the literature are not made in the text as
\verb![Daly {\it et al.} 1989]!, but rather as \verb!\cite{daly89}!.
The key {\tt daly89} is the identifying name for the reference that appears in
the data base. Just how \verb!\cite! is interpreted (as a number, author name
and date, or some other symbol) depends on the selected {\tt
bibliographystyle}. The appropriate style for {\tt jgr} and {\tt grl} options
is {\tt agu}. I have changed the application of \verb!\cite! slightly so that it
fits in with JGR usage.\\
\renewcommand{\arraystretch}{1.2}
{\centering
\begin{tabular}{ll}
in text & output\\
\verb!\cite{daly89}! & Daly {\it et al.} [1989]\\
\verb!\cite[]{daly89}! & [Daly {\it et al.}, 1989]\\
\verb!\cite[e.g. ]{daly89}! & [e.g.~Daly {\it et al.}, 1989]\\
\verb!\cite{daly89,rich88}! & Daly {\it et al.} [1989]; Richter and Schwenn
[1988]\\
& {\it etc.}
\end{tabular}}

At the location in the text where the list of references should appear, one
gives the following\\
\verb!\bibliographystyle{agu}!\newline
\verb!\bibliography{filename1,filename2,...}!\newline
where the file names are those of various bibliography data bases to be
searched (extension {\tt .bib}).

Alternatively, one can write the bibliography oneself:
\begin{verbatim}
  \begin{thebibliography}{}
    \bibitem[Daly {\it et~al.}(1989)]{daly89}
%           |--------citation-------||-key--|
      Daly, P.~W., E. Kirsch ....
      . . . . . . .
   \end{thebibliography}
\end{verbatim}
Note that the year is written in parentheses () in the citation. This is the
text that appears where the \verb!\cite{daly89}! is given, but the ()'s are
replaced by [] or by nothing depending on context.

In order to use bibliography data bases efficiently, it helps to have a
listing of their entries and especially of their keys. To this end I have
designed another bibliography style {\tt keylist} that can be used with the
file {\tt keylist.tex}. A batch job {\tt keylist.bat} simplifies the whole
procedure.  The file {\tt keylist.axx} is also needed for this. See
instructions within {\tt keylist.bat}.

\newpage
\begin{center}\large Printing the Sample Outputs \end{center}
This package includes a sample text file ({\tt samjgr.tex}) that may be
outputted in the various formats available: as camera-ready copy, as
double-column reprint, as draft manuscript, for JGR and for GRL. It is only
necessary to alter the \verb!\documentstyle! options accordingly. Provision is
made to run it with or without \BibTeX, by commenting out certain lines as
described in the file.  The two ways of giving author affiliation are also
shown, and may be easily altered.  The idea is that one can learn more from
the input text as an example and comparing it with the output.

To generate the output, one must \LaTeX{} (or compose) the {\tt samjgr.tex}
file.  If \BibTeX\ is used, it must be processed further, first with {\tt
bibtex} and then {\em at least twice\/} with {\tt latex} again, until the
message {\tt LaTeX Warning: Label(s) may have changed...} no longer appears.

The complete list of files in this package is:\\
\hspace*{1cm}
\begin{tabular}{r@{\tt.}lp{10cm}}
\tt agu      & \tt bst & AGU bibliography style definition (for \BibTeX)\\
\tt art-agu  & \tt doc & Source file with comments for both style files\\
\tt art-grl  & \tt sty & GRL style option, comments removed\\
\tt art-jgr  & \tt sty & JGR style option, comments removed\\
\tt changes  & \tt v41 & List of changes between versions 4.0 and 4.1\\
\tt changes  & \tt v42 & List of changes between versions 4.1 and 4.2\\
\tt guide    & \tt tex & Source text for this Guide\\
\tt jgrman   & \tt tex & A manual for the JGR and GRL style options\\
\tt keylist  & \tt bst & Bibliography style definition for {\tt keylist}\\
\tt keylist  & \tt tex & A {\tt .tex} file that lists the contents of a
bibliographic data base with its keys\\
\tt makesty  & \tt tex & A driver for the {\tt docstrip} program, which when
\TeX'd extracts the two {\tt .sty} files from {\tt art-agu.doc}. Requires that
{\tt docstrip.tex} be in the system\\
\tt samjgr   & \tt tex & Sample text file for experimenting\\
\tt sample   & \tt bib & Bibliography data base for the samples\\
\tt read     & \tt me  & An information file (Ascii)
\end{tabular}

\vspace{2em}
\hbox to \hsize{\hss Patrick W. Daly, 1993 July 23}

\end{document}
