tugboat (15nov20)

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

5 files changed, 75 insertions, 43 deletions

diff --git a/Master/texmf-dist/doc/latex/tugboat/NEWS b/Master/texmf-dist/doc/latex/tugboat/NEWS
new file mode 100644
index 00000000000..a640030d7b8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tugboat/NEWS
@@ -0,0 +1,14 @@
+$Id: NEWS 314 2020-11-15 02:06:03Z karl $
+This file records noteworthy changes.  This file is public domain.
+
+2.24 (2020-11-14):
+
+ltugboat.cls:
+- new hyphenation exceptions: Ja-pa-nese, Pak-i-stan.
+- new abbrevations: \macOS, \OpTeX.
+
+tugboat.bst:
+- new field bookauthor for @incollection and @inproceedings.
+- generalize truncation of author names with new code from
+  Oren Patashnik, using integers max.names and trunc.num
+  to control operation.
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx b/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
index db9f183dac0..4c7ea0b25eb 100644
--- a/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
+++ b/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
@@ -1,4 +1,4 @@
-% $Id: ltubguid.ltx 274 2020-03-12 16:47:21Z karl $
+% $Id: ltubguid.ltx 313 2020-11-15 01:52:20Z karl $
 % ltubguid.ltx - documentation for ltugboat classes.
 % 
 % Copyright 1994-2020 TeX Users Group.
@@ -38,25 +38,26 @@
 @Misc{pkg:fancyvrb,
   author = {Timothy Van Zandt and others},
   title = {The {\textsf{fancyvrb}} package},
-  howpublished = {\url{ctan.org/pkg/fancyvrb}},
+  url = {ctan.org/pkg/fancyvrb},
 }
 
 @Misc{pkg:listings,
   author = {Carsten Heinz and others},
   title = {The {\textsf{listings}} package},
-  howpublished = {\url{ctan.org/pkg/listings}},
+  url = {ctan.org/pkg/listings},
 }
 
 @Misc{Arseneau:url:1996,
   author = {Donald Arseneau},
   title = {The {\textsf{url}} package},
-  howpublished = {\url{ctan.org/pkg/url}},
+  url = {ctan.org/pkg/url},
+  urlnewline = 1,
 }
 
 @Misc{Rahtz:hyperref:1997,
   author = {Sebastian Rahtz and Heiko Oberdiek and others},
   title = {The {\textsf{hyperref}} package},
-  howpublished = {\url{ctan.org/pkg/hyperref}},
+  url = {ctan.org/pkg/hyperref},
 }
 
 @Book{Lamport:1994,
@@ -68,15 +69,17 @@
 }
 
 @Misc{Schoepf:verbatim:1996,
-  author = {Rainer Sch{\umlaut{o}}pf},
+  author = {Rainer Sch{\"{o}}pf},
   title = {The {\textsf{verbatim}} package},
-  howpublished = {\url{ctan.org/pkg/verbatim}},
+  url = {ctan.org/pkg/verbatim},
+  urlnewline = 1,
 }
 
 @Misc{Vieth:mflogo:1995,
   author = {Ulrik Vieth},
   title = {The {\textsf{mflogo}} package},
-  howpublished = {\url{ctan.org/pkg/mflogo}},
+  url = {ctan.org/pkg/mflogo},
+  urlnewline = 1,
 }
 
 @Article{Whitney:TB10-3-378,
@@ -88,7 +91,7 @@
   volume = {10},
   number = {3},
   pages = {378--385},
-  note = {\url{ctan.org/pkg/tugboat-plain}},
+  url = {ctan.org/pkg/tugboat-plain},
 }
 
 \end{filecontents}
@@ -184,10 +187,6 @@
 }
 \makeatother
 %
-% To use umlauts in a bibliography entry in BibTeX 0.99, we have to
-% use a certain amount of subterfuge...
-\let\umlaut\"
-%
 %%%%%%%%%%%%%%%%
 \begin{document}
 %%%%%%%%%%%%%%%%
@@ -262,8 +261,7 @@ and one/two-side options).
 \item[final] Set up for the final copy of a paper: page numbering to
   come from elsewhere, no cropmarks.
 \item[harvardcite] Specify Harvard-style citation (not 
-  recommended in general; see section~\ref{sec:biblio}); see
-  section~\ref{sec:biblio}.
+  recommended in general; 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}.
 \item[nonumber] Sections are not numbered; section heading
