ascelike (24aug11)

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

5 files changed, 491 insertions, 152 deletions

diff --git a/Master/texmf-dist/bibtex/bst/ascelike/ascelike.bst b/Master/texmf-dist/bibtex/bst/ascelike/ascelike.bst
index 5b6e3708ff1..d8c3f87900e 100644
--- a/Master/texmf-dist/bibtex/bst/ascelike/ascelike.bst
+++ b/Master/texmf-dist/bibtex/bst/ascelike/ascelike.bst
@@ -1,5 +1,8 @@
 %% File: ascelike.bst
 %%
+%% August 20, 2011
+%%
+%%
 %% An unofficial bibliography style-file for ASCE-like bibliographies.
 %%   Adapted from chicago.bst (24-jan-88 version) of Glenn Paulley
 %%   This bst style should be used with document class ascelike.cls 
@@ -64,7 +67,7 @@ ENTRY
     institution
     journal
     key
-%    month		not used in apalike
+    month
     note
     number
     organization
@@ -74,6 +77,7 @@ ENTRY
     series
     title
     type
+    url
     volume
     year
   }
@@ -413,6 +417,14 @@ FUNCTION {format.bvolume}
   if$
 }
 
+FUNCTION {format.howpublished}
+{ howpublished empty$
+  { "" }
+  { "(" howpublished * ")" *
+  }
+  if$
+}
+
 FUNCTION {format.number.series}
 { volume empty$
     { number empty$
@@ -502,7 +514,7 @@ FUNCTION {format.chapter.pages}
 { chapter empty$
     'format.pages
     { type empty$
-	{ "chapter" }
+	{ "Chapter" }
 	{ type "l" change.case$ }
       if$
       chapter tie.or.space.connect
@@ -671,6 +683,18 @@ FUNCTION {calc.label}
 % The change here from newapa is to also include organization as a
 % citation label if author or editor is missing.
 %
+% Changed - MRK.  With ASCE's author-year citation style, there is no
+% need for the first argument in the \citeauthoryear command.  The first
+% argument in the chicago.bst style contains a full list of all
+% author last names.  This argument is not used with ASCE's styel.
+% We replace this argument with a null argument "{}",
+% with the 2nd and 3rd arguments giving the citation author and the year.
+% This change is made so that two separate articles, say by Huang, Bird, and
+% Bell and by Haung, Bird, and Hendrich (both published in, say, 2009)
+% will be given the citations Jones et al. (2009a) and Jones et al. (2009b).
+% Without the change, both would be given the citations Jones et al. (2009).
+% Thanks to Alec Gosse.
+%
 { type$ "book" =
   type$ "inbook" =
   or
@@ -686,34 +710,38 @@ FUNCTION {calc.label}
     }
   if$
 
-  author empty$  % generate the full label citation information.
-    { editor empty$
-        { organization empty$
-            { type$ "manual" =
-                { title empty$
-                    { "no author, editor, organization or title in " 
-                      cite$ * warning$
-                      "??" 
-                    }
-                    { title }
-                  if$
-                }
-                { "no author, editor, or organization in " cite$ * warning$
-                  "??" }
-              if$
-            }
-            { organization }
-          if$
-        }
-        { editor my.full.label }
-      if$
-    }
-    { author my.full.label }
-  if$
-
-% leave label on the stack, to be popped when required.
-
-  "}{" * swap$ * "}{" *
+%------------- cut MRK -------------------
+%  author empty$  % generate the full label citation information.
+%    { editor empty$
+%        { organization empty$
+%            { type$ "manual" =
+%                { title empty$
+%                    { "no author, editor, organization or title in " 
+%                      cite$ * warning$
+%                      "??" 
+%                    }
+%                    { title }
+%                  if$
+%                }
+%                { "no author, editor, or organization in " cite$ * warning$
+%                  "??" }
+%              if$
+%            }
+%            { organization }
+%          if$
+%        }
+%        { editor my.full.label }
+%      if$
+%    }
+%    { author my.full.label }
+%  if$
+%
+%% leave label on the stack, to be popped when required.
+%
+%  "}{" * swap$ * "}{" *
+%------------- paste MRK ---------------
+   "}{"   swap$ * "}{" *
+%------------- end MRK -----------------
 %  year field.or.null purify$ #-1 #4 substring$ *
 %
 % save the year for sort processing afterwards (adding a, b, c, etc.)
@@ -765,7 +793,12 @@ FUNCTION {article}
     }
   if$
   new.block
-  note output
+  note empty$
+    { }
+    { before.all 'output.state :=
+      "\ " note * output
+    }
+  if$
   fin.entry
 }
 
@@ -790,6 +823,7 @@ FUNCTION {book}
       new.block
       format.number.series output
       new.sentence
+      format.howpublished output
       publisher "publisher" output.check
       address output
     }
@@ -798,8 +832,27 @@ FUNCTION {book}
     }
   if$
   format.edition output
+  url empty$
+    { }
+    { mid.sentence 'output.state :=
+      "$<$" url * "$>$" * output
+%     format.url output
+    }
+  if$
+  month empty$
+    { }
+    { before.all 'output.state :=
+      "\ (" month * ")" * output
+    }
+  if$
   new.block
-  note output
+  note empty$
+    { }
+    { before.all 'output.state :=
+      "\ " note * output
+    }
+  if$
+% note output
   fin.entry
 }
 
@@ -836,12 +889,13 @@ FUNCTION {inbook}
   format.btitle "title" output.check
   crossref missing$
     { format.bvolume output
-      format.chapter.pages "chapter and pages" output.check
       new.block
       format.number.series output
-      new.sentence
+      format.howpublished output
       publisher "publisher" output.check
       address output
+      format.edition output
+      format.chapter.pages output
     }
     { format.chapter.pages "chapter and pages" output.check
       new.block
@@ -866,6 +920,7 @@ FUNCTION {incollection}
     { format.in.ed.booktitle "booktitle" output.check
       format.bvolume output
       format.number.series output
+      format.howpublished output
       publisher "publisher" output.check
       address output
       format.edition output
@@ -892,9 +947,10 @@ FUNCTION {inproceedings}
     { format.in.ed.booktitle "booktitle" output.check
       format.bvolume output
       format.number.series output
+      format.howpublished output
       organization output				% for apalike
       address output					% there's no year
-      new.sentence					% here so things
+%     new.sentence					% here so things
       publisher output					% are simpler
       format.pages output
     }
@@ -902,6 +958,19 @@ FUNCTION {inproceedings}
       format.pages output
     }
   if$
+  url empty$
+    { }
+    { mid.sentence 'output.state :=
+      "$<$" url * "$>$" * output
+%     format.url output
+    }
+  if$
+  month empty$
+    { }
+    { before.all 'output.state :=
+      "\ (" month * ")" * output
+    }
+  if$
   new.block
   note output
   fin.entry
@@ -966,6 +1035,19 @@ FUNCTION {manual}
 % organization output
   address output
   format.edition output
+  url empty$
+    { }
+    { mid.sentence 'output.state :=
+      "$<$" url * "$>$" * output
+%     format.url output
+    }
+  if$
+  month empty$
+    { }
+    { before.all 'output.state :=
+      "\ (" month * ")" * output
+    }
+  if$
   new.block
   note output
   fin.entry
@@ -974,18 +1056,45 @@ FUNCTION {manual}
 FUNCTION {mastersthesis}
 { output.bibitem
   format.authors "author" output.check
-  author format.key output				% special for
-  output.year.check					% apalike
+  author format.key output                              % special for
+  output.year.check                                     % apalike
   new.block
   format.title "title" output.check
-  new.block
-  "Master's thesis" format.thesis.type output.nonnull
+  after.quote 'output.state :=
+  "M.S. thesis" format.thesis.type output.nonnull
   school "school" output.check
-  address output
+  address output.nonnull
+  url empty$
+    { }
+    { mid.sentence 'output.state :=
+      "$<$" url * "$>$" * output
+%     format.url output
+    }
+  if$
+  month empty$
+    { }
+    { before.all 'output.state :=
+      "\ (" month * ")" * output
+    }
+  if$
   new.block
   note output
   fin.entry
 }
+%{ output.bibitem
+%  format.authors "author" output.check
+%  author format.key output				% special for
+%  output.year.check					% apalike
+%  new.block
+%  format.title "title" output.check
+%  new.block
+%  "Master's thesis" format.thesis.type output.nonnull
+%  school "school" output.check
+%  address output
+%  new.block
+%  note output
+%  fin.entry
+%}
 
 FUNCTION {misc}
 { output.bibitem
@@ -993,14 +1102,60 @@ FUNCTION {misc}
   author format.key output				% special for
   output.year.check					% apalike
   new.block
-  format.title output
-  new.block
-  howpublished output
+  format.title "title" output.check
+  after.quote 'output.state :=
+  journal emphasize "journal" output.check
+  organization output
+  url empty$
+    { }
+    { mid.sentence 'output.state := 
+      "$<$" url * "$>$" * output 
+%     format.url output
+    }
+  if$
+  month empty$
+    { }
+    { before.all 'output.state :=
+      "\ (" month * ")" * output 
+    }
+  if$
   new.block
   note output
   fin.entry
 }
 
+FUNCTION {format.url}
+{ url empty$
+    { "" }
+    { "$<$" url * "$>$" *
+    }
+  if$
+}
+
+%{ output.bibitem
+%  format.authors "author" output.check
+%  author format.key output                              % special for
+%  output.year.check                                     % apalike
+%  new.block
+%  format.title "title" output.check
+%  after.quote 'output.state :=
+%  crossref missing$
+%    { journal emphasize "journal" output.check
+%      organization output
+%      format.vol.num.pages output
+%    }
+%    { format.article.crossref output.nonnull
+%      format.pages output
+%    }
+%  if$
+%  new.block
+%  note output
+%  fin.entry
+%}
+
+
+
+
 FUNCTION {phdthesis}
 { output.bibitem
   format.authors "author" output.check
@@ -1008,10 +1163,23 @@ FUNCTION {phdthesis}
   output.year.check					% apalike
   new.block
   format.title "title" output.check
-  after.quote.comma 'output.state :=
-  "PhD thesis" format.thesis.type output.nonnull
+  after.quote 'output.state :=
+  "Ph.D. thesis" format.thesis.type output.nonnull
   school "school" output.check
-  address output.check
+  address output.nonnull
+  url empty$
+    { }
+    { mid.sentence 'output.state :=
+      "$<$" url * "$>$" * output 
+%     format.url output
+    }
+  if$
+  month empty$
+    { }
+    { before.all 'output.state :=
+      "\ (" month * ")" * output
+    }
+  if$
   new.block
   note output
   fin.entry
@@ -1046,6 +1214,19 @@ FUNCTION {techreport}
   format.tr.number output.nonnull
   institution "institution" output.check
   address output
+  url empty$
+    { }
+    { mid.sentence 'output.state :=
+      "$<$" url * "$>$" * output
+%     format.url output
+    }
+  if$
+  month empty$
+    { }
+    { before.all 'output.state :=
+      "\ (" month * ")" * output
+    }
+  if$
   new.block
   note output
   fin.entry
diff --git a/Master/texmf-dist/doc/latex/ascelike/Readme.txt b/Master/texmf-dist/doc/latex/ascelike/Readme.txt
deleted file mode 100644
index 40a361ce479..00000000000
--- a/Master/texmf-dist/doc/latex/ascelike/Readme.txt
+++ /dev/null
@@ -1,29 +0,0 @@
-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 603ad7f0d70..839fbc552e1 100644
--- a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.bib
+++ b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.bib
@@ -1,3 +1,7 @@
+%
+%
+% August 20, 2011
+%
 % Bibtex bibliographic data base using the canonical set given in the
 %   ASCE web document "Instructions For Preparation Of Electronic Manuscripts"
 % For use with the ascelike.bst bibliographic style file.
@@ -30,7 +34,7 @@
     TITLE        = "Standard practice for the use of the international system of units ({SI}) (the modernized metric system)",
     EDITOR       = "",
     BOOKTITLE    = "E 380-91a",
-    PUBLISHER    = "",
+    PUBLISHER    = "ASTM",
     ADDRESS      = "Philadelphia, Pa.",
     MONTH        = "",
     YEAR         = 1991,
@@ -39,6 +43,24 @@
     ORGANIZATION = "",
     NOTE         = "",
     }
+
+@MISC{Burka:1993a,
+  author = {Burka, L. P.},
+  title = {A hypertext history of multi-user dimensions},
+  journal = {MUD history},
+  year = {1993},
+  month = {Dec. 5, 1994},
+  url = {http://www.ccs.neu.edu},
+}
+%
+@ARTICLE{Dasgupta:2008a,
+    AUTHOR       = "Dasgupta, G.",
+    TITLE        = "Stiffness matrix from isoparametric closed form 
+                    shape functions using exact integration",
+    JOURNAL      = "J. Aerosp. Eng.",
+    YEAR         = 2008,
+    NOTE         = "in press",
+    }
 %
 @TECHREPORT{Duan:1990a,
    AUTHOR        = "Duan, L. and Loh, J. T. and Chen, W. F.",
@@ -47,9 +69,9 @@
    TYPE          = "Struct. Engrg. Rep. No.",
    NUMBER        = "CE-STR-90-27",
    ADDRESS       = "West Lafayette, Ind.",
-   MONTH         = "",
    YEAR          =  1990,
    NOTE          = "",
+   URL           = "",
 }
 %
 @BOOK{Duvant:1972a,
@@ -58,7 +80,6 @@
     TITLE        = "Les in{\'{e}}quations en m{\'{e}}chanique et en physique",
     PUBLISHER    = "Dunod",
     ADDRESS      = "Paris, France",
-    MONTH        = "",
     YEAR         = 1972,
     EDITION      = "",
     NOTE         = "(in French)",
@@ -68,10 +89,10 @@
     AUTHOR       = "Chang, T. C.",
     TITLE        = "Network resource allocation using an expert system 
                     with fuzzy logic reasoning",
-    SCHOOL       = "University of California at Berkeley, Calif.",
-    ADDRESS      = "",
+    SCHOOL       = "University of California",
+    ADDRESS      = "Berkeley, CA",
     YEAR         = 1987,
-    TYPE         = "PhD thesis",
+    URL          = "",
     }
 %
 @INPROCEEDINGS{Eshenaur:1991a,
@@ -81,7 +102,6 @@
     BOOKTITLE    = "Proc., 8th Annual Int. Bridge Conf.",
     EDITOR       = "",
     PUBLISHER    = "",
-    MONTH        = "",
     YEAR         = 1991,
     ORGANIZATION = "Engineers' Soc. of Western Pennsylvania",
     ADDRESS      = "Pittsburgh, Pa.",
@@ -89,6 +109,20 @@
     NOTE         = "",
     }
 %
+@INPROCEEDINGS{Garrett:2003a,
+    AUTHOR       = "Garrett, D. L.",
+    TITLE        = "Coupled analysis of floating production systems",
+    BOOKTITLE    = "Proc., Int. Symp. on Deep Mooring Systems",
+    EDITOR       = "",
+    PUBLISHER    = "",
+    YEAR         = 2003,
+    ORGANIZATION = "ASCE",
+    ADDRESS      = "Reston, VA",
+    PAGES        = "152--167",
+    NOTE         = "",
+    HOWPUBLISHED = "CD-ROM",
+    }
+%
 @ARTICLE{Gaspar:2001a,
     AUTHOR       = "Gaspar, N. and Koenders, M. A.",
     TITLE        = "Micromechanic formulation of macroscopic
@@ -122,7 +156,6 @@
    ORGANIZATION  = "Federal Highway Administration (FHWA)",
    PUBLISHER     = "Rep., Hydr. Engrg. Circular No. 18: FHWA-IP-90-017",
    ADDRESS       = "Washington, D.C.",
-   MONTH         = "",
    YEAR          = 1991,
    NOTE          = "",
 }
@@ -132,7 +165,6 @@
     KEY          = "Federal",
     TITLE        = "Federal Register",
     HOWPUBLISHED = "",
-    MONTH        = "",
     YEAR         = 1988,
     NOTE         = "33(No. 146; July 27), 10756",
     }
@@ -142,7 +174,6 @@
     TITLE        = "Weldment design for {RHS} truss connections.  {I}: Applications",
     JOURNAL      = "J. Struct. Engrg.",
     ORGANIZATION = "ASCE",
-    MONTH        = "",
     YEAR         = 1992,
     VOLUME       = 118,
     NUMBER       = 10,
@@ -170,7 +201,26 @@
     ADDRESS      = "Reading, Mass.",
     YEAR         = 1994,
     }
