path: root/Master/texmf-dist/doc/latex/asaetr/asaetr.tex

% asaetr.tex v1.0 01 Jan 92
\documentstyle{asaetr}
\title{\LaTeX\ and  
       B\kern-.05em{\large I}\kern-.025em{\large B}\kern-.08em\TeX\ 
       for ASAE Papers\thanks{Written for presentation as the 1992 
               International WinterMeeting of ASAE.}
      }
\author{J.~D.~McCauley\thanks{USDA Fellow, Department of Agricultural
       Engineering, Purdue University. Formerly, 
       Graduate Assistant--Research, Department of Agricultural
       Engineering, Texas A\&M University. ({\tt jdm5548@diamond.tamu.edu}).}
       \student
       %\and
       %A.~D.~Whittaker \member
       }
       % the format is: name \membership_grade, where membership_grade
       % is one of ( \member, \associate, \student, \affiliate, \fellow) 
\begin{document}
\bibliographystyle{asaetr}
\maketitle

\begin{abstract}
A \LaTeX\ style for the American Society for Agricultural Engineers
(ASAE) is discussed. This is not official and not (yet) an accepted
way to submit articles to ASAE.  {\em This is NOT an ASAE Transcations
article.} \keywords{\LaTeX,\ \BibTeX,\ typesetting, ASAE Transactions.}
\end{abstract}

\section{Introduction}
\drop{T}his document, when compared to source code,
instructs someone on the use of {\tt asaetr.sty}, a \LaTeX\ style file
for writing documents that look like {\it ASAE Transactions} articles.
Examples of section headers, itemized lists, tables, and figures are
given. Hopefully, a document written using the default {\tt article}
style in \LaTeX\ could be transformed to look like a {\em
Transactions} article by only a few changes.

The American Society of Agricultural Engineers editorial staff
encourages authors to submit electronic manuscripts in the following
formats: MacWrite, MS--Word, MS--Works (preferably Version 2.0),
WordPerfect (Version 5.0 or later), and WriteNow \cite{asaeins} (ASAE,
1991).  Though \LaTeX\ is not an accepted format to submit articles to
ASAE, it does have utility when predicting page length and appearance
of an article that you submit. Predicting page length is especially
important when submitting ``Technical Notes'' (which cannot exceed two
pages) and when trying to avoid unnecessary page charges.

It should be emphasized that this document was written as an example
of use of the style files; it's value is greatly enhanced if you
compare it with source code (see a later section for instructions) and
a copy of {\em ASAE Transactions}.

\subsection{Objective}

The objective of this work was to develop \LaTeX\ and \BibTeX\
style files for ASAE members.

\subsubsection{Finer Objectives}
Well, that sounds pretty noble, but I also wanted to
\begin{enumerate}
\item Make it easier on myself (because I'm a programmer, and programmers
are lazy),
\item Encourage a friend to switch to \TeX\, and
\item Show you the use of a  \verb#\subsubsection# heading and the 
{\tt enumerate} environment.
\end{enumerate}

\paragraph{Test Heading} 
This is a test of level four headings.

\section{Getting Started}

If you're unfamilar with \LaTeX, I would suggest picking up a copy of
the manual (Lamport, 1986) \cite[note]{ll:86} and putting this paper
aside for a while. If you're already familiar, read on.

\subsection{The Preamble}
The preamble is where tell \LaTeX\ that you are going to use {\tt
asaetr.sty}.  It's also where you list the authors and ASAE membership
grades. Here's an example:
\small \begin{verbatim}
\documentstyle{asaetr}
\title{Boring Title}
\author{U.\ B.\ Boring \fellow \and 
       I.\ M.\ Young \student \and
       R.\ U.\ Happy \nonmember   }
\begin{document}
\maketitle
\end{verbatim} \normalsize
I have used up to four authors and still got it fit on one line.  Five
authors may fit, depending on the lengths of the names. If they don't
all fit, two rows of authors will be formed. Membership grades can be
any of
\small \begin{verbatim}
 \member, \associate, \student, 
 \affiliate, or \fellow. 
\end{verbatim} \normalsize
\noindent
You can also use \verb#\nonmember#, but it has the same effect
as leaving the membership grade off. The \verb#\maketitle# command
simply tells \LaTeX\ to use this author and title information to
compose the title of the paper.

\subsection{The Abstract}

After the preamble comes the abstract. Here's an example:
\small\begin{verbatim}
\begin{abstract}
This is going to be short. See, I told you.
\keywords{brevity, terseness, words.}
\end{abstract}
\end{verbatim}\normalsize
This should be straightforward enough.

\subsection{The Body}
The commands that you should be most familiar with to typeset the
body of your paper are the sectioning commands. They are
\begin{description}
\item[section:] Same  level as the Introduction.
\item[subsection:] Secondary headings, such as 
``Objectives.'' 
\item[subsubsection:] Third level headings.
\item[paragraph:] Avoid fourth level headings.
\end{description}
The usage of these commands can be best described by an example:
\begin{verbatim}
\subsection{The Body}
\end{verbatim}
This is the sectioning command for the section you are now reading.  

You may want to avoid fourth level headings because it requires an
additional font for your \TeX\ installation: {\tt cmcscsl10}.  This is
a slanted, small caps font. If you have \MF\ working on your system,
this is not a problem.  Source code for this font is available with
the style files. Ask you local \TeX\ guru for help, should you need
it.