@@ -315,17 +313,26 @@ relies on the section numbers to indicate where the divisions lie in
 the hierarchy.  If you use \cs{paragraph}, consider ending the paragraph
 label with a period; sometimes it is helpful, sometimes not.
 
-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
+For references to numbered sections, our style is to always use the word
+`Section' in the text, e.g.,\\
+\verb|Section~\ref{sec:whatever}|\\
+without worrying about whether it is technically a sub(sub)section.
+It's also ok to use the section sign~\S{}, if that suits the material
+better.
+
+Reference can also 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
 \cite{Rahtz:hyperref:1997}) permits such references; for example, the
 present section was introduced by:
 \begin{verbatim}[\small]
-  \section{Divisions of the paper}
-  \label{sec:divs-paper}
+\section{Divisions of the paper}
+\label{sec:divs-paper}
 \end{verbatim}
 and the command \verb|\nameref{sec:divs-paper}| produces
-`\nameref{sec:divs-paper}'.
+`\nameref{sec:divs-paper}'. However, as you can see here, reusing the
+literal text of section titles often results in awkward results. We
+recommend numbered references in general.
 
 \subsection{Abstracts}
 
@@ -336,6 +343,8 @@ title is `Abstract'. The \envname{longabstract} environment typesets its
 body in small text, and separates the abstract from the rest of the
 paper with a decorative line; this is rarely used.
 
+Please write an abstract, however short.
+
 \subsection{Appendices}
 
 A paper may have appendices, which can be expressed in exactly the same
@@ -526,7 +535,7 @@ as \pkgname{verbatim}~\cite{Schoepf:verbatim:1996},
 
 If you use the \pkgname{listings} package, please specify:
 \begin{verbatim}[\small]
-\lstset{columns=flexible, keepspaces=true,
+\lstset{columns=fullflexible, keepspaces=true,
         commentstyle=\slshape,
         basicstyle=\ttfamily\small}
 \lstdefinestyle{inline}
@@ -535,8 +544,10 @@ If you use the \pkgname{listings} package, please specify:
 
 Explanations:
 \begin{itemize}
-\item \texttt{columns=flexible}:
-The other values for the \verb|columns| option don't work well in \TUB.
+\item \texttt{columns=fullflexible}:
+The other values for the \verb|columns| option don't work well in \TUB;
+we want the program text to be typeset normally, not forcibly aligned
+into large character cells.
 
 \item \texttt{keepspaces=true}:
 However, having flexible columns makes spaces in the input not
@@ -694,13 +705,13 @@ urls, etc.; it is being used throughout the present paper (not least in
 the bibliography), either on its own or via \texttt{hyperref}.
 
 Although not necessarily recommended in all cases, many additional
-packages are commonly used. To mention a few: \texttt{microtype} can
-help reduce overfull boxes (and improve appearance); sometimes it may be
-preferable to use the Latin Modern fonts via \texttt{lmodern};
-\texttt{iftex} provides tests for the \TeX\ engine being run;
-\texttt{texosquery} provides operating system information; and
-\texttt{hyperref} supports live and internal hyperlinks, outlines, and
+packages are commonly used. To mention a few:
+\begin{description}
+\item[microtype] can help reduce overfull boxes and improve appearance;
+\item[lmodern] use the Latin Modern fonts, sometimes preferable;
+\item[hyperref] supports live and internal hyperlinks, outlines, and
 many other features.
+\end{description}
 
 \section{Typesetting urls}
 \label{sec:urls}
@@ -774,16 +785,20 @@ though, you may enjoy the following small but useful features:
 \item and thus supports \textsf{url} and \textsf{doi} fields, among others.
 Please use \textsf{url} instead of putting urls in the
 \textsf{note} field, where possible. Also, please don't bother to
-include ``url access date'' information for \TUB; we find that extraneous.
+include ``access date'' information for \TUB; we find that extraneous.
 
 \item The \textsf{url} field is ignored if either the \textsf{howpublished} or
 \textsf{doi} field is present. In practice we observe that people put
 the same information in all those fields, and we don't want to typeset
 redundant information.
 
-\item Has even more abbreviations than \textsf{abbrv}, such as
+\item Does even more abbreviating than \textsf{abbrv}, such as
 printing only two author names (plus ``et~al.'')\ if there are more than
-four authors (thanks to Mico Loretan).
+four authors (thanks to Mico Loretan and Oren Patashnik).
+
+\item New field \textsf{bookauthor} for the \textsf{@incollection} and
+\textsf{@inproceedings} allows for citing a part, written by author~X,
+of a publication written by author~Y, and not just edited by~Y.
 
 \item Defines an \textsf{@online} entry type as an alias for \textsf{@misc}.
 
@@ -801,13 +816,16 @@ If you use \BibTeX, feel free to take advantage of the accumulated
 bibliography of \TUB{} itself (\url{info/tugboat.bib} on \CTAN), and the
 other compilations by Nelson Beebe in that same directory.
 
-Bibliographies provide further problems because they're notoriously
-difficult to typeset at the best of times.  \LaTeX{} sets \cs{sloppy}
-when typesetting the bibliography, but this often leads to unpleasant
-output in the narrow columns typical of \TUB{}.  The author can control
-the typesetting using the command \cs{SetBibJustification}.  The classes
-set \cs{sloppy}, by default (just like \LaTeX{}), but the author may
-(for example) say:
+By the way, we recommending using commas to terminate all fields in
+\texttt{.bib} files, including the last one in an entry. That makes it
+one less thing to worry about when changing fields around in the source.
+
+Bibliographies can be difficult to typeset at the best of times.
+\LaTeX{} sets \cs{sloppy} when typesetting the bibliography, but this
+typically leads to unpleasant output with \TUB's narrow columns. The
+author can specify typesetting parameters using the command
+\cs{SetBibJustification}. The classes remain \cs{sloppy} by default, but
+the author may (for example) say:
 \begin{verbatim}
   \SetBibJustification{\raggedright}
 \end{verbatim}
@@ -816,7 +834,7 @@ as the present article does, to often achieve somewhat better results.
 A last note for references: for \TUB\ issues, please use the format
 \textsl{volno\,:\,issno}, e.g., ``\TUB\ 32:1'' for volume~32, number~1.
 
-\section{Non-recommended bibliography facilities}
+\subsection{Non-recommended bibliography facilities}
 
 The preceding gives the bibliography recommendations for current \TUB\
 articles. If, for whatever reason, you do not wish to follow those
@@ -923,6 +941,7 @@ different (as discussed in section~\ref{sec:syntax}); arguments are
 (almost always) enclosed in braces instead of the various
 forms provided by the `plain' macros.
 
+\newpage
 \SetBibJustification{\raggedright}
 \bibliographystyle{tugboat}
 \bibliography{tubguide}
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf b/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
index a1f67a5e135..fcca6943fbc 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/manifest.txt b/Master/texmf-dist/doc/latex/tugboat/manifest.txt
index b4613f77c61..f132d39bec5 100644
--- a/Master/texmf-dist/doc/latex/tugboat/manifest.txt
+++ b/Master/texmf-dist/doc/latex/tugboat/manifest.txt
@@ -1,10 +1,9 @@
-$Id: manifest.txt 205 2018-09-06 17:28:53Z karl $
+$Id: manifest.txt 315 2020-11-15 02:07:34Z karl $
 List of files in the tugboat LaTeX package covered by the LPPL:
 
 ltubguid.ltx
 ltubguid.pdf
 ltugbib.bst
-tugboat.bst
 tugboat.dtx
 tugboat.pdf
 tugboat.ins
diff --git a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
index 30bd7e3eb92..0c9ae5b29a1 100644
--- a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
+++ b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf