summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/tugboat/ltubguid.ltx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/tugboat/ltubguid.ltx')
-rw-r--r--macros/latex/contrib/tugboat/ltubguid.ltx27
1 files changed, 13 insertions, 14 deletions
diff --git a/macros/latex/contrib/tugboat/ltubguid.ltx b/macros/latex/contrib/tugboat/ltubguid.ltx
index da93ceac25..1c017124e8 100644
--- a/macros/latex/contrib/tugboat/ltubguid.ltx
+++ b/macros/latex/contrib/tugboat/ltubguid.ltx
@@ -1,7 +1,7 @@
-% $Id: ltubguid.ltx 386 2021-09-28 22:25:51Z karl $
+% $Id: ltubguid.ltx 424 2022-05-19 22:45:08Z karl $
% ltubguid.ltx - documentation for ltugboat classes.
%
-% Copyright 1994-2021 TeX Users Group.
+% Copyright 1994-2022 TeX Users Group.
%
% This file is part of the tugboat package.
%
@@ -614,7 +614,7 @@ and of course the class sources are the ultimate reference.
\verb|\ConTeXt| & \ConTeXt \\
\verb|\Cplusplus| & \Cplusplus \\
\verb|\CTAN| & \CTAN \\
- \verb|\eTeX| & \eTeX \\
+ \verb|\eTeX| & \eTeX\\
\verb|\FAQ| & \FAQ \\
\verb|\HTML| & \HTML \\
\verb|\ISBN| & \ISBN \\
@@ -648,9 +648,8 @@ paper.
\subsection{Assorted other markup}
-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.
+A small list of special typesetting commands follows; a larger set of
+such commands is defined in the classes.
\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
@@ -668,7 +667,6 @@ the `everyday' ones.
%\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}
-
For commands to typeset urls, see section~\ref{sec:urls}.
\section{Use of packages}
@@ -684,12 +682,9 @@ zip or other archive.
In general, packages currently on \CTAN, and known to work with
\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 \LaTeX\ team,\footnote{%
+members of the \LaTeX\ team.\footnote{%
Those in the \LaTeX{} base distribution, or one of those in the
- \CTANref{packages} sub-tree on \CTAN.} subject to the warning already
-mentioned (section~\ref{sec:verbatim}): that use of the standard
-\pkgname{verbatim} package eliminates the special \envname{verbatim}
-facilities provided by the \TUB\ classes.
+ \CTANref{packages} sub-tree on \CTAN.}
\tug{} has a policy that macro packages described in \TUB{} should be
available for readers to use. Since typing macros from printed sources
@@ -712,7 +707,6 @@ Although not necessarily recommended in all cases, many additional
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}
@@ -754,6 +748,12 @@ protocol not be included; if live links are not being produced in the
output, the printed url without the protocol suffices. (When a user
copies/pastes url text into a browser, it will normally work.)
+Two shortcut macros: \cs{tbsfootnoteurl} and \cs{tbhfootnoteurl} make a
+ragged-right footnote with the respective \cs{tbXurl} command. We
+recognize that sometimes the best option is to put urls in footnotes.
+However, when it's sensible, writing them as either parentheticals in
+the main text or in bibliography entries is preferred, to ease page breaking.
+
For \texttt{ftp}, \texttt{rsync}, and other protocols, it is best to
always include them explicitly and use \cs{url}:\\
\verb|\url{ftp://tug.org}|,\\ \verb|\url{rsync://tug.org}|, etc.
@@ -960,7 +960,6 @@ 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}