doc/latex

git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 266 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/asaetr/asaetr.tex b/Master/texmf-dist/doc/latex/asaetr/asaetr.tex
new file mode 100644
index 00000000000..7227f3b6f58
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/asaetr/asaetr.tex
@@ -0,0 +1,266 @@
+% 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}