ascelike (10aug11)

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

5 files changed, 110 insertions, 22 deletions

diff --git a/Master/texmf-dist/doc/latex/ascelike/Readme b/Master/texmf-dist/doc/latex/ascelike/README
index b52678b1ec5..40a361ce479 100644
--- a/Master/texmf-dist/doc/latex/ascelike/Readme
+++ b/Master/texmf-dist/doc/latex/ascelike/README
@@ -12,6 +12,7 @@ I've also included example/documentation files:
                  especially in the use of the various options in ascelike.cls 
   ascexmpl.bib - An example *.bib bibliographic data base
   ascexmpl.dvi - Output from ascexmpl.tex and ascexmpl.bib
+  ascexmpl.pdf - Output from ascexmpl.tex and ascexmpl.bib
   ascexmpl.ps  - Output from ascexmpl.tex and ascexmpl.bib
 
 You can also find information on usage in the headings of these files,
@@ -25,4 +26,4 @@ NOTE:  The following supplementary files are REQUIRED:
 ascelike.cls will not work without these files.  You can obtain all of them
 from the CTAN archive (perhaps in *dtx form).
 
-Report problems and suggestions to Matthew R. Kuhn, kuhn@egr.up.edu
+Report problems and suggestions to Matthew R. Kuhn, kuhn@up.edu
diff --git a/Master/texmf-dist/doc/latex/ascelike/Readme.txt b/Master/texmf-dist/doc/latex/ascelike/Readme.txt
new file mode 100644
index 00000000000..40a361ce479
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ascelike/Readme.txt
@@ -0,0 +1,29 @@
+Unofficial LaTeX class and bibliography style-files for ASCE documents 
+(Amer. Soc. of Civil Engineers), both journal manuscripts and camera-ready 
+manuscripts for conference proceedings
+
+The two main files are
+  ascelike.cls - The document class file
+  ascelike.bst - The bibliography style file for creating bibliographic
+                 with the weird use of quotation marks, etc.
+
+I've also included example/documentation files:
+  ascexmpl.tex - An example *.tex file, which also serves as documentation,
+                 especially in the use of the various options in ascelike.cls 
+  ascexmpl.bib - An example *.bib bibliographic data base
+  ascexmpl.dvi - Output from ascexmpl.tex and ascexmpl.bib
+  ascexmpl.pdf - Output from ascexmpl.tex and ascexmpl.bib
+  ascexmpl.ps  - Output from ascexmpl.tex and ascexmpl.bib
+
+You can also find information on usage in the headings of these files,
+along with copyright/licence information.
+
+NOTE:  The following supplementary files are REQUIRED:
+  ifthen.sty    (part of the standard latex release)
+  setspace.sty  (produces doubles spacing for journal manuscripts)
+  endfloat.sty  (places figures and tables at the end of the manuscript)
+
+ascelike.cls will not work without these files.  You can obtain all of them
+from the CTAN archive (perhaps in *dtx form).
+
+Report problems and suggestions to Matthew R. Kuhn, kuhn@up.edu
diff --git a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.bib b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.bib
index a2000218ef1..603ad7f0d70 100644
--- a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.bib
+++ b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.bib
@@ -89,6 +89,32 @@
     NOTE         = "",
     }
 %