-%
+@ARTICLE{Huang2009a,
+  author = {Yue Huang and Roger Bird and Margaret Bell},
+  title = {A comparative study of the emission by road maintenance works and
+        the disrupted traffic using life cycle assessment and micro-simulation},
+  journal = {Transportation Research Part D},
+  year = {2009},
+  volume = {14},
+  pages = {197-204},
+}
+
+@ARTICLE{Huang2009b,
+  author = {Yue Huang and Roger Bird and Oliver Hendrich},
+  title = {Development of a life cycle assessment tool for construction and
+        maintenance of asphalt pavements},
+  journal = {Journal of Cleaner Production},
+  year = {2009},
+  volume = {17},
+  pages = {283-296},
+}
+
 @MANUAL{ICBO:1988a,
     AUTHOR       = "",
     ORGANIZATION = "International Conference of Building Officials",
@@ -198,6 +248,15 @@
     NOTE         = "",
     }
 %
+@MISC{Kuhn:2011a,
+  author = {Kuhn, M. R.},
+  title = {Style files for {ASCE}-like documents},
+  journal = {ascelike},
+  year = {2011},
+  month = {Aug. 20, 2011},
+  url = {http://www.ctan.org/tex-archive/macros/latex/contrib/ascelike},
+}
+%
 @BOOK{Lamport:1994a,
     AUTHOR       = "Lamport, L.",
     TITLE        = "\LaTeX: A Document Prepartation System User's Guide
@@ -206,6 +265,18 @@
     ADDRESS      = "Reading, Mass.",
     YEAR         = 1994,
     }
+
+@INCOLLECTION{Liggett:1998a,
+  author = {Liggett, J. A. and Caughey, D. A.},
+  title = {Fluid statics},
+  booktitle = {Fluid mechanics},
+  year = {1998},
+  howpublished = {CD-ROM},
+  chapter = {2},
+  publisher = {ASCE},
+  address = {Reston, VA},
+  pages = {167--177},
+}
 %
 @MANUAL{Lotus:1985a,
     AUTHOR       = "",
@@ -272,6 +343,28 @@
     NOTE         = "(in German)",
     }
 %
+% Note that the TYPE can be left blank ("") for the default M.S. thesis
+@MASTERSTHESIS{Sotiropulos:1991a,
+    AUTHOR       = "Sotiropulos, S. N.",
+    TITLE        = "Static response of bridge superstructures 
+                    made of fiber reinforced plastic",
+    SCHOOL       = "West Virginia Univ.",
+    ADDRESS      = "Morgantown, WV",
+    YEAR         = 1991,
+    TYPE         = "M.{S}. thesis",
+    URL          = "",
+    }
+%
+@ARTICLE{Stahl:2004a,
+    AUTHOR       = "Stahl, D. C. and Wolfe, R. W. and Begel, M.",
+    TITLE        = "Improved analysis of timber rivet connections",
+    JOURNAL      = "J. Struct. Eng.",
+    YEAR         = 2004,
+    VOLUME       = 130,
+    NUMBER       = 8,
+    PAGES        = "1272--1279",
+    }
+%
 @ARTICLE{Vesilind:1992a,
     AUTHOR       = "Vesilind, P. A.",
     TITLE        = "Discussion of `{G}uidance for engineering-design-class 
@@ -300,3 +393,15 @@
     ORGANIZATION = "",
     NOTE         = "",
     }
+%
+@PHDTHESIS{Wichtmann:2005a,
+    AUTHOR       = "Wichtmann, T.",
+    TITLE        = "Explicit accumulation model for non-cohesive 
+                    soils under cyclic loading",
+    SCHOOL       = "Institute for Soil Mechanics and Foundation Engineering,
+                    Ruhr-Univ. Bochum, Germany",
+    ADDRESS      = "",
+    YEAR         = 2005,
+    URL          = "www.rz.uni-karlsruhe.de/$\sim$gn97/",
+    MONTH        = "2007",
+    }
diff --git a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.pdf b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.pdf
index 80cf47af8e9..e9ba16eb87b 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 021ebcc3a9b..dbcdea387eb 100644
--- a/Master/texmf-dist/doc/latex/ascelike/ascexmpl.tex
+++ b/Master/texmf-dist/doc/latex/ascelike/ascexmpl.tex
@@ -1,11 +1,27 @@
 %
 \documentclass[Proceedings]{ascelike}
 %
-% Dec. 29, 2002
+% Aug. 20, 2011
+%
+% Some useful packages...
+%
+%\usepackage{graphicx}
+%\usepackage{subfigure}
+%\usepackage{amsmath}
+%\usepackage{amsfonts}
+%\usepackage{amssymb}
+%\usepackage{amsbsy}
+%\usepackage{times}
+%
+%
+% Place hyperlinks within the pdf file (works only with pdflatex, not latex)
+% \usepackage[colorlinks=true,citecolor=red,linkcolor=black]{hyperref}
+%
 %
 % NOTE: Don't include the \NameTag{<your name>} if you have selected 
 %       the NoPageNumbers option: this leads to an inconsistency.
-\NameTag{Kuhn}
+\NameTag{Kuhn, August 20, 2011}
+%
 %
 \begin{document}
 %
@@ -33,10 +49,13 @@ Portland, OR  97203. E-mail: kuhn@up.edu.},
 \maketitle
 %
 \begin{abstract}
