summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tugboat
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-11-15 22:21:52 +0000
committerKarl Berry <karl@freefriends.org>2020-11-15 22:21:52 +0000
commit9ab6cd6e1acc331b86f1a497026cb07261634c08 (patch)
treedf3242d0b78852b1353f7c0b6cca1da033f70dd0 /Master/texmf-dist/doc/latex/tugboat
parent20ced458fcbc8d680977df7fa7b2291c93698eb7 (diff)
tugboat (15nov20)
git-svn-id: svn://tug.org/texlive/trunk@56942 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tugboat')
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/NEWS14
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx101
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/ltubguid.pdfbin330289 -> 337563 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/manifest.txt3
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/tugboat.pdfbin462486 -> 464400 bytes
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
Binary files 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
--- a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
+++ b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
Binary files differ