summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/tugboat
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-11-11 03:00:42 +0000
committerNorbert Preining <norbert@preining.info>2019-11-11 03:00:42 +0000
commit0e71c26d9aa79c6e92c3095d6c71f28a566e6054 (patch)
treeb7657bd03108b5ca35e61578ab27b67bd098bf4e /macros/latex/contrib/tugboat
parent838842fa4625160270947ca654e7492e3c7afc44 (diff)
CTAN sync 201911110300
Diffstat (limited to 'macros/latex/contrib/tugboat')
-rw-r--r--macros/latex/contrib/tugboat/README4
-rw-r--r--macros/latex/contrib/tugboat/ltubguid.ltx109
-rw-r--r--macros/latex/contrib/tugboat/ltubguid.pdfbin324851 -> 325091 bytes
-rw-r--r--macros/latex/contrib/tugboat/tugboat.bst21
-rw-r--r--macros/latex/contrib/tugboat/tugboat.dtx61
-rw-r--r--macros/latex/contrib/tugboat/tugboat.ins7
-rw-r--r--macros/latex/contrib/tugboat/tugboat.pdfbin460956 -> 461276 bytes
7 files changed, 124 insertions, 78 deletions
diff --git a/macros/latex/contrib/tugboat/README b/macros/latex/contrib/tugboat/README
index 11e6e50e24..bed52cdfdb 100644
--- a/macros/latex/contrib/tugboat/README
+++ b/macros/latex/contrib/tugboat/README
@@ -1,5 +1,5 @@
-$Id: README 205 2018-09-06 17:28:53Z karl $
-Copyright 2006, 2009-2018 TeX Users Group.
+$Id: README 261 2019-11-09 22:00:31Z karl $
+Copyright 2006, 2009-2019 TeX Users Group.
You may freely use, modify and/or distribute this file.
LaTeX macros for use in TUGboat
diff --git a/macros/latex/contrib/tugboat/ltubguid.ltx b/macros/latex/contrib/tugboat/ltubguid.ltx
index dcb817f014..906789bf28 100644
--- a/macros/latex/contrib/tugboat/ltubguid.ltx
+++ b/macros/latex/contrib/tugboat/ltubguid.ltx
@@ -1,8 +1,7 @@
-% $Id: ltubguid.ltx 216 2018-12-13 21:40:11Z karl $
+% $Id: ltubguid.ltx 261 2019-11-09 22:00:31Z karl $
% ltubguid.ltx - documentation for ltugboat classes.
%
-% Copyright 1994,1995,1996,2001,2005,2006,2010,2013,2014,2017,2018
-% TeX Users Group.
+% Copyright 1994-2019 TeX Users Group.
%
% This file is part of the tugboat package.
%
@@ -313,7 +312,8 @@ the same treatment).
Authors may note that the style of ordinary issues of \TUB{} makes
no distinction between the titles of the divisions; the visual style
relies on the section numbers to indicate where the divisions lie in
-the hierarchy.
+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
@@ -525,19 +525,35 @@ as \pkgname{verbatim}~\cite{Schoepf:verbatim:1996},
\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,
+\lstset{columns=flexible, keepspaces=true,
+ commentstyle=\slshape,
basicstyle=\ttfamily\small}
\lstdefinestyle{inline}
- {basicstyle=\ttfamily\normalsize}
+ {basicstyle=\ttfamily\normalsize}
\end{verbatim}
+Explanations:
+\begin{itemize}
+\item \texttt{columns=flexible}:
+The other values for the \verb|columns| option don't work well in \TUB.
+
+\item \texttt{keepspaces=true}:
+However, having flexible columns makes spaces in the input not
+necessarily correspond to spaces in the output. That's usually desired,
+for alignment of the sources, hence \texttt{keepspaces}.
+
+\item \texttt{commentstyle=\cs{slshape}}:
+We prefer slanted to Computer Modern typewriter italic.
+Using regular upright typewriter for comments is fine too.
+
+\item \texttt{basicstyle=...}:
+We usually prefer \cs{small} for displayed verbatim; when using
+\texttt{listings}, it is necessary to reset inline verbatim to the
+normal text size.
+
+\end{itemize}
+
\section{Floating inserts}
The classes do not make any change to \LaTeX{}'s built-in provision
@@ -592,7 +608,6 @@ and of course the class sources are the ultimate reference.
\verb|\MacOSX| & \MacOSX \\
\verb|\MathML| & \MathML \\
\verb|\MF| & \MF \\
- \verb|\MP| & \MP \\
\verb|\OMEGA| & \OMEGA \\
\verb|\PDF| & \PDF \\
\verb|\SGML| & \SGML \\
@@ -641,14 +656,16 @@ the `everyday' ones.
\section{Use of packages}
-In general, authors can use non-standard packages in their papers.
-However, the paper does need to be processable on the \TUB{} production
-computers (running current \TeX\ Live). A sensible mechanism for
-submitting out-of-the-ordinary packages (as for paper-specific
-bibliographies) is by use of the \envname{filecontents} environment.
+Being a \TeX\ journal, authors may use both standard and non-standard
+external packages for their articles. The overriding criterion is that
+articles need to be processable on the \TUB{} production computers
+(running current \TeX\ Live). A sensible mechanism for submitting
+personal packages is by use of the \envname{filecontents} environment.
+It's also fine to submit manuscript source with additional packages in a
+zip or other archive.
In general, packages currently on \CTAN, and known to work with
-\emph{current} \LaTeX{} are unlikely to give problems. In particular,
+\emph{current} \LaTeX{} are likely to be fine. 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
@@ -658,33 +675,29 @@ mentioned (section~\ref{sec:verbatim}): that use of the standard
facilities provided by the \TUB\ classes.
\tug{} has a policy that macro packages described in \TUB{} should be
-available for readers to use. Since typing macros from printed
-sources is such an error-prone undertaking, authors of publicly
-available packages are urged to submit their macros to the \CTAN{}
-archives. If a package is only available under restricted terms,
-authors are urged to make this fact clear when first submitting an
-article to the editor.
-
-At present, the list of canonically recommended packages consists of
-only two, \path|mflogo.sty| \cite{Vieth:mflogo:1995} and \path|url.sty|
-\cite{Arseneau:url:1996}.
-
-Both classes will load the \pkgname{mflogo} package if it is present on the
-author's system; if the package is not present, the classes will
-emulate its more important features; the package defines \MF{} and
-\MP{} logos using recent versions of Knuth's \verb|logo10| font family.
-
-The \pkgname{url} package is useful when one is typesetting significant
-numbers of file names, network addresses or \acro{URL}s; it is being
-used in the present paper (not least in the bibliography). Speaking of
-urls, nowadays we generally omit a leading \texttt{http://} or
-\texttt{https://}.
+available for readers to use. Since typing macros from printed sources
+is a tedious undertaking, authors of publicly available packages are
+urged to submit their macros to \CTAN{}. If a package is only available
+under restricted terms, authors are requested to make this fact clear
+when first submitting an article to the editor.
+
+The \texttt{ltugboat} class loads the package \path|mflogo.sty|
+\cite{Vieth:mflogo:1995} for typesetting the \MF\ logo. (If this package
+is not present by some mischance, \texttt{ltugboat} will emulate its
+important feature.)
+
+An additional canonically-recommended package is \path|url.sty|
+\cite{Arseneau:url:1996}, for typesetting filenames, email addresses,
+urls, etc.; it is being used throughout the present paper (not least in
+the bibliography). Speaking of urls, nowadays we generally omit a
+leading \texttt{http://} or \texttt{https://}.
Although not necessarily recommended in all cases, many additional
packages are commonly used. To mention a few: \texttt{microtype} can
help reduce overfull boxes; sometimes it may be preferable to use the
-Latin Modern fonts via \texttt{lmodern}; and \texttt{hyperref} allows
-for many internal links and other features.
+Latin Modern fonts via \texttt{lmodern}; \texttt{iftex} provides tests
+for the \TeX\ engine being run; and \texttt{hyperref} supports live and
+internal hyperlinks, outlines, and many other features.
\section{Bibliography}
\label{sec:biblio}
@@ -712,7 +725,7 @@ though, you may enjoy the following small but useful features:
\item The \textsf{url} field is ignored if either the \textsf{doi} or
\textsf{howpublished} field is present, since in practice we observe
that people put the same information in all those fields, and we don't
-want to use up space typesetting redundant information.
+typeset redundant information.
\item Has even more abbreviations than \textsf{abbrv}, including
printing only two author names (plus ``et~al\@.'') if there are more
@@ -723,8 +736,9 @@ than four authors (thanks to Mico Loretan).
\item For completeness only: \verb|tugboat.bst| provides ``secret''
fields \textsf{newpage} to force a page break after the current item,
and \textsf{urlnewline} to force a line break before the \textsf{url}
-value. We've found that these presentation tweaks are often necessary
-for the final typeset output. Authors need not worry about them.
+value. As editors, we've found that these presentation tweaks are often
+necessary for the final typeset output. Authors need not worry about
+them.
\end{itemize}
@@ -744,9 +758,8 @@ set \cs{sloppy}, by default (just like \LaTeX{}), but the author may
\end{verbatim}
as the present article does, to achieve somewhat better results.
-A last note for bibliographies: for references to other issues of \TUB,
-please use the format \textsl{volno:issno}, e.g., ``\TUB\ 32:1'' for
-volume~32, number~1.
+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}
diff --git a/macros/latex/contrib/tugboat/ltubguid.pdf b/macros/latex/contrib/tugboat/ltubguid.pdf
index 48f978eb90..96524d71f7 100644
--- a/macros/latex/contrib/tugboat/ltubguid.pdf
+++ b/macros/latex/contrib/tugboat/ltubguid.pdf
Binary files differ
diff --git a/macros/latex/contrib/tugboat/tugboat.bst b/macros/latex/contrib/tugboat/tugboat.bst
index ad73920cb9..3be31fa97e 100644
--- a/macros/latex/contrib/tugboat/tugboat.bst
+++ b/macros/latex/contrib/tugboat/tugboat.bst
@@ -1,14 +1,15 @@
-%%% $Id: tugboat.bst 210 2018-10-29 18:04:16Z karl $
+%%% $Id: tugboat.bst 261 2019-11-09 22:00:31Z karl $
%%% TUGboat changes are public domain.
%%%
%%% Modified for TUGboat from abbrvurl.bst:
-%%% abbreviate "page(s)" to "p(p).",
+%%% Abbreviate "page(s)" to "p(p).",
%%% "volume" to "vol.",
%%% "editor(s)" to "ed(s)".
-%%% urlintro=""
-%%% reduce long author lists in format.names per Mico.
-%%% new fields for editors:
-%%% "newpage" - force page break after entry
+%%% Set urlintro="".
+%%% Output "Ph.D." rather than "PhD".
+%%% Reduce long author lists in format.names per Mico Loretan.
+%%% New fields for editors:
+%%% "newpage" - force page break after entry;
%%% "urlnewline" - force line break before url value.
%%% --karl, originally created 24jul18.
%%%
@@ -22,7 +23,7 @@
%%% Added hyperref support.
%%% Original headers follow...
-% BibTeX standard bibliography style `abbrv'
+% [was] BibTeX standard bibliography style `abbrv'
% version 0.99a for BibTeX versions 0.99a or later, LaTeX version 2.09.
% Copyright (C) 1985, all rights reserved.
% Copying of this file is authorized only if either
@@ -580,8 +581,8 @@ FUNCTION {format.pages}
{ pages empty$
{ "" }
{ pages multi.page.check
- { "pp." pages n.dashify tie.or.space.connect }
- { "p." pages tie.or.space.connect }
+ { "pp.~" pages n.dashify * }
+ { "p.~" pages * }
if$
}
if$
@@ -1183,7 +1184,7 @@ FUNCTION {phdthesis}
title empty$ 'skip$ 'possibly.setup.inlinelink if$ % urlbst
format.btitle "title" output.check
new.block
- "PhD thesis" format.thesis.type output.nonnull
+ "Ph.D. thesis" format.thesis.type output.nonnull
school "school" output.check
address output
format.date "year" output.check
diff --git a/macros/latex/contrib/tugboat/tugboat.dtx b/macros/latex/contrib/tugboat/tugboat.dtx
index 176107a4d9..973d05a646 100644
--- a/macros/latex/contrib/tugboat/tugboat.dtx
+++ b/macros/latex/contrib/tugboat/tugboat.dtx
@@ -1,8 +1,8 @@
% \iffalse (this is a meta-comment (so they say))
-% $Id: tugboat.dtx 217 2018-12-14 18:48:06Z karl $
+% $Id: tugboat.dtx 261 2019-11-09 22:00:31Z karl $
% tugboat.dtx - main source for LaTeX TUGboat classes.
%
-% Copyright 1994-2018 TeX Users Group.
+% Copyright 1994-2019 TeX Users Group.
%
% This file is part of the tugboat package.
%
@@ -28,7 +28,7 @@
%<ltugboatsty>\ProvidesPackage{ltugboat}
%<ltugprocsty>\ProvidesPackage{ltugproc}
%<ltugcomn> \ProvidesPackage{ltugcomn}
- [2018-12-14 v2.21
+ [2019-11-09 v2.22
%<ltugboatcls> TUGboat journal class%
%<ltugproccls> TUG conference proceedings class%
%<ltugboatsty|ltugprocsty> TUG compatibility package%
@@ -65,8 +65,8 @@
%
\usepackage{array,longtable}
%
-% if longtable.sty is the most recent, then it doesn't need
-% \cs{setlongtables}, so we avoid the setlong.tab game
+% If longtable.sty is not ancient, then it doesn't need
+% \cs{setlongtables}, so we avoid the setlong.tab game.
\GetFileInfo{longtable.sty}
\def\extractdate#1/#2/#3\relax{\def\fileyear{#1}%
\def\filemonth{#2}%
@@ -671,6 +671,9 @@
}
\def\BibLaTeX{\Bib\kern.02em \LaTeX}
\def\BibTeX{\Bib\kern-.08em \TeX}
+% no good way to determine bold font, and we want to lose the kern, too:
+% (we \let BibTeX to this in maketitle)
+\def\bfBibTeX{B{\SMC\SMC IB}\TeX}
%
\def\BSD{\acro{BSD}}
\def\CandT{\textsl{Computers \& Typesetting}}
@@ -697,7 +700,8 @@
\def\DVItoVDU{DVIto\kern-.12em VDU}
\def\ECMA{\acro{ECMA}}
\def\EPS{\acro{EPS}}
-\DeclareRobustCommand{\eTeX}{\ensuremath{\varepsilon}-\kern-.125em\TeX}
+% no line break at this hyphen please
+\DeclareRobustCommand{\eTeX}{\ensuremath{\varepsilon}\mbox{-}\kern-.125em\TeX}
\DeclareRobustCommand{\ExTeX}{%
\ensuremath{\textstyle\varepsilon_{\kern-0.15em\cal{X}}}\kern-.2em\TeX}
\def\FAQ{\acro{FAQ}}
@@ -708,6 +712,7 @@
\def\Hawaii{Hawai`i}
\def\HTML{\acro{HTML}}
\def\HTTP{\acro{HTTP}}
+\def\iOS{i\acro{OS}}
\def\IDE{\acro{IDE}}
\def\IEEE{\acro{IEEE}}
\def\ISBN{\acro{ISBN}}
@@ -748,17 +753,22 @@
%
% \begin{macrocode}
%<!latex>\def\LaTeX{\La\kern-.15em\TeX}
+\def\LuaHBTeX{Lua\acro{HB}\-\TeX}%
+\def\LuaHBLaTeX{Lua\acro{HB}\-\LaTeX}%
+\def\LuaLaTeX{Lua\-\LaTeX}% dtk-logos defines it and people like to use it
+\def\LuaTeX{Lua\-\TeX}% ditto
\def\LyX{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX}
+\def\macOS{mac\acro{OS}}
\def\MacOSX{Mac\,\acro{OS\,X}}
\def\MathML{Math\acro{ML}}
\def\Mc{\setbox\TestBox=\hbox{M}M\vbox
to\ht\TestBox{\hbox{c}\vfil}} % for Robert McGaffey
% \end{macrocode}
%
-% If we're running under \LaTeXe, we're using (at least pro tem) Ulrik
-% Vieth's |mflogo.sty| if it's present. Otherwise, we're using a
-% short extract of Vieth's stuff. Either way, we don't need to
-% specify \cs{MF} or \cs{MP}
+% If we're running under \LaTeXe, we use Ulrik Vieth's |mflogo.sty| if
+% it's present. Otherwise, we're using a short extract of Vieth's
+% stuff. Either way, we don't need to specify \cs{MF} or \cs{MP}.
+%
% \begin{macrocode}
\def\mf{\textsc{Metafont}}
\def\MFB{\textsl{The \MF\kern1pt book}}
@@ -791,6 +801,8 @@
\def\pcMF{\leavevmode\raise.5ex\hbox{p\kern-.3\p@ c}MF\@}
\def\PCTeX{PC\thinspace\TeX}
\def\pcTeX{\leavevmode\raise.5ex\hbox{p\kern-.3\p@ c}\TeX}
+\def\pdflatex{pdf\-\LaTeX}% dtk-logos
+\def\pdftex{pdf\-\TeX}% dtk-logos
\def\PDF{\acro{PDF}}
\def\PGF{\acro{PGF}}
\def\PHP{\acro{PHP}}
@@ -824,7 +836,7 @@
\def\TeXworks{\TeX\kern-.07em works}
\def\TeXXeT{\TeX-{}-\XeT}
\def\TFM{\acro{TFM}}
-\expandafter\ifx\csname XeTeXrevision\endcsname\relax
+\ifx\Umathchardef\@thisisundefined % xetex|luatex
\def\Thanh{H\`an~Th\^e\llap{\raise 0.5ex\hbox{\'{}}}~Th\`anh}% non-XeTeX
\else
\def\Thanh{H\`an~Th\textcircumacute{e}~Th\`anh}% else xunicode drops the acute
@@ -874,6 +886,12 @@
\DeclareRobustCommand{\Xe}{\leavevmode
\tubhideheight{\hbox{X%
\setbox0=\hbox{\TeX}\setbox1=\hbox{E}%
+ \ifdim \fontdimen1\font>0pt
+ % XeTeX logo needs tinkering when slanted/italic font.
+ \def\XekernbeforeE{-.11em}%
+ \def\XekernafterE{-.11em}%
+ \dp1=-.17ex
+ \fi
\lower\dp0\hbox{\raise\dp1\hbox{\kern\XekernbeforeE\tubreflect{E}}}%
\kern\XekernafterE}}}
\def\XeTeX{\Xe\TeX}
@@ -1154,6 +1172,15 @@
% but fine, just keeping it.
\DeclareRobustCommand{\thinskip}{\hskip 0.16667em\relax}
%
+% Make \! work in text mode.
+\DeclareRobustCommand{\!}{\ifmmode\mskip-\thinmuskip \else\kern-0.16667em \fi}
+%
+% Half a thinspace.
+\DeclareRobustCommand{\tubthinnerspace}
+ {\ifmmode\mskip.5\thinmuskip \else\kern0.08333em \fi}
+\DeclareRobustCommand{\tubthinnerspaceneg}
+ {\ifmmode\mskip-.5\thinmuskip \else\kern-0.08333em \fi}
+%
% \end{macrocode}
%
% We play a merry game with dashes, providing all conceivable options
@@ -2277,7 +2304,10 @@
\let\and=\quad
\ignorespaces\@author}%
{%
- \noindent\bf\raggedright\ignorespaces\frenchspacing\@title\endgraf
+ \noindent\bf\raggedright\ignorespaces\frenchspacing
+ \let\BibTeX=\bfBibTeX % else LaTeX Font Warning:
+ % Font shape `OT1/cmr/bx/sc' undefined
+ \@title\endgraf
}%
\ifdim \wd0 < 5\p@ % omit if author is null
\else
@@ -2484,7 +2514,7 @@
%
% \begin{macrocode}
\def\TBtocsectionfont{\normalfont}
-\newskip\TBtocsectionspace \TBtocsectionspace=1.0em\@plus\p@
+\newskip\TBtocsectionspace \TBtocsectionspace=1.0ex\@plus\p@
% \end{macrocode}
%
% \begin{macrocode}
@@ -3212,9 +3242,11 @@
}
% put issue identification and page number in header.
\def\@oddhead{\MakeRegistrationMarks
+ \frenchspacing
\normalsize\csname normalshape\endcsname\rm \tubheadhook
\rtitlex\qquad \midrtitle\hfil \rtitlenexttopage\quad \thepage}
\def\@evenhead{\MakeRegistrationMarks
+ \frenchspacing
\normalsize\csname normalshape\endcsname\rm \tubheadhook
\thepage \quad\rtitlenexttopage \hfil\midrtitle \qquad\rtitlex}
@@ -3222,6 +3254,7 @@
\def\tubheadhook{}
% in case the official \author is too verbose for the footline.
+% (the \shortauthor / \rhAuthor stuff is only enabled for proceedings, fix!)
\def\tubrunningauthor{\@author}
% put title and author in footer.
@@ -3231,7 +3264,7 @@
\let\newline=\\%
\frenchspacing
\hfil\rhTitle}
- \def\@evenfoot{\tubrunningauthor\hfil}
+ \def\@evenfoot{\frenchspacing \let\thanks\@gobble \tubrunningauthor\hfil}
}
% empty footer.
diff --git a/macros/latex/contrib/tugboat/tugboat.ins b/macros/latex/contrib/tugboat/tugboat.ins
index 72b4f4f184..4aabebdd9b 100644
--- a/macros/latex/contrib/tugboat/tugboat.ins
+++ b/macros/latex/contrib/tugboat/tugboat.ins
@@ -1,10 +1,10 @@
-% $Id: tugboat.ins 210 2018-10-29 18:04:16Z karl $
+% $Id: tugboat.ins 261 2019-11-09 22:00:31Z karl $
% tugboat.ins
%% This file will generate fast loadable files and documentation
%% driver files from the doc files in this package when run through
%% LaTeX or TeX.
%%
-%% Copyright 1994-2018 TeX Users Group.
+%% Copyright 1994-2019 TeX Users Group.
%%
%% This file is part of the tugboat package.
%%
@@ -38,7 +38,7 @@
This is a generated file.
-Copyright 1994-2018 TeX Users Group.
+Copyright 1994-2019 TeX Users Group.
It may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3
@@ -79,7 +79,6 @@ extension .ins) which are part of the distribution.
\Msg{* files into a directory searched by TeX:}
\Msg{* \space\space All *.sty and all *.cls}
\Msg{*}
-\Msg{* And move ltugbib.bst to a directory searched by BibTeX.}
\Msg{***********************************************************}
\endinput
diff --git a/macros/latex/contrib/tugboat/tugboat.pdf b/macros/latex/contrib/tugboat/tugboat.pdf
index f5e9d3068d..afdef4195d 100644
--- a/macros/latex/contrib/tugboat/tugboat.pdf
+++ b/macros/latex/contrib/tugboat/tugboat.pdf
Binary files differ