-This document was produced with the \LaTeX\ typsetting program
+This document was produced with the \LaTeX\ typesetting program
 using the document class ``\texttt{ascelike.cls}'' and the
 example document ``\texttt{ascexmpl.tex}''.
-The objective is manuscripts that roughly comply with the
+The reference section on page~\pageref{section:references}
+was produced with the \textsc{Bib}\TeX\ style ``\texttt{ascelike.bst}''
+and the database ``\texttt{ascelike.bib}''.
+The objective of these files is manuscripts that roughly comply with the
 guidelines of the American Society of Civil Engineers.
 The document class
 produces either double-spaced manuscripts for journal submissions or
@@ -54,49 +73,60 @@ Project Public License, version 1.1
 \KeyWords{\LaTeX, ASCE, document class.}
 %
 \section{Introduction}
-The experimental document class ``\texttt{ascelike.cls}''
+The document class ``\texttt{ascelike.cls}''
 produces manuscripts that roughly comply with the
-guidelines of the American Society of Civil Engineers.
-However, it was \emph{not} produced by ASCE, its agents,
-or employees;
-nor is it in any way sanctioned or approved by that organization.
+guidelines of the American Society of Civil Engineers (ASCE).
+The \texttt{ascelike.cls} document class, the 
+bibliographic style \texttt{ascelike.bst}, and
+example files are available on the \texttt{ctan}
+web-site \cite{Kuhn:2011a}.
+Although it is \emph{not} produced by ASCE, its agents,
+or employees, \texttt{ascelike.cls} is now referenced on
+the ASCE web-site.
+\par
 The program \texttt{ascelike.cls} is distributed under the
 terms of the LaTeX Project Public License Distributed,
 available from the CTAN archives;
 either version 1.1 of the License, or any later version.
 If you modify
-\texttt{ascelike.cls}, you should rename it so that ``contaminated''
-copies are not later disseminated.
+\texttt{ascelike.cls}, you should rename it so that ``altered''
+copies are not later proliferated.
 \par
 The document class ``\texttt{ascelike.cls}'' requires the following
 supplementary packages:
 \texttt{ifthen.sty}, \texttt{setspace.sty}, and \texttt{endfloat.sty}
 \emph{Without these files,} \texttt{ascelike.cls} \emph{won't work}.
 These files are typically included in \LaTeX\ distribution, such as the
-\textsf{tetex} and \textsf{MikTex} distributions.
-All three files are also freely available
+\textsf{TexLive} and \textsf{MikTex} distributions.
+All of these 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.ctan.org+ or
+\verb+http://www.tug.org+, although 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 
+\par
+In addition to \texttt{ascelike.cls}, 
+the file \texttt{ascelike.bst} can be used with
+the bibliographic tool \textsc{Bib}\TeX\ to produce ASCE-like 
 reference citations and entries (with the weird use of
-quotation marks around titles, etc.).
+quotation marks around titles, etc.) \cite{Kuhn:2011a}.
 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 will use this
+In addition to these essential files,
+we have found the following packages very useful (and we will use this
 opportunity to illustrate a \LaTeX\ itemized list):
 %
 \begin{itemize}
 \item
-\texttt{epsfig.sty} and its companion files for incorporating
+\texttt{graphicx.sty} and its companion files for incorporating
 encapsulated post\-script (figure) files into the document
 \item
+\texttt{times.sty} for typesetting with Times fonts.
+\item
 \texttt{subfigure.sty} for arranging and numbering sub-figures
 \item
-\texttt{amstex.sty} and its companion files for the AMS extensions
-to mathematical formatting.
+\texttt{amsmath.sty} and its companion files for the AMS extensions
+to mathematical formatting (\texttt{amsfonts.sty}, \texttt{amssymb.sty},
+and \texttt{amsbsy.sty}).
 \end{itemize}
 %
 All of these packages are also freely 
@@ -104,20 +134,23 @@ available from the CTAN archive,
 but they are included in most \LaTeX\ distributions.
 %
 \section{Input and Options}
-Prepare your \verb+*.tex+ input file as a regular
+You should
+prepare your \verb+*.tex+ input file as a regular
 \LaTeX\ file using the standard \texttt{article.cls} constructs,
 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 have provided two new commands: \verb+KeyWords+ and
+in the opening \verb+\documentclass+ command.
+You will likely need to specify a number of options as described below.
+In addition, \texttt{ascelike} provides 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 will also use this opportunity to illustrate an enumerated list).
+\par
+Document class \texttt{ascelike.cls} provides the options given
+below (and we 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.
 %
 \begin{enumerate}
 \item
+Options
 \verb+Journal|+\verb+Proceedings+ specify the overall format
 of the output man\-u\-script.  
 \par
@@ -130,7 +163,7 @@ sections, subsections, subsubsections, appendices, and abstract.
 It produces the proper page margins and numbers the pages.
 \par
 \texttt{Proceedings} produces camera-ready single-spaced manuscripts
-for ASCE conference proceedings.  
+for most ASCE conference proceedings.  
 It produces the proper page margins as
 given on the old shiny, 
 camera-ready paper (with the light blue lines) 
@@ -143,24 +176,24 @@ the author's name (this can be done by inserting the command
 \verb+\NameTag{<+\emph{your name}\verb+>}+ within the preamble of your
 document.
 \item
-\verb+BackFigs|InsideFigs+ can be used to override 
+Options \verb+BackFigs|InsideFigs+ can be used to override 
 the default placement of tables
 and figures in the \texttt{Journal} and \texttt{Proceedings} formats.
 \item
-\verb+SingleSpace|DoubleSpace+ can be used to override 
+Options \verb+SingleSpace|DoubleSpace+ can be used to override 
 the default text spacing in the 
 \texttt{Journal} and \texttt{Proceedings} formats.
 \item
-\verb+10pt|11pt|12pt+ can be used to override the 
+Options \verb+10pt|11pt|12pt+ can be used to override the 
 default text size (12pt).
 \item
-\texttt{NoLists} suppresses the inclusion of the lists of tables
+The option \texttt{NoLists} suppresses inclusion of lists of tables
 and figures that would normally be included in the \texttt{Journal}
 format.
 \item
-\texttt{NoPageNumbers} suppresses the printing of page numbers.
+The option \texttt{NoPageNumbers} suppresses the printing of page numbers.
 \item
-\texttt{SectionNumbers} produces an automatic numbering of sections.
+The option \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
@@ -184,16 +217,18 @@ the numbering of subsections or subsubsections.
 \end{enumerate}
 %
 \section{Sections, subsections, equations, etc.}
-I have included this section to test the formating of sections, subsections,
+This section is included to explain and 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
+If a heading does contain mathematics, you will need to modify
 \texttt{ascelike.cls}, in particular the line containing the
 \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,
+the \verb!\boldmath! command before the in-line math:
+for example,
 \verb!\boldmath$a_{i}=\sqrt{\beta}$!.
 %
 \subsection{An Example Subsection with math, \boldmath$a_{i}=\sqrt{\beta}$}
@@ -230,11 +265,11 @@ and a table (Table~\ref{table:assembly}).
 \centering
 \small
 \renewcommand{\arraystretch}{1.25}
-\begin{tabular}{l | l}
+\begin{tabular}{l l}
 \hline\hline
-\multicolumn{1}{c|}{Assembly Attribute} &
+\multicolumn{1}{c}{Assembly Attribute} &
 \multicolumn{1}{c}{Values} \\
-\multicolumn{1}{c|}{(1)} &
+\multicolumn{1}{c}{(1)} &
 \multicolumn{1}{c}{(2)} \\
 \hline
 Number of particles & 4008 \\
@@ -250,7 +285,7 @@ Assembly size & $54D_{50} \times 54D_{50} \times 54D_{50}$ \\
 \end{table}
 %
 \par
-I have added a new command \verb+\KeyWords{<your key words>}+ for
+A new command \verb+\KeyWords{<your key words>}+ can be used to produce
 a labeled list of key words.  
 It can be placed anywhere in the document and produces an unindented
 paragraph of keywords at that location.
@@ -259,9 +294,10 @@ paragraph of keywords at that location.
 When used together, \texttt{ascelike.cls} and \texttt{ascelike.bst}
 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
+The code in \texttt{ascelike.bst}
+is a modification of the \texttt{chicago.sty} and
 \texttt{chicago.bst} packages.
-I have made available the following citation options:
+The following citation options are available:
 \begin{itemize}
 \item
 \verb+\cite{key}+ produces citations with full author 
@@ -286,29 +322,74 @@ as in \citeyearNP{Ireland:1954a}.
 \end{itemize}
 %
 \par
-The example bibliographic data base \texttt{ascexmpl.bib}
+The bibliographic data base \texttt{ascexmpl.bib}
 gives examples of bibliographic entries for different document types.
 These entries are from the canonical set in the
-ASCE web document ``Instructions For Preparation Of Electronic Manuscripts'':
-an anonymous book \cite{Moody:1988a}, 
-an anonymous report \cite{FHWA:1991a}, 
-an anonymous newspaper story ("Educators" 1993), 
-an ASCE journal paper \cite{Pennoni:1992a}, 
-a book with editors \cite{Zadeh:1981a}, 
-a building code \cite{ICBO:1988a}, 
-a discussion \cite{Vesilind:1992a}, 
-a doctoral thesis \cite{Chang:1987a}, 
-a paper in a foreign journal \cite{Ireland:1954a}, 
-a paper in a proceedings \cite{Eshenaur:1991a}, 
-a standard \cite{ASTM:1991a}, 
-a translated book \cite{Melan:1913a}, 
-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},
-software \cite{Lotus:1985a},
-and two works by the same author in the same year
-\cite{Gaspar:2001a,Gaspar:2001b}.  
+ASCE web document ``Instructions For Preparation Of Electronic Manuscripts''
+and from the ASCE web-site.
+The References section of this document has been automatically created with
+the \texttt{ascelike.bst} style for the following entries:
+\begin{itemize}
+\item a book \cite{Goossens:1994a},
+\item an anonymous book \cite{Moody:1988a}, 
+\item an anonymous report using \texttt{@MANUAL} \cite{FHWA:1991a}, 
+%\item an anonymous newspaper story ("Educators" 1993), 
+\item a journal article \cite{Stahl:2004a,Pennoni:1992a}, 
+\item a journal article in press \cite{Dasgupta:2008a},
+\item an article in an edited book using \texttt{@INCOLLECTION} \cite{Zadeh:1981a}, 
+\item a building code using \texttt{@MANUAL} \cite{ICBO:1988a}, 
+\item a discussion of an \texttt{@ARTICLE} \cite{Vesilind:1992a}, 
+\item a masters thesis using \texttt{@MASTERSTHESIS} \cite{Sotiropulos:1991a},
+\item a doctoral thesis using \texttt{@PHDTHESIS} \cite{Chang:1987a}, 
+\item a paper in a foreign journal \cite{Ireland:1954a}, 
+\item a paper in a proceedings using \texttt{@INPROCEEDINGS} 
+      \cite{Eshenaur:1991a,Garrett:2003a}, 
+\item a standard using \texttt{@INCOLLECTION} \cite{ASTM:1991a}, 
+\item a translated book \cite{Melan:1913a}, 
+\item a two-part paper \cite{Frater:1992a,Frater:1992b}, 
+\item a university report using \texttt{@TECHREPORT} \cite{Duan:1990a}, 
+\item an untitled item in the Federal Register using 
+      \texttt{@MANUAL} \cite{FR:1968a}, 
+\item works in a foreign language \cite{Duvant:1972a,Reiffenstuhl:1982a},
+\item software using \texttt{@MANUAL} \cite{Lotus:1985a},
+\item two works by the same author in the same year
+      \cite{Gaspar:2001b,Gaspar:2001a}, and
+\item two works by three authors in the same year that only share
+      the first two authors \cite{Huang2009a,Huang2009b}.
+\end{itemize}
+%
+\par
+ASCE has added two types of bibliographic entries:
+web-pages and CD-ROMs.  A web-page can be formated using the
+\texttt{@MISC} entry category, as with the item \cite{Burka:1993a} produced
+with the following \texttt{*.bib} entry:
+\begin{verbatim}
+    @MISC{Burka:1993a,
+      author = {Burka, L. P.},
+      title = {A hypertext history of multi-user dimensions},
+      journal = {MUD history},
+      year = {1993},
+      month = {Dec. 5, 1994},
+      url = {http://www.ccs.neu.edu}
+    }
+\end{verbatim}
+Notice the use of the ``\texttt{month}'' field to give the date that material
+was downloaded and the use of a new ``\texttt{url}'' field.
+The ``\texttt{url}'' and \texttt{month}'' 
+fields can also be used with other entry types
+(i.e., \texttt{@BOOK}, \texttt{@INPROCEEDINGS}, \texttt{@MANUAL},
+\texttt{@MASTERSTHESIS}, \texttt{@PHDTHESIS}, and \texttt{@TECHREPORT}):
+for example, in the entry type \texttt{@PHDTHESIS} for \cite{Wichtmann:2005a}.
+%
+\par
+A CD-ROM can be referenced when using the \texttt{@BOOK}, \texttt{@INBOOK},
+\texttt{@INCOLLECTION}, or \texttt{@INPROCEEDINGS} categories, 
+as in the entry \cite{Liggett:1998a}.
+The field ``\texttt{howpublished}'' is used to designate the medium
+in the \texttt{.bib} file:
+\begin{verbatim}
+    howpublished = {CD-ROM},
+\end{verbatim}
 %
 \section{Miscellany}
 Many ASCE conference proceedings are now published on CD ROM media.
@@ -323,6 +404,7 @@ making any changes to \texttt{ascelike.cls}.
 (See the \LaTeX\ book
 \cite{Lamport:1994a}, its companion \cite{Goossens:1994a}, or
 online web documentation.)
+\par
 Authors' addresses can be placed below the title (instead of
 in a footnote) by \emph{not} using the \verb+\thanks+ command.
 %
@@ -330,7 +412,7 @@ in a footnote) by \emph{not} using the \verb+\thanks+ command.
 % Now we start the appendices, with the new section name, "Appendix", and a 
 %  new counter, "I", "II", etc.
 %
-\appendix
+\appendix\label{section:references}
 %
 % Here's the first appendix, the list of references:
 %