+@ARTICLE{Gaspar:2001a,
+    AUTHOR       = "Gaspar, N. and Koenders, M. A.",
+    TITLE        = "Micromechanic formulation of macroscopic
+                    structures in a granular medium",
+    JOURNAL      = "J. Engrg. Mech.",
+    YEAR         = 2001,
+    VOLUME       = 127,
+    NUMBER       = 10,
+    PAGES        = "987--993",
+    NOTE         = "",
+    }
+%
+@INCOLLECTION{Gaspar:2001b,
+    AUTHOR       = "Gaspar, N. and Koenders, M. A.",
+    TITLE        = "Estimates of the shear modulus of a granular assembly
+                    using heterogeneous media techniques",
+    EDITOR       = "Kishino, Y.",
+    BOOKTITLE    = "Powders and Grains 2001",
+    PUBLISHER    = "A.A. Balkema",
+    ADDRESS      = "Lisse",
+    YEAR         = 2001,
+    PAGES        = "389--392",
+    ORGANIZATION = "",
+    NOTE         = "",
+    }
+%
 @MANUAL{FHWA:1991a,
    AUTHOR        = "",
    KEY           = "Federal",
diff --git a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.pdf b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.pdf
index 2413b317fa1..80cf47af8e9 100644
--- a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.pdf
+++ b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.pdf
diff --git a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.tex b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.tex
index 498021dbdc3..021ebcc3a9b 100644
--- a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.tex
+++ b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.tex
@@ -1,6 +1,8 @@
 %
 \documentclass[Proceedings]{ascelike}
 %
+% Dec. 29, 2002
+%
 % NOTE: Don't include the \NameTag{<your name>} if you have selected 
 %       the NoPageNumbers option: this leads to an inconsistency.
 \NameTag{Kuhn}
@@ -13,12 +15,13 @@
 \author{
 Matthew R. Kuhn%
 \thanks{
-Dept. of Civ. and Env. Engrg.,
-School of Engrg., Univ. of Portland, 5000 N. Willamette Blvd.,
+Dept.\ of Civil Engrg.,
+Donald P.\ Shiley School of Engrg., Univ.\ of Portland, 
+5000 N.\ Willamette Blvd.,
 Portland, OR  97203. E-mail: kuhn@up.edu.},
 \ Member, ASCE
 %
-% I've found that the \and command doesn't quite work, so just use "and"
+% I have found that the \and command doesn't quite work, so just use "and"
 %  such as the following (and don't forget the ending curly brace `}').
 %\\
 %and
@@ -73,7 +76,7 @@ These files are typically included in \LaTeX\ distribution, such as the
 \textsf{tetex} and \textsf{MikTex} distributions.
 All three files are also freely available
 from the Comprehensive \TeX\ Archive Network (CTAN) archive,
-through \verb+//http:www.tug.org+, but they may need to be unbundled from
+through \verb+http://www.tug.org+, but they may need to be unbundled from
 a \verb+*.dtx+ form.
 In addition, the file \texttt{ascelike.bst} can be used with
 the tool \textsc{Bib}\TeX\ to produce ASCE-like 
@@ -82,7 +85,7 @@ quotation marks around titles, etc.).
 An example bibliographic data base is given in \texttt{ascexmpl.bib}.
 \par
 In addition to these important files,
-we have found the following packages most useful (and we'll use this
+we have found the following packages most useful (and we will use this
 opportunity to illustrate a \LaTeX\ itemized list):
 %
 \begin{itemize}
@@ -90,7 +93,7 @@ opportunity to illustrate a \LaTeX\ itemized list):
 \texttt{epsfig.sty} and its companion files for incorporating
 encapsulated post\-script (figure) files into the document
 \item
-\texttt{subfigure.sty} for arranging and numbering subfigures
+\texttt{subfigure.sty} for arranging and numbering sub-figures
 \item
 \texttt{amstex.sty} and its companion files for the AMS extensions
 to mathematical formatting.
@@ -106,10 +109,10 @@ Prepare your \verb+*.tex+ input file as a regular
 but, of course, substitute \texttt{ascelike} for \texttt{article}
 as the document class.
 You will, however, likely need to specify a number of options.
-In addition, I've provided two new commands: \verb+KeyWords+ and
+In addition, I have provided two new commands: \verb+KeyWords+ and
 \verb+NameTag+, both of which are described further below.
 Document class \texttt{ascelike.cls} has a the options given
-below (and we'll also use this opportunity to illustrate an enumerated list).
+below (and we will also use this opportunity to illustrate an enumerated list).
 The \verb+Proceedings|+\-\verb+Journal+ options are the most important;
 the other options are largely incidental.
 %
@@ -156,25 +159,52 @@ and figures that would normally be included in the \texttt{Journal}
 format.
 \item
 \texttt{NoPageNumbers} suppresses the printing of page numbers.
+\item
+\texttt{SectionNumbers} produces an automatic numbering of sections.
+Without the \texttt{SectionNumbers} option, sections will \emph{not} be
+numbered, as this seems to be the usual formatting in ASCE journals 
+(note that the appendices will, however, be automatically
+``numbered'' with Roman numerals).  
+With the \texttt{SectionNumbers} option, sections and
+subsections are numbered with Arabic numerals (e.g. 2, 2.1, etc.), but
+subsubsection headings will not be numbered.  To change this default
+depth of numbering when
+the option \texttt{SectionNumbers} is invoked, insert the following commands
+in the preamble of your document:\\[2mm]
+\begin{tabular}{ll}
+\verb!  \setcounter{secnumdepth}{1}! & Number sections only\\
+\verb!  \setcounter{secnumdepth}{3}! & Number sections, subsections, \\
+                                   & and subsubsections
+\end{tabular}\\[2mm]
+Even with the \texttt{SectionNumbers} option, you can use the ``starred''
+form, \verb!\section*{ }!, to create a section heading without numbers.
+This might be desirable for an Acknowledgements section at the end of
+a paper.  Note, however, that the starred form will not suppress
+the numbering of subsections or subsubsections.
 \end{enumerate}
 %
 \section{Sections, subsections, equations, etc.}
-I've included this section to test the formating of sections, subsections,
+I have included this section to test the formating of sections, subsections,
 subsubsections, equations, tables, and figures.
 Section heads are automatically made uppercase, which is great unless
 your section heading contains mathematics, \verb+$<math stuff>$+.
 If your head does contain mathematics, you will need to modify
 \texttt{ascelike.cls}, in particular the line containing the
-\verb+\uppercase+ command.
+\verb+\uppercase+ command.  
+To force mathematics symbols to become 
+bold within a section heading, try using
+the \verb!\boldmath! command before the in-line math,
+\verb!\boldmath$a_{i}=\sqrt{\beta}$!.
 %
-\subsection{An Example Subsection}
+\subsection{An Example Subsection with math, \boldmath$a_{i}=\sqrt{\beta}$}
 No automatic capitalization occurs with subsection headings; 
-you'll need to capitalize the first letter of each word,
+you will need to capitalize the first letter of each word,
 as in ``An Example Subsection.''
 %
 \subsubsection{An example subsubsection}
 No automatic capitalization occurs with subsubsections; 
-you'll need to capitalize only the first letter of the subsubsection heading.
+you will need to capitalize only the first letter of subsubsection 
+headings.
 And now we include an example of a displayed equation (Eq.~\ref{eq:Einstein})
 %
 \begin{equation} \label{eq:Einstein}
@@ -220,10 +250,10 @@ Assembly size & $54D_{50} \times 54D_{50} \times 54D_{50}$ \\
 \end{table}
 %
 \par
-I've added a new command \verb+\KeyWords{<your key words>}+ for
+I have added a new command \verb+\KeyWords{<your key words>}+ for
 a labeled list of key words.  
 It can be placed anywhere in the document and produces an unindented
-paragraph.
+paragraph of keywords at that location.
 %
 \section{Citations and bibliographic entries}
 When used together, \texttt{ascelike.cls} and \texttt{ascelike.bst}
@@ -231,21 +261,21 @@ produce APA~/ \emph{Chica\-go Manual of Style} citations in
 name-date format.
 The code for this format is a modification of the \texttt{chicago.sty} and
 \texttt{chicago.bst} packages.
-I've made available the following citation options:
+I have made available the following citation options:
 \begin{itemize}
 \item
 \verb+\cite{key}+ produces citations with full author 
 list and year \cite{Ireland:1954a}.
 \item
 \verb+\citeNP{key}+ produces citations with full author list and year, 
-but without enclosing parentheses: eg. \citeNP{Ireland:1954a}.
+but without enclosing parentheses: e.g. \citeNP{Ireland:1954a}.
 \item
 \verb+\citeA{key}+ produces citations with only the full 
 author list: e.g. \citeA{Ireland:1954a}
 \item
 \verb+\citeN{key}+ produces citations with the full author list and year, but
 which can be used as nouns in a sentence; no parentheses appear around
-the author names, but only around the year: eg. \citeN{Ireland:1954a}
+the author names, but only around the year: e.g. \citeN{Ireland:1954a}
 states that \ldots
 \item
 \verb+\citeyear{key}+ produces the year information only, within parentheses,
@@ -276,14 +306,16 @@ a two-part paper \cite{Frater:1992a,Frater:1992b},
 a university report \cite{Duan:1990a}, 
 an untitled item in the Federal Register \cite{FR:1968a}, 
 works in a foreign language \cite{Duvant:1972a,Reiffenstuhl:1982a},
-and software \cite{Lotus:1985a}.  
+software \cite{Lotus:1985a},
+and two works by the same author in the same year
+\cite{Gaspar:2001a,Gaspar:2001b}.  
 %
 \section{Miscellany}
 Many ASCE conference proceedings are now published on CD ROM media.
-I've noticed that instructions on paper formats issued by
+I have noticed that instructions on paper formats issued by
 conference organizers often differ from the
 standard ASCE instructions.  
-Fortunately most of the differences can be easily accomodated, such as
+Fortunately most of the differences can be easily accommodated, such as
 changes in the margins and placement of the authors' addresses.
 As for margins, these can, of course, be altered by using
 \verb+\setlength{<length>}+ commands within the preamble to a document without