tugboat (7nov17)

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

9 files changed, 198 insertions, 222 deletions

diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx b/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
index b9f9851ce0b..32b680931f9 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 135 2014-11-13 18:21:03Z karl $
+% $Id: ltubguid.ltx 187 2017-11-06 20:29:32Z karl $
 % ltubguid.ltx - documentation for ltugboat classes.
 % 
-% Copyright 1994,1995,1996,2001,2005,2006,2010,2013,2014 TeX Users Group.
+% Copyright 1994,1995,1996,2001,2005,2006,2010,2013,2014,2017 TeX Users Group.
 % 
 % This file is part of the tugboat package.
 % 
@@ -16,7 +16,7 @@
 % This work has the LPPL maintenance status "maintained".
 % 
 % The Current Maintainer of this work is the TeX Users Group
-% (http://tug.org/TUGboat).
+% (https://tug.org/TUGboat).
 %
 % The list of all files belonging to the distribution is
 % given in the file `manifest.txt'. 
@@ -35,37 +35,32 @@
 \begin{filecontents}{tubguide.bib}
 % BibTeX bibliography file (generated by aux2bib)
 
-@Misc{Arseneau:url:1996,
-  author = {Donald Arseneau},
-  title = {The {\textsf{url}} package},
-  year = {1996},
-  howpublished = {Available from {\CTAN}, {\CTANref{url}}}
+@Misc{pkg:fancyvrb,
+  author = {Timothy Van Zandt and others},
+  title = {The {\textsf{fancyvrb}} package},
+  year = {2015},
+  howpublished = {\url{https://ctan.org/pkg/fancyvrb}},
 }
 
-@Article{Baxter:TB15-3-331,
-  author = {William Erik Baxter},
-  title = {{{An object-oriented programming system in {\TeX}}}},
-  journal = {{\TUB}},
-  year = {1994},
-  month = {September},
-  volume = {15},
-  number = {3},
-  pages = {331--338}
+@Misc{pkg:listings,
+  author = {Carsten Heinz and others},
+  title = {The {\textsf{listings}} package},
+  year = {2015},
+  howpublished = {\url{https://ctan.org/pkg/listings}},
 }
 
-@Misc{Duggan:moreverb:1996,
-  author = {Angus Duggan and Rainer Sch{\umlaut{o}}pf and Victor Eijkhout and
-    Robin Fairbairns},
-  title = {The {\textsf{moreverb}} package},
-  year = {1997},
-  howpublished = {Available from {\CTAN}, {\CTANref{moreverb}}}
+@Misc{Arseneau:url:1996,
+  author = {Donald Arseneau},
+  title = {The {\textsf{url}} package},
+  year = {2013},
+  howpublished = {\url{https://ctan.org/pkg/url}},
 }
 
 @Misc{Rahtz:hyperref:1997,
-  author = {Sebastian Rahtz and Heiko Oberdiek},
-  title = {The {\textsf{hyperref}} system},
-  year = 1997,
-  howpublished = {Available from {\CTAN}, {\CTANref{hyperref}}}
+  author = {Sebastian Rahtz and Heiko Oberdiek and others},
+  title = {The {\textsf{hyperref}} package},
+  year = 2017,
+  howpublished = {\url{https://ctan.org/pkg/hyperref}},
 }
 
 @Book{Lamport:1994,
@@ -73,29 +68,7 @@
   title = {{\LaTeX}: A Document Preparation System},
   edition = {\nth{2}},
   year = {1994},
-  publisher = {Addison-Wesley}
-}
-
-@Article{Ogawa:TB15-3-325,
-  author = {Arthur Ogawa},
-  title = {{{Object-oriented programming, descriptive markup, and {\TeX}}}},
-  journal = {{\TUB}},
-  year = {1994},
-  month = {September},
-  volume = {15},
-  number = {3},
-  pages = {325--330}
-}
-
-@Article{Rowley:TB15-1-63,
-  author = {Chris Rowley},
-  title = {{{{\LaTeXe} update, dateline: 31 January 1994}}},
-  journal = {{\TUB}},
-  year = {1994},
-  month = {March},
-  volume = {15},
-  number = {1},
-  pages = {63}
+  publisher = {Addison-Wesley},
 }
 
 @Misc{Schoepf:verbatim:1996,
@@ -103,25 +76,14 @@
   title = {The {\textsf{verbatim}} package},
   year = {1996},
   month = {June},
-  howpublished = {Part of the \textsf{tools} bundle, available from {\CTAN},
-  {\CTANref{tools}}}
-}
-
-@Article{Swift:TB16-3-269,
-  author = {Matt Swift},
-  title = {Modularity in {\LaTeX}},
-  journal = {{\TUB}},
-  year = {1995},
-  volume = {16},
-  number = {3},
-  pages = {269--275}
+  howpublished = {\url{https://ctan.org/pkg/mflogo}},
 }
 
 @Misc{Vieth:mflogo:1995,
   author = {Ulrik Vieth},
   title = {The {\textsf{mflogo}} package},
-  year = {1995},
-  howpublished = {Available from {\CTAN}, {\CTANref{mflogo}}}
+  year = {1999},
+  howpublished = {\url{https://ctan.org/pkg/mflogo}},
 }
 
 @Article{Whitney:TB10-3-378,
@@ -132,7 +94,8 @@
   month = {November},
   volume = {10},
   number = {3},
-  pages = {378--385}
+  pages = {378--385},
+  note = {\url{https://ctan.org/pkg/tugboat-plain}},
 }
 
 \end{filecontents}
@@ -173,20 +136,19 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
-\documentclass[harvardcite,final]{ltugboat}
+\documentclass[final]{ltugboat}
 \usepackage{microtype}
 \usepackage{ctandir}
 \IfFileExists{booktabs.sty}%
   {\usepackage{booktabs}}%
   {\let\midrule\hline}
 %
-% imperfectly broken pages are ok.
-\vbadness=10000
+\vbadness=10000   % imperfectly broken pages are ok
+\overfullrule=4pt % want to see
 %
 % define CTAN addresses using the commands of the |ctandir| package
 \CTANdirectory{bibextract}{biblio/bibtex/utils/bibextract}
 \CTANdirectory{mflogo}{macros/latex/contrib/mflogo}
-\CTANdirectory{moreverb}{macros/latex/contrib/moreverb}
 \CTANdirectory{packages}{macros/latex/required}
 \CTANdirectory{tools}{macros/latex/required/tools}
 \CTANdirectory{tub-latex}{macros/latex/contrib/tugboat}
@@ -249,11 +211,11 @@
 \begin{document}
 %%%%%%%%%%%%%%%%
 %
-\title{The \LaTeXe\ \TUB{} Macros}
+\title{The \LaTeXe\ \TUB{} macros}
 \author{Robin Fairbairns \& TUGboat editors}
 \EDITORnoaddress
 \netaddress{tugboat@tug.org}
-\personalURL{http://tug.org/TUGboat}
+\personalURL{https://tug.org/TUGboat}
 \maketitle
 
 \section{Introduction}
@@ -268,7 +230,7 @@ Mimi Burbank, and the \LaTeX3 team.
 
 \section{Availability}
 
-\TUB's web pages are at:\\\centerline{\url{http://tug.org/TUGboat}} They
+The \TUB\ web pages are at:\\\centerline{\url{https://tug.org/TUGboat}} They
 include an article template, information for authors and reviewers, all
 the back issues, and more.
 
@@ -342,23 +304,14 @@ They are listed here for completeness.
 \section{Command syntax}
 \label{sec:syntax}
 
-We would have liked to offer perfectly uniform syntax for people to use
-when preparing their papers.  Unfortunately, uniform syntax is not
-available with any widely-available set of macros (though see, for
-example, the discussions in \citeNP{Ogawa:TB15-3-325},
-\citeNP{Baxter:TB15-3-331}, and \citeNP{Swift:TB16-3-269}).  In the
-circumstances, we have sought simply to keep to the spirit of Lamport's
-\citeyear{Lamport:1994}, as modified\footnote{\tubraggedfoot The cited
-  edition of Lamport's book documents the modified version of \LaTeX{},
-  but it's worth emphasising that we use the modified version as the
-  reference.} by the \LaTeXe{} work (see, for example,
-\citeNP{Rowley:TB15-1-63}).
+In general, we have sought simply to keep to the spirit of \LaTeX\ in
+the commands provided by the \TUB\ class (\verb|ltugboat|).
 
 In the few cases that it has proved possible to emulate (what seems to
-a staid old \LaTeX{} programmer, such as the present author) the gay
+a staid old \LaTeX{} programmer, such as the original author here) the gay
 abandon of the syntax of the `plain' \pkgname{tugboat} styles
-\cite{Whitney:TB10-3-378}, we have done.  Nevertheless, on the whole,
-the new \clsname{ltugboat} macros simply define \LaTeX{} commands and
+\cite{Whitney:TB10-3-378}, we have done so.  Nevertheless, on the whole,
+the new \clsname{ltugboat} macros define \LaTeX{} commands and
 environments, or modify the definitions of \LaTeX{} `standard'
 commands.  Section~\ref{sec:equiv} lists equivalences between macros
 defined by the `plain' package and those defined by the new package.
@@ -470,7 +423,7 @@ For example, the present paper has at its start:
 \author{TUGboat editors}
 \EDITORnoaddress
 \netaddress{tugboat@tug.org}
-\personalURL{http://tug.org/TUGboat}
+\personalURL{https://tug.org/TUGboat}
 \maketitle
 \end{verbatim}
 
@@ -539,19 +492,14 @@ between the \cs{maketitle} and (possibly) \cs{makesignature} commands.
 \author{Robin Fairbairns}
 \address{University of Cambridge ...}
 \netaddress{...}
- ...
- |emph[introductory text]
- ...
+ ... |textsl[introductory text] ...
 \makesignature
 
 \contributor{Betsy the Dog}
 \address{Romsey Town, Cambridge}
- ...
- |emph[Betsy's contribution]
- ...
-\makesignature
-
+ ... |textsl[Betsy's contribution] ...
 ...
+\makesignature ...
 \end{verbatim}
 
 \section{Verbatim text}
@@ -569,51 +517,73 @@ course, is highly restricted as to its usage (primarily, that it may
 not appear in the argument of \emph{any} other macro, even
 \cs{footnote}).
 
-For `display verbatim' (to employ the term used by
-\citeANP{Whitney:TB10-3-378}), the classes add a small increment to
+For displayed verbatim text, the classes add a small increment to
 the functionality of \LaTeX{}'s \envname{verbatim} environment, by
 introducing an optional argument.  The optional argument may contain
 commands to be executed before starting the verbatim text; the set of
 commands which have useful effect is strictly limited, but the
 following are commonly used:
 \begin{itemize}
-\itemsep=0.2\itemsep
 \item Font size selection commands: for example, all the display
-  verbatim in the present paper starts with:
-  
-  {\small\verb| \begin{verbatim}[\small]|}
+  verbatim in the present paper starts with
+  \verb|\begin{verbatim}[\small]|.
+
 \item The command \cs{ruled}, which is available \emph{only} in
   \envname{verbatim}'s optional argument, and specifies that a
-  column-wide rule should be drawn before and after the verbatim text
-\item One of the \cs{make*} commands,\footnote{\cs{makeescape},
-    \cs{makebgroup}, \dots, \cs{makecomment}; used, for example, as
-    \cs{makeescape}\cs{|}} which change the category code of
+  column-wide rule should be drawn before and after the verbatim
+  text. (This is not the recommended style in general, but it's
+  available for when it helps.)
+
+\item The command \cs{makevmeta}, also available only in
+  \envname{verbatim}'s optional argument, and makes the construct
+  \verb|!<...>| inside verbatim execute \verb|\meta{...}|. For example,
+\begin{verbatim}[\small] 
+\begin{verbatim}[\small\makevmeta]
+The !<duration> is long ...
+\end{verbatim}
+produces:
+\begin{verbatim}[\small\makevmeta]
+The !<duration> is long ...
+\end{verbatim}
+
+\item More generally, one of the \cs{make*} commands,\footnote{\cs{makeescape},
+  \cs{makebgroup}, \dots, \cs{makecomment}; used, for example, as
+  \cs{makeescape}\cs{|}.} which change the category code of
   characters within the verbatim text.  This is (of course) a facility
-  that should only be used with the utmost caution, but it can, for
-  example, be employed to provide interesting effects by knowledgeable
-  authors.
+  that should only be used with the utmost caution.
+
 \end{itemize}
-Two caveats about the use of this facility should be noted:
+Two caveats about these optional arguments:
 \begin{itemize}
-\itemsep=0.2\itemsep
 \item The search for the optional argument can be confused by the
-  appearance of a \verb|[| character as the first of the displayed
+  appearance of a \verb|[| character as the first character of the displayed
   verbatim.  An author who wishes to start verbatim text with a
   \verb|[| character should provide an empty optional argument (i.e.,
-  simply `\verb|[]|') to the \envname{verbatim} environment.
-\item The facility is lost when certain packages are loaded.  An
-  example is the \pkgname{verbatim} package
-  \cite{Schoepf:verbatim:1996}, which redefines the \envname{verbatim}
-  environment in its entirety.  Of course, any package that loads
-  \pkgname{verbatim} (such as \pkgname{moreverb},
-  \shortciteNP{Duggan:moreverb:1996}) will necessarily have the same
-  effect.  (It should be noted that \pkgname{verbatim} and
-  \pkgname{moreverb} provide some of the facilities that are available
-  in the `plain' \pkgname{tugboat} styles, so that an author could
-  reasonably be tempted to use them.  There is no objection in
-  principle to authors using these packages.)
+  `\verb|[]|') to the \envname{verbatim} environment.
+\item The \TUB\ facility is lost when anything is loaded that also defines the
+  \verb|verbatim| environment, as discussed next.
 \end{itemize}
 
+Authors may wish to use a more featureful verbatim package, such as such
+as \pkgname{verbatim}~\cite{Schoepf:verbatim:1996},
+\pkgname{listings}~\cite{pkg:listings}, or
+\pkgname{fancyvrb}~\cite{pkg:fancyvrb}. This is ok; it just means the
+\TUB\ optional-argument feature is not available.
+
+If you use the \pkgname{listings} package, please specify:
+\begin{verbatim}
+\lstset{columns=flexible}
+\end{verbatim}
+The other values for the \verb|columns| option don't work well in
+\TUB. Also, if you use \cs{small} for displayed verbatim, please reset
+inline verbatim to the normal text size:
+\begin{verbatim}[\small]
+\lstset{columns=flexible,
+        basicstyle=\ttfamily\small}
+\lstdefinestyle{inline}
+  {basicstyle=\ttfamily\normalsize}
+\end{verbatim}
+
 \section{Floating inserts}
 
 The classes do not make any change to \LaTeX{}'s built-in provision
@@ -649,7 +619,7 @@ set of the macros.
 The classes provide macros that produce `correct' representations of a
 large number of acronyms and logos; a small representative selection is
 shown in figure~\ref{fig:acro-logo}.  The sample documents at
-\url{http://tug.org/TUGboat/location.html} have a more complete list,
+\url{https://tug.org/TUGboat/location.html} have a more complete list,
 and of course the class sources are the ultimate reference.
 \begin{figure}[htbp!]
   \begin{center}
@@ -663,12 +633,12 @@ and of course the class sources are the ultimate reference.
       \verb|\FAQ|    & \FAQ \\
       \verb|\HTML|   & \HTML \\
       \verb|\ISBN|   & \ISBN \\
+      \verb|\KOMAScript| & \KOMAScript \\
       \verb|\LaTeXe| & \LaTeXe \\
       \verb|\MacOSX| & \MacOSX \\
       \verb|\MathML| & \MathML \\
       \verb|\MF|     & \MF \\
       \verb|\MP|     & \MP \\
-      \verb|\NTS|    & \NTS \\
       \verb|\OMEGA|  & \OMEGA \\
       \verb|\PDF|    & \PDF \\
       \verb|\SGML|   & \SGML \\
@@ -678,18 +648,18 @@ and of course the class sources are the ultimate reference.
       \verb|\XML|    & \XML \\
     \end{tabular}
   \end{center}
-  \caption{A few of the classes' acronyms and logos}
+  \caption{A few of the provided acronyms and logos}
   \label{fig:acro-logo}
 \end{figure}
 
 Authors are especially urged to note the \cs{acro} command, which is
 defined in the classes.  The visual appearance of (mostly) lower-case
 English text, with interpolated acronyms in the same point size, is
-generally unpleasing.  Therefore, the \cs{acro} command typesets its
-argument slightly smaller than it would otherwise appear: compare
-`\acro{URL}' (\verb|\acro{URL}|, as used above) with `URL'\@.  Many
-macros that simply generate calls to \cs{acro} are defined by the
-classes; two examples, \cs{CTAN} and \cs{tug} of the list in
+generally unpleasing in Computer Modern.  Therefore, the \cs{acro}
+command typesets its argument slightly smaller than it would otherwise
+appear: compare `\acro{DANTE}' (\verb|\acro{DANTE}|) with `DANTE'\@.
+Many of the provided macros merely generate calls to \cs{acro}; two
+examples, \cs{CTAN} and \cs{tug} of the list in
 figure~\ref{fig:acro-logo} have already been used in the present paper.
 
 \subsection{Other special typesetting}
@@ -697,22 +667,22 @@ figure~\ref{fig:acro-logo} have already been used in the present paper.
 A small list of special typesetting commands follows: a large set of
 such commands is defined in the classes, but the list covers most of
 the `everyday' ones.
-\begin{cmdlist}
-\item[\cs{cmd}] Typeset a control sequence name.  (The command
-  \verb|\cs{fred}| is typeset as \cs{fred}.)
-\item[\env{environment}] Typeset an environment name as if at the
-  start of the environment.  (The command \verb|\env{fred}| is typeset
-  as \env{fred}.)
-\item[\meta{arg}] Typeset a formal argument name.  (The command
-  \verb|\meta{fred}| is typeset as \meta{fred}.)
-\item[\Dash] Typeset an em-dash, surrounded by thin spa\-ces, only
-  breakable \emph{after} the dash; this is the preferred method of
-  specifying a dash in running text.
-\item[\dash] Typeset an en-dash, in the same way as \cs{Dash} does.
-\item[\nth{n}] Typeset an ordinal number.  For example, \verb|\nth{1}| is
+\begin{cmdlist}\raggedright
+\item[\Dash] Typeset an em-dash, ignoring preceding and following space,
+  surrounded by thin spaces, only breakable \emph{after} the dash; this
+  is the preferred method of specifying a dash in running text.
+\item[\cs{cmd}] Typeset a control sequence name:\\
+  \verb|\cs{fred}| produces \cs{fred}.
+\item[\env{environ}] Typeset the command to begin an environment:
+  \verb|\env{fred}| produces \env{fred}.
+\item[\meta{var}] Typeset meta-syntactic text:\\
+  \verb|\meta{fred}| produces \meta{fred}.
+\item[\tubbraced{text}] Typeset typewriter text in typewriter
+  braces: \verb|\tubbraced{fred}| produces \tubbraced{fred}.
+\item[\nth{n}] Typeset an ordinal number; \verb|\nth{1}| is
   set as \nth{1}, \verb|\nth{27}| is set as \nth{27}, and so on.
-\item[\sfrac{num}{denom}] Typeset a fraction to match running text;
-  for example \verb|\sfrac{3}{4}| is set as \sfrac{3}{4}\,.
+%\item[\sfrac{num}{denom}] Typeset a fraction to match running text;
+%  for example \verb|\sfrac{3}{4}| is set as \sfrac{3}{4}\,.
 \end{cmdlist}
 
 \section{Use of packages}
@@ -729,23 +699,16 @@ In general, packages currently on \CTAN, and known to work with
 In particular, the team is happy to accept papers using packages
 that are supported by members of the \LaTeX3 team,\footnote{%
   Those in the \LaTeX{} base distribution, or one of those in the
-  \CTANref{packages} sub-tree on \CTAN.} subject to the two provisos:
+  \CTANref{packages} sub-tree on \CTAN.} subject to the warning:
 \begin{itemize}
 \item Use of the \pkgname{verbatim} package has implications for the
   \envname{verbatim} facilities provided by the classes\Dash see
   section~\ref{sec:verbatim}.
-\item Use of \pkgname{babel} almost inevitably implies use of
-  hyphenation patterns that the team may not have installed in their
-  \LaTeX{} format; it is therefore important that the author explains
-  her \pkgname{babel} configuration to the editorial team.  The
-  minimum documentation required is a copy of the author's
-  \url{language.dat} file, and copies (or \CTAN{} pointers to) any
-  hyphenation files used.
 \end{itemize}
 
 Usage of other packages should always be subject to negotiation with
 the team.  If the team does not have access to a copy of the package,
-life is going to be very difficult; authors are urged to be sensible
+life is going to be very difficult; authors need to be sensible
 in this regard.  A sensible mechanism for submitting
 out-of-the-ordinary packages (as for paper-specific bibliographies) is
 by use of the \envname{filecontents} environment.
@@ -787,11 +750,11 @@ particular packages for the subject at hand.
 \section{Bibliography}
 \label{sec:biblio}
 
-In short: our recommendation for handling bibliographies is to use
+In short: our basic recommendation for handling bibliographies is to use
 \BibTeX\ and the \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:
+source (as shown in the template available from
+\url{https://tug.org/TUGboat}) is the following:
 
 \begin{verbatim}[\small]
 \bibliographystyle{plain}
@@ -821,19 +784,15 @@ deliver the bibliography file.
 A special case is the accumulated bibliography of \TUB{}
 itself;\footnote{\tubraggedfoot Available on \CTAN{} as
   \CTANref{tub-biblio}} it is always available to the production team,
-so that authors may make reference to items from the \verb|tugboat.bib|
+so authors may reference items from the \verb|tugboat.bib|
 file without further ado.
 
 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}
-package\footnote{\tubraggedfoot Available on \CTAN{} as \CTANref{cite}}
-is acceptable.  Raw citation is selected by default (by execution of
-class option \optname{rawcite}).
+and `\texttt{harvard}'. The raw citation style uses the `standard'
+\BibTeX{} `\pkgname{plain}' (numeric) citation style. Raw citation is
+selected by default (by execution of 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
@@ -892,7 +851,7 @@ may control the typesetting using the command
 \end{verbatim}
 as the present article does, to achieve somewhat better results.
 
-\section{Equivalences between the `plain' and the \LaTeX{} packages}
+\section{Equivalences between the `plain' and \LaTeX{} \TUB\ packages}
 \label{sec:equiv}
 
 A good proportion of the commands in the `plain' packages also appear
@@ -915,7 +874,7 @@ differ significantly.
       \cs{figure}   & \envname{figure} or \envname{figure*} environments \\
     \end{tabular}
   \end{center}
-  \caption{Equivalences between \pkgname{plain} and \LaTeX{} macros}
+  \caption{Equivalences between \pkgname{plain} and \LaTeX{} \TUB\ macros}
   \label{fig:plain-equiv}
 \end{figure}
 
@@ -925,9 +884,9 @@ macros.
 
 The `plain' styles' provision for verbatim text is also somewhat
 different from the \LaTeX{} approach; the \TUB{} classes offer a small
-subset of the extra facilities that the `plain' styles provide; for
-more elaborate facilities, the user is referred to the
-\pkgname{verbatim} and \pkgname{moreverb} packages (see
+subset of the extra facilities that the `plain' styles provide; for more
+elaborate facilities, the user is referred to the \pkgname{verbatim},
+\pkgname{listings}, and \pkgname{fancyvrb} packages (see
 section~\ref{sec:verbatim}).
 
 Of course, the syntax of commands given to the \LaTeX{} classes is
@@ -938,10 +897,8 @@ argument provision promulgated by the `plain' macros
 \cs{macro * }\meta{argument}\verb| *|) are provided by the \LaTeX{}
 classes.
 
-%\EdNote[Should I mention the lack of \cs{every*} token registers (for
-%all sorts of instances of \texttt{*}?)]
-
 \SetBibJustification{\raggedright}
+\bibliographystyle{plain}
 \bibliography{tubguide}
 
 \makesignature
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf b/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
index 7d7193ba8d5..d840a525385 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 8f04c2e288e..e179bd1c634 100644
--- a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
+++ b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
diff --git a/Master/texmf-dist/source/latex/tugboat/tugboat.dtx b/Master/texmf-dist/source/latex/tugboat/tugboat.dtx
index ef847134e70..75d987cccfc 100644
--- a/Master/texmf-dist/source/latex/tugboat/tugboat.dtx
+++ b/Master/texmf-dist/source/latex/tugboat/tugboat.dtx
@@ -1,8 +1,8 @@
 % \iffalse (this is a meta-comment (so they say))
-% $Id: tugboat.dtx 172 2016-11-07 19:29:41Z karl $
+% $Id: tugboat.dtx 187 2017-11-06 20:29:32Z karl $
 % tugboat.dtx - main source for LaTeX TUGboat classes.
 %
-% Copyright 1994-2016 TeX Users Group.
+% Copyright 1994-2017 TeX Users Group.
 %
 % This file is part of the tugboat package.
 %
@@ -28,7 +28,7 @@
 %<ltugboatsty>\ProvidesPackage{ltugboat}
 %<ltugprocsty>\ProvidesPackage{ltugproc}
 %<ltugcomn>   \ProvidesPackage{ltugcomn}
-                   [2016/11/07 v2.18
+                   [2017/11/06 v2.19
 %<ltugboatcls>                       TUGboat journal class%
 %<ltugproccls>                       TUG conference proceedings class%
 %<ltugboatsty|ltugprocsty>           TUG compatibility package%
@@ -101,8 +101,7 @@
  \title{The \textsf{tugboat} package\thanks{This file
         has version number \fileversion, last
         revised \filedate}}
-    \author{The \TUB{} team\\
-            \small(Distributed by Robin Fairbairns)}
+    \author{The \TUB{} team}
  \date{\filedate}
  \maketitle
  \tableofcontents
@@ -256,7 +255,7 @@
 % |\careof|&     c/o\\
 % |\sfrac|&      slashed fraction (arguments optionally\\
 % &              separated by a slash)\\
-% |\cs|&         control seqence name\\
+% |\cs|&         control sequence name\\
 %      &         |\cs{name}|$\rightarrow$\cs{name}\\
 % |\env|&        environment name \\
 %       &        |\env{name}|$\rightarrow$\env{name}\\
@@ -662,9 +661,10 @@
   \ifdim \fontdimen1\font>0pt
      B{\SMC\SMC IB}%
   \else
-     \textsc{Bib}%
+     B\textsc{ib}%
   \fi
 }
+\def\BibLaTeX{\Bib\kern.02em \LaTeX}
 \def\BibTeX{\Bib\kern-.08em \TeX}
 %
 \def\BSD{\acro{BSD}}
@@ -678,9 +678,9 @@
 \def\Cplusplus{C\plusplus}
 \def\plusplus{\raisebox{.7ex}{$_{++}$}}
 \def\CPU{\acro{CPU}}
-\def\CSabbr{\ensuremath{\cal C}\kern-.1667em\lower.5ex\hbox{$\cal S$}}
+\def\CSczabbr{\ensuremath{\cal C}\kern-.1667em\lower.5ex\hbox{$\cal S$}}
 \def\CSS{\acro{CSS}}
-\def\CSTUG{\CSabbr\acro{TUG}}
+\def\CSTUG{\CSczabbr\acro{TUG}}
 \def\CSV{\acro{CSV}}
 \def\CTAN{\acro{CTAN}}
 \def\DTD{\acro{DTD}}
@@ -710,6 +710,8 @@
 \def\JPEG{\acro{JPEG}}
 \def\JTeX{\leavevmode\hbox{\lower.5ex\hbox{J}\kern-.18em\TeX}}
 \def\JoT{\textsl{The Joy of \TeX}}
+\DeclareRobustCommand{\KOMAScript}{\textsf{K\kern.05em O\kern.05em%
+     M\kern.05em A\kern.1em-\kern.1em Script}}
 \def\LAMSTeX{L\raise.42ex\hbox{\kern-.3em
                    $\m@th$\fontsize\sf@size\z@\selectfont
                    $\m@th\mathcal{A}$}%
@@ -1121,9 +1123,8 @@
 % don't stay bold in description items, bold italic is too weird.
 \DeclareRobustCommand\meta[1]{%
   \ensuremath{\langle}%
-  \ifmmode \mbox\bgroup \fi % if in math
+  \ifmmode \expandafter\mbox \fi % if in math
   {\it #1\/}% no typewriter italics, please
-  \ifmmode \egroup \fi
   \ensuremath{\rangle}%
 }
 %
@@ -2231,7 +2232,7 @@
       \let\and=\quad
       \ignorespaces\@author}%
     {%
-      \noindent\bf\raggedright\ignorespaces\@title\endgraf
+      \noindent\bf\raggedright\ignorespaces\frenchspacing\@title\endgraf
     }%
     \ifdim \wd0 < 5\p@               % omit if author is null
     \else
@@ -2808,8 +2809,24 @@
   \def\ruled{\let\if@ruled\iftrue}%
 %    \end{macrocode}
 %
-% Then we just execute the ones we've got, and relay to a (hacked)
-% copy of the built-in environment.
+% The command \cs{makevmeta} says to make !<...> do \meta{...}.
+%
+%    \begin{macrocode}
+  \def\makevmeta{\makeescape\! \let\<\tubverb@meta \tubverb@clearliglist}
+  \def\tubverb@meta##1>{\meta{##1}}
+%    \end{macrocode}
+%
+% The default verbatim defines `'<>,- as active characters to do
+% stop ligatures; remove <> from the list so we get normal characters.
+% Just hope that the CM <> ligatures aren't used.
+%    \begin{macrocode}
+  \def\tubverb@clearliglist{%
+    \def\verbatim@nolig@list{\do\`\do\,\do\'\do\-}%
+  }
+%    \end{macrocode}
+%
+% Then we execute the arguments we've got, and relay to a (hacked)
+% copy of the \LaTeX\ verbatim environment.
 %
 %    \begin{macrocode}
   #1\@TBverbatim}
@@ -2847,7 +2864,7 @@
   \obeylines \verbatim@font \@noligs
   \let\do\@makeother \dospecials
   \everypar \expandafter{\the\everypar \unpenalty}%
-}%
+}% end |\@sqbverbatim|
 %    \end{macrocode}
 %
 % To end the environment, we do everything in reverse order: relay via
@@ -3164,22 +3181,19 @@
 % can be used to reset the font, e.g., tb98kuester.
 \def\tubheadhook{}
 
+% in case the official \author is too verbose for the footline.
+\def\tubrunningauthor{\@author}
+
 % put title and author in footer.
 \def\@tubrunningfull{%
   \def\@oddfoot{% make line break commands produce a normal space
     \def\\{\unskip\ \ignorespaces}%
     \let\newline=\\%
+    \frenchspacing
     \hfil\rhTitle}
-  \def\@evenfoot{\@author\hfil}
+  \def\@evenfoot{\tubrunningauthor\hfil}
 }
 
-\def\@tubrunninggetauthor#1{#1%
-  \begingroup
-    \let\thanks\@gobble
-    \protected@xdef\rhAuthor{\the\toks@##1}%
-  \endgroup
-}%
-
 % empty footer.
 \def\@tubrunningminimal{%
   \def\@oddfoot{\hfil}%
diff --git a/Master/texmf-dist/tex/latex/tugboat/ltugboat.cls b/Master/texmf-dist/tex/latex/tugboat/ltugboat.cls
index 6963e383dfc..a1ef7d5d591 100644
--- a/Master/texmf-dist/tex/latex/tugboat/ltugboat.cls
+++ b/Master/texmf-dist/tex/latex/tugboat/ltugboat.cls
@@ -33,7 +33,7 @@
 %% 
 \NeedsTeXFormat{LaTeX2e}[1994/12/01]
 \ProvidesClass  {ltugboat}
-                   [2016/11/07 v2.18
+                   [2017/11/06 v2.19
                        TUGboat journal class%
                    ]
 \csname tugstyloaded@\endcsname
@@ -184,9 +184,10 @@
   \ifdim \fontdimen1\font>0pt
      B{\SMC\SMC IB}%
   \else
-     \textsc{Bib}%
+     B\textsc{ib}%
   \fi
 }
+\def\BibLaTeX{\Bib\kern.02em \LaTeX}
 \def\BibTeX{\Bib\kern-.08em \TeX}
 \def\BSD{\acro{BSD}}
 \def\CandT{\textsl{Computers \& Typesetting}}
@@ -195,9 +196,9 @@
 \def\Cplusplus{C\plusplus}
 \def\plusplus{\raisebox{.7ex}{$_{++}$}}
 \def\CPU{\acro{CPU}}
-\def\CSabbr{\ensuremath{\cal C}\kern-.1667em\lower.5ex\hbox{$\cal S$}}
+\def\CSczabbr{\ensuremath{\cal C}\kern-.1667em\lower.5ex\hbox{$\cal S$}}
 \def\CSS{\acro{CSS}}
-\def\CSTUG{\CSabbr\acro{TUG}}
+\def\CSTUG{\CSczabbr\acro{TUG}}
 \def\CSV{\acro{CSV}}
 \def\CTAN{\acro{CTAN}}
 \def\DTD{\acro{DTD}}
@@ -227,6 +228,8 @@
 \def\JPEG{\acro{JPEG}}
 \def\JTeX{\leavevmode\hbox{\lower.5ex\hbox{J}\kern-.18em\TeX}}
 \def\JoT{\textsl{The Joy of \TeX}}
+\DeclareRobustCommand{\KOMAScript}{\textsf{K\kern.05em O\kern.05em%
+     M\kern.05em A\kern.1em-\kern.1em Script}}
 \def\LAMSTeX{L\raise.42ex\hbox{\kern-.3em
                    $\m@th$\fontsize\sf@size\z@\selectfont
                    $\m@th\mathcal{A}$}%
@@ -448,9 +451,8 @@
                             \selectfont#2}$}}
 \DeclareRobustCommand\meta[1]{%
   \ensuremath{\langle}%
-  \ifmmode \mbox\bgroup \fi % if in math
+  \ifmmode \expandafter\mbox \fi % if in math
   {\it #1\/}% no typewriter italics, please
-  \ifmmode \egroup \fi
   \ensuremath{\rangle}%
 }
 \DeclareRobustCommand{\cs}[1]{{\tt \char`\\#1}}
@@ -980,7 +982,7 @@
       \let\and=\quad
       \ignorespaces\@author}%
     {%
-      \noindent\bf\raggedright\ignorespaces\@title\endgraf
+      \noindent\bf\raggedright\ignorespaces\frenchspacing\@title\endgraf
     }%
     \ifdim \wd0 < 5\p@               % omit if author is null
     \else
@@ -1263,6 +1265,11 @@
   \def\reserved@b{\@sqbverbatim[]}\expandafter\reserved@b\fi}
 \def\@sqbverbatim[#1]{%
   \def\ruled{\let\if@ruled\iftrue}%
+  \def\makevmeta{\makeescape\! \let\<\tubverb@meta \tubverb@clearliglist}
+  \def\tubverb@meta##1>{\meta{##1}}
+  \def\tubverb@clearliglist{%
+    \def\verbatim@nolig@list{\do\`\do\,\do\'\do\-}%
+  }
   #1\@TBverbatim}
 \def\@verbatim{%
     \if@ruled\trivlist\item\hrule\kern5\p@\nobreak\fi
@@ -1282,7 +1289,7 @@
   \obeylines \verbatim@font \@noligs
   \let\do\@makeother \dospecials
   \everypar \expandafter{\the\everypar \unpenalty}%
-}%
+}% end |\@sqbverbatim|
 \def\endverbatim{\@TBendverbatim
   \if@ruled\kern5\p@\hrule\endtrivlist\fi}
 \let\if@ruled\iffalse
@@ -1441,21 +1448,17 @@
 
 \def\tubheadhook{}
 
+\def\tubrunningauthor{\@author}
+
 \def\@tubrunningfull{%
   \def\@oddfoot{% make line break commands produce a normal space
     \def\\{\unskip\ \ignorespaces}%
     \let\newline=\\%
+    \frenchspacing
     \hfil\rhTitle}
-  \def\@evenfoot{\@author\hfil}
+  \def\@evenfoot{\tubrunningauthor\hfil}
 }
 
-\def\@tubrunninggetauthor#1{#1%
-  \begingroup
-    \let\thanks\@gobble
-    \protected@xdef\rhAuthor{\the\toks@##1}%
-  \endgroup
-}%
-
 \def\@tubrunningminimal{%
   \def\@oddfoot{\hfil}%
   \def\@evenfoot{\hfil}%
diff --git a/Master/texmf-dist/tex/latex/tugboat/ltugboat.sty b/Master/texmf-dist/tex/latex/tugboat/ltugboat.sty
index a25f03f76b5..cac733c3655 100644
--- a/Master/texmf-dist/tex/latex/tugboat/ltugboat.sty
+++ b/Master/texmf-dist/tex/latex/tugboat/ltugboat.sty
@@ -32,7 +32,7 @@
 %% extension .ins) which are part of the distribution.
 %% 
 \ProvidesPackage{ltugboat}
-                   [2016/11/07 v2.18
+                   [2017/11/06 v2.19
            TUG compatibility package%
                    ]
 \@obsoletefile{ltugboat.cls}{ltugboat.sty}
diff --git a/Master/texmf-dist/tex/latex/tugboat/ltugcomn.sty b/Master/texmf-dist/tex/latex/tugboat/ltugcomn.sty
index 4a8ba4911a8..14dfba4f7de 100644
--- a/Master/texmf-dist/tex/latex/tugboat/ltugcomn.sty
+++ b/Master/texmf-dist/tex/latex/tugboat/ltugcomn.sty
@@ -33,7 +33,7 @@
 %% 
 \NeedsTeXFormat{LaTeX2e}[1994/12/01]
    \ProvidesPackage{ltugcomn}
-                   [2016/11/07 v2.18
+                   [2017/11/06 v2.19
                           TUGboat `common macros' package%
                    ]
 \IfFileExists{mflogo.sty}%
@@ -114,9 +114,10 @@
   \ifdim \fontdimen1\font>0pt
      B{\SMC\SMC IB}%
   \else
-     \textsc{Bib}%
+     B\textsc{ib}%
   \fi
 }
+\def\BibLaTeX{\Bib\kern.02em \LaTeX}
 \def\BibTeX{\Bib\kern-.08em \TeX}
 \def\BSD{\acro{BSD}}
 \def\CandT{\textsl{Computers \& Typesetting}}
@@ -125,9 +126,9 @@
 \def\Cplusplus{C\plusplus}
 \def\plusplus{\raisebox{.7ex}{$_{++}$}}
 \def\CPU{\acro{CPU}}
-\def\CSabbr{\ensuremath{\cal C}\kern-.1667em\lower.5ex\hbox{$\cal S$}}
+\def\CSczabbr{\ensuremath{\cal C}\kern-.1667em\lower.5ex\hbox{$\cal S$}}
 \def\CSS{\acro{CSS}}
-\def\CSTUG{\CSabbr\acro{TUG}}
+\def\CSTUG{\CSczabbr\acro{TUG}}
 \def\CSV{\acro{CSV}}
 \def\CTAN{\acro{CTAN}}
 \def\DTD{\acro{DTD}}
@@ -157,6 +158,8 @@
 \def\JPEG{\acro{JPEG}}
 \def\JTeX{\leavevmode\hbox{\lower.5ex\hbox{J}\kern-.18em\TeX}}
 \def\JoT{\textsl{The Joy of \TeX}}
+\DeclareRobustCommand{\KOMAScript}{\textsf{K\kern.05em O\kern.05em%
+     M\kern.05em A\kern.1em-\kern.1em Script}}
 \def\LAMSTeX{L\raise.42ex\hbox{\kern-.3em
                    $\m@th$\fontsize\sf@size\z@\selectfont
                    $\m@th\mathcal{A}$}%
@@ -378,9 +381,8 @@
                             \selectfont#2}$}}
 \DeclareRobustCommand\meta[1]{%
   \ensuremath{\langle}%
-  \ifmmode \mbox\bgroup \fi % if in math
+  \ifmmode \expandafter\mbox \fi % if in math
   {\it #1\/}% no typewriter italics, please
-  \ifmmode \egroup \fi
   \ensuremath{\rangle}%
 }
 \DeclareRobustCommand{\cs}[1]{{\tt \char`\\#1}}
diff --git a/Master/texmf-dist/tex/latex/tugboat/ltugproc.cls b/Master/texmf-dist/tex/latex/tugboat/ltugproc.cls
index c156ce7655f..17c4958c4a6 100644
--- a/Master/texmf-dist/tex/latex/tugboat/ltugproc.cls
+++ b/Master/texmf-dist/tex/latex/tugboat/ltugproc.cls
@@ -33,7 +33,7 @@
 %% 
 \NeedsTeXFormat{LaTeX2e}[1994/12/01]
 \ProvidesClass  {ltugproc}
-                   [2016/11/07 v2.18
+                   [2017/11/06 v2.19
                        TUG conference proceedings class%
                    ]
 \def\@tugclass{ltugproc}
diff --git a/Master/texmf-dist/tex/latex/tugboat/ltugproc.sty b/Master/texmf-dist/tex/latex/tugboat/ltugproc.sty
index d26c10ef59e..c73c00b82d5 100644
--- a/Master/texmf-dist/tex/latex/tugboat/ltugproc.sty
+++ b/Master/texmf-dist/tex/latex/tugboat/ltugproc.sty
@@ -32,7 +32,7 @@
 %% extension .ins) which are part of the distribution.
 %% 
 \ProvidesPackage{ltugproc}
-                   [2016/11/07 v2.18
+                   [2017/11/06 v2.19
            TUG compatibility package%
                    ]
 \@obsoletefile{ltugproc.cls}{ltugproc.sty}