\subsection{Figures and Tables}

If you have a \PS\ printer available, it's highly recommended that you
use the \verb# \psfig# macros written by Trevor Darrell to include
high quality figures. Another useful utility for including figures is
{\tt fig} (or {\tt xfig} if you use X Windows).  Figure 1 was created
in about 30 seconds using {\tt xfig}. You can get {\tt fig} from {\tt
cayuga.cs.rochester.edu} by anonymous ftp. Remember that in {\em
Transactions of the ASAE}, captions for figures go {\em below} the
figures.

\renewcommand{\footnoterule}{} % no line
\begin{table}[hbp]
\footnotesize
\caption{Comparison of Publishing Tools}
\begin{center}
\begin{minipage}{\columnwidth}
\renewcommand{\footnoterule}{} % no line
\begin{center}
\renewcommand{\thefootnote}{\fnsym{footnote}}
\begin{tabular}{lrrrrrr}  \thickhline  
Tool & \multicolumn{3}{c}{Learning Curve\footnote{1.0 being easiest.} 
  }& \multicolumn{3}{c}{Support\footnote{10.0 being the best.}}\\ 
& \multicolumn{3}{c}{($units$)} & \multicolumn{3}{c}{($units$)}\\ \thinhline 
FrameMaker && 5.0 && 6.0 \\  
Troff && 10.0 && 1.0 \\
\TeX \footnote{\TeX\ is the winner!} && 7.0 && 10.0  \\ \thickhline
\end{tabular}
\linethickness{0pt}
\end{center}
\end{minipage}
\end{center}
\end{table}

\begin{figure}[htb]
  \setlength{\unitlength}{0.1mm} %{0.00625in}%{0.0125in}%
  \begin{center}
    \begin{picture}(181,181)(0,0)
      \thinlines \multiput(80,80)(-20,-20){4}{\framebox(80,80){}}
      \thicklines \put(0,0){\framebox(180,180){}} 
      \put(60,60){\line( 1, 1){ 60}}
    \end{picture}
  \end{center}
  \caption{Primitive figure.} 
\end{figure}

If you plan to include tables, and if you want to have footnotes
within these tables, use the {\tt minipage} environment.  Contact
your local \LaTeX\ guru or see your {\em local guide} for more
information about how to code tables. The source code for this paper
also provides good information.  You'll notice in {\em Transactions of
the ASAE} or in {\em Applied Engineering in Agriculture} they use
thicker lines for the top and bottom rules in tables. Instead of
having to change line thickness yourself (as you do in using document
style ``article'' and others), you can use two macros that come with
this style: \verb#\thickhline# and \verb#\thinhline#.  See the example
table in this document (Table 1).  Don't forget to put the caption
{\em above} the table instead of below it.

\subsection{The References}

\BibTeX\ automatically generates the ``References'' section of your
paper from an external database.  Style files govern to appearance of
your ``References'' section.  In principle, you could change a paper,
which met the requirements of one professional society, to that of
another by simply changing the style file that you use.  The style
file {\tt asaetr.bst} (for ASAE) is currently being developed.  Other
style files exist for IEEE, ACM, APA, etc.

To use \BibTeX, you normally process your file with \LaTeX, then with
\BibTeX, then twice more with \LaTeX. The \BibTeX\ style file, which 
is unfinished, comes close to the citation style used by ASAE. You may
have to edit some entries by hand. To do this, edit the {\tt *.bbl}
file after you have processed the file with \BibTeX.  See Appendix B
in \cite{ll:86} (Lamport, 1986) for more information about \BibTeX.

\subsection{Submission}
When you submit to ASAE, they want a double--spaced, single--column
document with figures and tables on separate pages.  If you've written
you document using

\noindent{\verb#\documentstyle{asaetr}#,}\par
\noindent simply change that first line to read\par
\noindent{\verb#\documentstyle[asaesubmit]{asaetr}#.}\par
\noindent This makes all the changes necessary.

\section{Where to Find}
This collection of files discussed in this paper include:
\begin{description}
\item[asaetr.sty:] \LaTeX\ style 
\item[asaesubmit.sty:] for paper submissions to ASAE
\item[asaetr.bst:] \BibTeX\ style 
\item[asaetr.tex:] example usage of and documentation for above (source for
           this document)
\item[asaetr.bib:] part of the above example
\item[cmcscsl10.mf:] \MF\ source for level four heading font
\end{description}

A copy of this collection of style files can be obtained via
anonymous ftp:
\small \begin{verbatim}
% ftp sun.soe.clarkson.edu
Connected to sun.soe.clarkson.edu.
Name (sun.soe.clarkson.edu:jdm5548): anonymous
331 Guest login ok, send ident as password.
Password: jdm5548@diamond.tamu.edu
230 Guest login ok, access restrictions apply.
ftp> cd pub/tex/latex-style
250 CWD command successful.
ftp> mget asae*
...
ftp> quit
\end{verbatim}\normalsize
\noindent
To retrieve this collection via electronic mail, send a MAIL message to

\centerline{\tt FILESERV@SHSU.BITNET}
\noindent with the command:

\centerline{\tt SENDME ASAETR}

\section{Conclusion}

This file should serve as an excellent example of the use of the style
files.  If you still can't figure things out, hunt up your local guru
and ask him/her to explain \LaTeX\ and \BibTeX\ style files.

\bibliography{asaetr}
\end{document}