tugboat (4jul23)

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

4 files changed, 35 insertions, 29 deletions

diff --git a/Master/texmf-dist/doc/latex/tugboat/NEWS b/Master/texmf-dist/doc/latex/tugboat/NEWS
index aa1e53391ea..53621cccdc1 100644
--- a/Master/texmf-dist/doc/latex/tugboat/NEWS
+++ b/Master/texmf-dist/doc/latex/tugboat/NEWS
@@ -1,6 +1,19 @@
-$Id: NEWS 463 2023-03-08 21:59:19Z karl $
+$Id: NEWS 490 2023-07-03 22:27:49Z karl $
 This file records noteworthy changes.  This file is public domain.
 
+ltugboat.cls:
+- print page numbers with preceding ? in draft mode, including in references,
+  by redefining \thepage.
+- new abbrev \XMP.
+
+tugboat.bst:
+- for webpage entry type, do not output random material in brackets.
+- new field "monthtie" to editorially force a tie after the month.
+
+ltubguid documentation:
+- mention preferred placement of captions, namely below figures
+but above tables and listings.
+
 -----------------
 2.29 (2023-03-08):
 
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx b/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
index 7d15fd9c6c7..088a8e19afd 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 458 2023-01-16 18:44:30Z karl $
+% $Id: ltubguid.ltx 487 2023-06-22 22:39:59Z karl $
 % ltubguid.ltx - documentation for ltugboat classes.
 % 
 % Copyright 1994-2023 TeX Users Group.
@@ -571,25 +571,18 @@ normal text size.
 
 \section{Floating inserts}
 
-The classes do not make any change to \LaTeX{}'s built-in provision
-for floating inserts, so that authors may generate figures and tables
-just as they would in any `normal' \LaTeX{} document.  Figure and
-table captions, and labels referring to them, are also substantially
-untouched.
-
-However, since both classes typeset in two columns, authors must
-distinguish between the \envname{figure} and \envname{table} environments
-(which produce floats that are the same width as the column) and the
-\envname{figure*} and \envname{table*} (which produce floats that are the same
-width as the page).
-
-%\begin{itemize}
-%\item figures and tables as normal
-%\item captions and labels work whatever (i.e., no restriction on
-%  numbering)
-%\item twocolumn setting implies distinction between \envname{figure} and
-%  \envname{figure*} 
-%\end{itemize}
+The classes do not make any change to \LaTeX{}'s built-in provision for
+floating inserts, so that authors may write figures and tables as usual,
+
+The default is for floats to be the width of the column. To make a float
+which is the width of the whole page, use \envname{figure*} and
+\envname{table*}.
+
+Regarding caption placement, \TUB's convention is to put captions for
+figures beneath the figure, but captions for tables and listings above
+the table\slash listing. Please follow this convention unless there is a
+specific reason not to. As a reminder, \cs{label} commands should always
+follow the \cs{caption}.
 
 \section{Special-purpose typesetting}
 
@@ -830,16 +823,16 @@ aliases for \textsf{@misc}.
 \CTAN, following the fields output by the \pkgname{ctanbib} script (in
 the package of the same name, \url{ctan.org/pkg/ctanbib}).
 
-\item For completeness only: \verb|tugboat.bst| provides editor-intended
-fields \textsf{journaltie} to output a tie instead of space after the \textsf{journal} value,
+\item For completeness only: \verb|tugboat.bst| provides several 
+fields intended to be used by the editors: \textsf{journaltie} to output
+a tie instead of space after the \textsf{journal} value,
+\textsf{monthtie} for the same after \textsf{month},
 \textsf{newpage} to force a page break after the current item,
-\textsf{nowarning} to omit empty field warnings,
-\textsf{prebibitem} to output material before \cs{bibitem} (e.g., a
-section heading), and
+\textsf{nowarning} to omit empty field warnings, \textsf{prebibitem} to
+output material before \cs{bibitem} (e.g., a section heading), and
 \textsf{urlnewline} to force a line break before the \textsf{url} value.
-As editors, we've found that these presentation
-tweaks can be desirable for the final typeset output. Authors need not
-worry about them.
+As editors, we've found that these presentation tweaks can be desirable
+for the final typeset output. Authors need not worry about them.
 
 \end{itemize}
 
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf b/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
index 3d39af7dade..5d4df0b38fd 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/tugboat.pdf b/Master/texmf-dist/doc/latex/tugboat/tugboat-code.pdf
index fc6500607f0..2c5c124fa8f 100644
--- a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
+++ b/Master/texmf-dist/doc/latex/tugboat/tugboat-code.pdf