tugboat 2013/01/31

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

4 files changed, 93 insertions, 175 deletions

diff --git a/Master/texmf-dist/doc/latex/tugboat/README b/Master/texmf-dist/doc/latex/tugboat/README
index 9d449a280ac..240d5b47946 100644
--- a/Master/texmf-dist/doc/latex/tugboat/README
+++ b/Master/texmf-dist/doc/latex/tugboat/README
@@ -1,16 +1,16 @@
 $Id: README 103 2012-09-28 22:55:44Z bnb $
-Copyright 2006, 2009-2012 TeX Users Group.
+Copyright 2006, 2009-2013 TeX Users Group.
 You may freely use, modify and/or distribute this file.
 
 LaTeX macros for use in TUGboat
 ===============================
 
 See the TUGboat web pages at http://tug.org/TUGboat for upcoming
-deadlines, tips on writing articles, access to online issues, etc.  We
-greatly appreciate new article submissions!
+deadlines, tips on writing articles, access to online issues, etc.
+We greatly appreciate new article submissions!
 
 The files in this directory generate the TUGboat article class
-ltugboat.cls which should be used for all articles nowadays -- both
+ltugboat.cls, which should be used for all articles nowadays -- both
 proceedings and regular issues.
 
 These macros are supported.
@@ -22,7 +22,11 @@ tugboat@tug.org
 Installation and use:
 =====================
 
-The directory contains three files containing TeX code:
+Of course, normally you would get the tugboat packages through your
+distribution.
+
+But if you want to install it by hand from CTAN, this directory contains
+three files containing TeX code:
 
   tugboat.dtx  -- the source for the macros
   tugboat.ins  -- the docstrip instructions
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx b/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
index 8ad237e0b57..3620b65eb26 100644
--- a/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
+++ b/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
@@ -1,7 +1,7 @@
 % $Id: ltubguid.ltx 66 2010-11-23 16:33:37Z karl $
 % ltubguid.ltx - documentation for ltugboat classes.
 % 
-% Copyright 1994,1995,1996,2001,2005,2006 TeX Users Group.
+% Copyright 1994,1995,1996,2001,2005,2006,2010,2013 TeX Users Group.
 % 
 % This file is part of the tugboat package.
 % 
