From 9ab6cd6e1acc331b86f1a497026cb07261634c08 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 15 Nov 2020 22:21:52 +0000 Subject: tugboat (15nov20) git-svn-id: svn://tug.org/texlive/trunk@56942 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/tugboat/NEWS | 14 ++++ Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx | 101 ++++++++++++++--------- Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf | Bin 330289 -> 337563 bytes Master/texmf-dist/doc/latex/tugboat/manifest.txt | 3 +- Master/texmf-dist/doc/latex/tugboat/tugboat.pdf | Bin 462486 -> 464400 bytes 5 files changed, 75 insertions(+), 43 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/tugboat/NEWS (limited to 'Master/texmf-dist/doc/latex/tugboat') 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 Binary files a/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf and b/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf differ 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 Binary files a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf and b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf differ -- cgit v1.2.3