@@ -62,7 +62,7 @@
 }
 
 @Misc{Rahtz:hyperref:1997,
-  author = {Sebastian Rahtz},
+  author = {Sebastian Rahtz and Heiko Oberdiek},
   title = {The {\textsf{hyperref}} system},
   year = 1997,
   howpublished = {Available from {\CTAN}, {\CTANref{hyperref}}}
@@ -70,7 +70,7 @@
 
 @Book{Lamport:1994,
   author = {Leslie Lamport},
-  title = {{\LaTeX}, a Document Preparation System},
+  title = {{\LaTeX}: A Document Preparation System},
   edition = {\nth{2}},
   year = {1994},
   publisher = {Addison-Wesley}
@@ -173,16 +173,15 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
-\listfiles
-\setcounter{errorcontextlines}{999}
 \documentclass[harvardcite,final]{ltugboat}
+\usepackage{microtype}
 \usepackage{ctandir}
 \IfFileExists{booktabs.sty}%
   {\usepackage{booktabs}}%
   {\let\midrule\hline}
 %
-% only tell me important overfulls, please
-\hfuzz=2pt
+% imperfectly broken pages are ok.
+\vbadness=10000
 %
 % define CTAN addresses using the commands of the |ctandir| package
 \CTANdirectory{bibextract}{biblio/bibtex/utils/bibextract}
@@ -201,9 +200,6 @@
 \providecommand\cbstart{}
 \providecommand\cbend{}
 %
-% this isn't really all that much of a `proof' copy
-\NoBlackBoxes
-%
 % ***** Commands provided by this paper *****
 %
 % Typeset the name of an environment, class, package, option, program
@@ -257,101 +253,73 @@
 %%%%%%%%%%%%%%%%
 %
 \title{The \LaTeXe\ \TUB{} Macros}
-\author{Robin Fairbairns}
-\address{University of Cambridge Computer Laboratory\\
-  William Gates Building\\
-  J J Thomson Avenue,\\
-  Cambridge CB3 0FD,\\
-  UK}
-\netaddress{rf@cl.cam.ac.uk}
-\personalURL{http://www.cl.cam.ac.uk/users/rf/robin.html}
+\author{Robin Fairbairns \& TUGboat editors}
+\EDITORnoaddress
+\netaddress{tugboat@tug.org}
+\personalURL{http://tug.org/TUGboat}
 \maketitle
 
 \section{Introduction}
 
-This note reports on a new set of macros for use by \TUB{} authors.
-The macros represent a development of the earlier \clsname{ltugboat} and
-\clsname{ltugproc} styles that were written for use with \LaTeX~2.09.  The
-development was started by others than I, notably Sebastian Rahtz,
-Michel Goossens, Nico Poppelier and Johannes Braams; I have been
-assisted in my work both directly and indirectly by many others,
-including Barbara Beeton, Mimi Burbank and (of course) the \LaTeX3
-team.
-
-The ultimate aim of the work is to provide a single production
-environment for the whole of \TUB{}.  That aim has not (yet) been
-achieved, though it is still believed to be achievable for a
-significant proportion of papers.\footnote{\TUB{} will continue to
-accept papers written using the `plain' macros; it's probably
-fanciful to hope that \emph{every} paper can be moulded into use
-within \LaTeX.}
+This is the documentation for the \LaTeXe\ macros to be used by \TUB{}
+authors.  The macros represent a development of the earlier
+\clsname{ltugboat} and \clsname{ltugproc} styles that were written for
+use with \LaTeX~2.09; major contributors have been Robin Fairbairns,
+Sebastian Rahtz, Michel Goossens, Nico Poppelier and Johannes Braams.
+Many others have been involved, including Barbara Beeton, Mimi Burbank
+and the \LaTeX3 team.
 
 \section{Availability}
 
-\begin{sloppypar}
-  The macros are released for general use, and are distributed via
-  \CTAN{}\footnote{\raggedfoot From directory \CTANref{tub-latex}} in the usual
-  \LaTeX{} way as files \path|tugboat.dtx| and \path|tugboat.ins|.
-  When the\,\verb|.ins| file is processed by \LaTeX{}, the files
-  \path|ltugboat.cls|, \path|ltugproc.cls| and \path|ltugbib.bst| (for
-  ordinary production work) and \path|ltugcomn.sty| (a cooking pot of
-  useful macros, for documentation, etc.)\ are produced.  The\,\verb|.dtx|
-  file may itself be processed by \LaTeX{} to produce a formatted
-  (somewhat `literate') source listing for those who feel they need
-  more detailed description of the macros than is offered in the
-  present note.
-\end{sloppypar}
-
-The \TUB\ web site is at \url{http://tug.org/TUGboat}.  It contains much
-information for authors and reviewers, all the back issues, and plenty
-more.  In particular, sample documents for both regular articles and
-proceedings articles are available from \url{http://tug.org/TUGboat}.
+\TUB's web pages are at:\\\centerline{\url{http://tug.org/TUGboat}} They
+include an article template, information for authors and reviewers, all
+the back issues, and more.
+
+The macros are released for general use, and are distributed via \CTAN{}
+(directory \CTANref{tub-latex}) in the usual \LaTeX{} way as files
+\path|tugboat.dtx| and \path|tugboat.ins|.  When the\,\verb|.ins| file
+is processed by \LaTeX{}, the files \path|ltugboat.cls|,
+\path|ltugproc.cls| and \path|ltugbib.bst| (for ordinary production
+work) and \path|ltugcomn.sty| (a cooking pot of useful macros, for
+documentation, etc.)\ are produced.  The\,\verb|.dtx| file may itself be
+processed by \LaTeX{} to produce a formatted (somewhat `literate')
+source listing for those who would like more detailed descriptions of
+the \TUB\ macros.
 
 \section{The general structure of a paper}
 
-The author need not understand the details of the production of
-\TUB{}\Dash her business is to produce the text that the editor is to
-mould into the body of an issue.
-
-However, any modern author wants to be able to view the progress of
-her efforts; for this, she needs to use the \TUB{} class
-\path|ltugboat.cls|\Dash it defines the way an article in a normal issue of
-\TUB{} will appear, and is therefore a useful aid.
-
-Similarly, one submitting a paper for presentation at an annual \tug{}
-conference may use the \path|ltugproc.cls|, which will set the paper as it
-should appear in a proceedings issue of \TUB{}.
+The basic idea is to start your \LaTeX\ document with
+\path|\documentclass{ltugboat}|, which defines the appearance of \TUB\
+articles.  This uses the file \path|ltugboat.cls| as usual.
 
 Each paper, therefore, is written as a document that may stand on its
 own.  It starts with a \cs{documentclass} command, and its body is
-enclosed in a \envname{document} environment.  Each of the document
-classes specifies a set of options, described in the next two
-subsections (\ref{sec:boat-opts} and~\ref{sec:proc-opts}).  In the
-ordinary course of events the author needn't bother with any of these
-options, since the defaults are designed for creating proof copies of
-papers.
-
-Since the author typesets her paper in a `proof mode', the paper's
-published appearance will differ from its appearance at the time of
-submission.  The changes required in this process are the
-responsibility of the \TUB{} production team, and the author need not
-be concerned with them.
-
-\subsection{Class options: the \clsname{ltugboat} class}
+enclosed in a \envname{document} environment.  There are some options to
+the document class, described in the next section, but ordinarily the
+author needn't bother with them.  The defaults are
+designed for creating proof copies of papers.
+
+The proof output differs from the final production output with respect
+to page numbers and other material.  The changes required for final
+production are the responsibility of the \TUB{} editors, and the author
+need not be concerned with them.
+
+\section{Class options: The \clsname{ltugboat} class}
 \label{sec:boat-opts}
 
-The \clsname{ltugboat} class accepts all the options of the
-\clsname{article} class (though it suppresses the font-size selection,
+The \clsname{ltugboat} class accepts many of the options of the
+\clsname{article} class (it suppresses the font-size selection,
 one/two-side and one/two-column options).
 \begin{optlist}
 \item[draft] Set up for a draft copy of a paper (this is the default
   setting\Dash the author need not explicitly set it): page numbering
-  to start at 1001, black marks for overfull boxes.
+  starts at a high number, black marks for overfull boxes.
 \item[extralabel] Use the extra label-distinguishing mark in the body
   of the reference; see section~\ref{sec:biblio}.
 \item[final] Set up for the final copy of a paper: page numbering to
   come from elsewhere, no black marks.
-\item[harvardcite] Specify Harvard-style citation; see
+\item[harvardcite] Specify Harvard-style citation (not especially
+  recommended in general, though they are used in the present document); see
   section~\ref{sec:biblio}.
 \item[noextralabel] Don't use the extra label-distinguishing mark in
   the body of the reference; see section~\ref{sec:biblio}.
@@ -361,48 +329,11 @@ one/two-side and one/two-column options).
   numbered (this is the default setting\Dash the author need not
   explicitly set it).
 \item[preprint] Set up for a preprint.
-
 \item[rawcite] Specify default (unnumbered) citation; see
   section~\ref{sec:biblio}.
 \end{optlist}
 
-\subsection{Class options: the \clsname{ltugproc} class}
-\label{sec:proc-opts}
-
-The \clsname{ltugproc} class accepts all of the options allowed with
-\clsname{ltugboat}.  In addition, it accepts an option that specifies
-the year of the conference for which the paper is submitted.  For
-example, the conference for \number\year\ would be specified by option
-%
-%% % although this paper will be published in 1996, it may be reprinted
-%% % again in the future, so let's calculate `this year' on the fly
-%% \newcount\y
-%% \y\year
-%% \divide\y100
-%% \multiply\y100
-%% \advance\y-\year
-%% \y-\y
-%
-% from 2000 on, the option is just the year
-\optname{tug\number\year}.  Such an option may be necessary if the
-(detailed) type design of papers for the year's proceedings issue is
-changed by the year's editor.  Unless ``instructions to authors''
-say otherwise, authors should not specify such an option, and
-\clsname{ltugproc} will choose an appropriate default.
-
-The class reads a configuration file
-\path|ltugproc.cfg|, in which you may specify the year by a command of
-the form:
-\begin{verbatim}[\small]
-  \newcommand{\tugProcYear}{97}
-\end{verbatim}
-
-The class deals with two-digit year selections for conferences up to
-2069 (which date was chosen entirely at random, uninfluenced, of
-course, by the Unix\texttrademark Epoch\dots); however, the user
-should not feel constrained to write such confusing dates since
-\clsname{ltugproc} will cope with the full year number (4 digits, for
-quite a while yet).
+\noindent Again, normally there is no need to use any document options.
 
 \section{Command syntax}
 \label{sec:syntax}
@@ -455,14 +386,6 @@ inadvertently) uses one of these forms.  (The author who wishes to use
 un-numbered sections throughout her paper may use the
 \optname{nonumber} class option (see~\ref{sec:boat-opts}).
 
-By contrast, whether or not sections are numbered in a conference
-proceedings issues of \TUB{} is a matter of that year's editor's
-choice (in collaboration with the \TUB{} team).  If sections are not
-to be numbered, the use of `\texttt{*}' forms is inappropriate, and the
-class equally warns the author.  Since the sections don't have
-numbers, references to section numbers don't work; they therefore
-(once they're resolved) warn the author of potential problems.
-
 Reference may, however, be made to the `title' of divisions of the
 paper, whether they are numbered or not.  The \cs{nameref} command
 (which uses the technique developed for the \textsf{hyperref} package
@@ -487,13 +410,6 @@ typesets its body as an un-numbered section whose title is
 small text, and separates the abstract from the rest of the paper with
 a decorative line.
 
-The \clsname{ltugproc} class typesets abstracts as part of the title
-of the paper, below the names and addresses of the authors, but before
-the main body of the paper.  Therefore, for proceedings articles, the
-\envname{abstract} environment must appear in the source of the paper
-\emph{before} the \cs{maketitle} command (it may even appear before
-\verb"\begin{document}", if the author so chooses).
-
 \subsection{Appendices}
 
 A paper may have appendices, which are expressed in exactly the same
@@ -511,8 +427,8 @@ Which will produce `section' headings similar to:
 \end{quote}
 
 \TUB{} articles may have a small extension to this format: this
-extension was originally developed for proceedings issues, but is also
-available in normal issues:
+extension was originally developed for proceedings of past years, but is
+also available in normal issues:
 
 \begin{verbatim}[\small]
 \begin{appendix}
@@ -526,8 +442,7 @@ Which will produce `section' headings similar to:
 \end{quote}
 
 In both cases, the subsections are numbered as normal (i.e., as
-`A.\ensuremath{n}' in normal \TUB{} papers, and not at all in
-proceedings classes).
+`A.\ensuremath{n}' in normal \TUB{} papers):
 
 \section{Titles, addresses and so on}
 
@@ -545,30 +460,16 @@ author may advertise a `home' Web page, using a \cs{personalURL} command.
 For example, the present paper has at its start:
 
 \begin{verbatim}[\small]
-\title{The New (\LaTeXe) \TUB{} Macros}
-\author{Robin Fairbairns}
-\address{University of Cambridge
-    Computer Laboratory\\
-  Pembroke Street,\\
-  Cambridge, CB2 3QG,\\
-  UK}
-\netaddress{rf@cl.cam.ac.uk}
-\personalURL{http://www.cl.cam.ac.uk/...}
+\title{The \LaTeXe\ \TUB{} Macros}
+\author{TUGboat editors}
+\EDITORnoaddress
+\netaddress{tugboat@tug.org}
+\personalURL{http://tug.org/TUGboat}
 \maketitle
 \end{verbatim}
 
-Since this paper is prepared for a normal issue of \TUB{} and
-therefore uses the \clsname{ltugboat} class, the \cs{maketitle} merely
-typesets the title of the paper and the author's name.  The
-address(es) are typeset at the end of the paper where the author gives
-a \cs{makesignature} command.
-
-The \clsname{ltugproc} class typesets all the information about the
-author at the head of the paper, when the \cs{maketitle} is given;
-this class disallows the \cs{makesignature} command.
-
-Note that the author had a problem typesetting the above example
-verbatim: the lines are too long.  If the information being given is
+Lines in the title information can get quite long.
+If the information being given is
 to be typeset as ordinary text (as in the case of the \cs{address}
 line above), it can be `wrapped' perfectly happily, as in normal text.
 If one of the verbatim items (\cs{netaddress} or \cs{personalURL}
@@ -580,13 +481,12 @@ sign is an entirely acceptable element of both email addresses and
 Therefore, the classes typeset these electronic addresses in an
 environment where some of the characters (notably `\verb|.|' and
 `\verb|/|') are treated as word-divisions for the purposes of laying
-out the line.  This is visible in the case of my personal \acro{URL},
-in the signature block at the end of the present paper.
+out the line.
 
 If the paper is the result of more than one author's labours, a sequence of
 \cs{author}, \cs{address}, \cs{netaddress} and \cs{personalURL}
 commands may be given, as in the following, which comes from a paper
-given at \tug'95 (slightly edited):
+given at \tug'95 (abbreviated):
 
 \begin{verbatim}[\small]
 \author{Michel Goossens}
@@ -822,9 +722,7 @@ delay.  (Remember that the editorial team is a group of volunteers,
 each working in his or her spare time.)
 
 In general, packages currently on \CTAN, and known to work with
-\emph{current} \LaTeX{},\footnote{The team's version of \LaTeX{} is
-  regularly updated, though not during the course of a production
-  run.} are unlikely to give problems.
+\emph{current} \LaTeX{} are unlikely to give problems.
 
 In particular, the team is happy to accept papers using packages
 that are supported by members of the \LaTeX3 team,\footnote{%\raggedfoot
@@ -881,6 +779,20 @@ used in the present paper (not least in the bibliography).
 \section{Bibliography}
 \label{sec:biblio}
 
+Short form: our recommendation for handling bibliographies is to use the
+\BibTeX\ and \pkgname{plain} bibliography style.  No document options
+are needed or recommended.  All that is required in the article source
+(as shown in the sample available from \url{http://tug.org/TUGboat}) is
+the following:
+
+\begin{verbatim}[\small]
+\bibliographystyle{plain}
+\bibliography{yourbibfile}
+\end{verbatim}
+
+The rest of this section is about cases where, for whatever reason, you
+don't want to do that.
+
 Bibliographic citations give much grief to the editorial team.  Good
 publishing practice requires that there be editorial control of the
 way citations in a journal are presented yet, all too often, authors
@@ -898,14 +810,16 @@ paper.\footnote{The program \progname{bibextract}, available from
 packages, the \envname{filecontents} environment is a convenient way to
 deliver the bibliography file.
 
-A special case is made of the accumulated bibliography of \TUB{}
+A special case is the accumulated bibliography of \TUB{}
 itself;\footnote{\raggedfoot Available on \CTAN{} as
   \CTANref{tub-biblio}} it is always available to the production team,
 so that authors may make reference to items from that \verb|.bib| file
 without further ado.
 
-Two citation styles are supported within \TUB{} articles, `\emph{raw}'
-and `\emph{harvard}' (the present article is employing \emph{harvard}
+Notwithstanding the general recommendation for the \pkgname{plain}
+\BibTeX\ style,
+two citation styles are supported within \TUB{} articles, `\texttt{raw}'
+and `\texttt{harvard}' (the present article is employing \emph{harvard}
 citation).  The raw citation style uses the `standard'
 \BibTeX{} `\pkgname{plain}' (numeric) citation style; its modification
 by use of Donald Arseneau's \pkgname{cite}
@@ -915,7 +829,7 @@ class option \optname{rawcite}).
 
 Harvard citation may be selected by specifying \optname{harvardcite} as an
 option of the \cs{documentclass} command.  The macros used derive
-pretty directly from the \textsl{\pkgname{harvard}} styles written by Glenn
+pretty directly from the `harvard' styles written by Glenn
 Paulley and now maintained by Peter Williams; the \BibTeX{} style
 derives from one developed by Patrick Daly.
 
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf b/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
index ac781e3fc5c..5df1217bd19 100644
--- a/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
+++ b/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
diff --git a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
index c195522737d..ef0717d6489 100644
--- a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
+++ b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf