tugboat-plain 1.31 2024-10-26

git-svn-id: svn://tug.org/tugboat/trunk@607 7237770a-693a-0410-b4d3-c34f48dbc3f6
TeXUsersGroup · Oct 26, 2024 · be0557c · be0557c
1 parent dd82f67
commit be0557c
Show file tree

Hide file tree

Showing 5 changed files with 60 additions and 28 deletions.
diff --git a/plain/ChangeLog b/plain/ChangeLog
@@ -1,3 +1,12 @@
+2024-10-26  Karl Berry  <karl@freefriends.org>
+
+	* tugboat.sty,
+	* tugboat.cmn: release to CTAN.
+	v1.29 2024-10-26 (for both).
+
+	* tubguide.tex (Hyperlinks and urls): new section to document
+	the new commands. Replace \vellipsis with "..." to save space.
+
 2024-10-11  Karl Berry  <karl@freefriends.org>
 
 	* tugboat.cmn (\macOS, \SQL): new abbrevs, following ltugboat.sty.

diff --git a/plain/Makefile b/plain/Makefile
@@ -4,10 +4,10 @@
 all: tubguide.pdf
 
 tubguide.pdf: tubguide.tex tugboat.sty tugboat.cmn
-	pdftex --file-line-error '\nonstopmode\input $<'
+	texfot pdftex --file-line-error '\nonstopmode\input $<'
 
 tub_rel = /usr/local/texlive/dev/texmf-dist/tex/plain/tugboat-plain
-diff:
+diff dif:
 	-diff -u0 $(tub_rel)/tugboat.cmn tugboat.cmn
 	-diff -u0 $(tub_rel)/tugboat.sty tugboat.sty
 	-diff -u0 $(tub_rel)/tugproc.sty tugproc.sty

diff --git a/plain/tubguide.tex b/plain/tubguide.tex
@@ -1,9 +1,10 @@
+%% $Id$
 %% @texfile{
 %%     filename   = "tubguide.tex",
-%%     version    = "1.22",
-%%     date       = "2016/09/26",
+%%     version    = "1.31",
+%%     date       = "2024-10-26",
 %%     filetype   = "TUGboat Authors' Guide",
-%%     copyright  = "Copyright 1989, 1992, 2006, 2012-2016 TeX Users Group.
+%%     copyright  = "Copyright 1989, 1992, 2006, 2012-2024 TeX Users Group.
 %%                   Unlimited copying and redistribution of this file
 %%                   are permitted as long as this file is not
 %%                   modified.  Modifications (and redistribution of
@@ -17,13 +18,6 @@
 %%                   that produced the original Authors' Guide in
 %%                   TUGboat 10, no. 3, November 1989.",
 %%     }
-%% $Id$
-%% *********************************************************
-%%
-%%  TeXing this file requires the following files:
-%%      TUGBOAT.STY (version 1.09+)
-%%      TUGBOAT.CMN (version 1.08+) (loaded by TUGBOAT.STY)
-%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \input tugboat.sty
@@ -185,9 +179,9 @@
 \netaddress * <network address> *
 |halfline
 \article
-|vellipsis
+...
 <body of article>
-|vellipsis
+...
 \makesignature
 \endarticle
 \endverbatim
@@ -363,7 +357,7 @@
 for longer items the
 ||[\makeescape\!]
 \verbatim
-!vellipsis
+...
 \endverbatim
 ||
 form (although \verbinline||...||\endverbatim is a good way to
@@ -381,7 +375,7 @@
 consonance between macros in use and their published listings.
 ||[\makeescape\!]
 \verbatim[\inputfromfile{foo.inp}]
-!vellipsis
+...
 \endverbatim
 ||
 will incorporate the contents of file |foo.inp| in the listing before
@@ -408,7 +402,7 @@
 To write out information, use
 ||[\makeescape\!]
 \verbatim[\outputtofile{foo.out}]
-!vellipsis
+...
 \endverbatim
 ||
 An added bonus here is that characters which get internalized as
@@ -421,7 +415,7 @@
 example, for an article with
 \verbatim[\outputtofile{ray.vbm}]
 \author * Ray Goucher *
-/vellipsis
+...
 \endverbatim
 we could say
 \verbatim[\outputtofile{sig.vbm}]
@@ -473,9 +467,9 @@
 escape character in that block.  Thus,
 ||[\makeescape\/]
 \verbatim[\makeescape\!]
-/vellipsis
+...
 ...!it...
-/vellipsis
+...
 \endverbatim
 ||
 really calls the italic font in the middle of the listing (one might
@@ -498,9 +492,9 @@
 as usual.  Using the |!| as the active character, one might key
 ||[\makeescape\/]
 \verbatim[\makeescape\!]
-/vellipsis
+...
 !vskip .5!baselineskip
-/vellipsis
+...
 \endverbatim
 ||
 to get an extra half line of space in the middle of the listing.  The
@@ -541,13 +535,35 @@
 intervening blank line (or |\par|) is or is not present.
 
 
+\subhead * Hyperlinks and urls *
+
+As of version~1.31 of the \plain-based \TUB\ macros, released in October
+2024, simple commands to create hyperlinks are available.
+
+\list\raggedright
+\item |\tbsurl{tug.org}| produces an https url, with the argument
+      typeset in \cs{tt}: \tbsurl{tug.org}.
+\item |\tbhurl{tug.org}| is analogous, for http urls: \tbhurl{tug.org}.
+\item |\tbmailto{tugboat@tug.org}| produces a mailto url, again with the
+      argument in \cs{tt}: \tbmailto{tugboat@tug.org}.
+\item |\tbhref{https://tug.org}{the \acro{TUG} home page| is the general
+      command, which typesets the second argument (no implicit font
+      changes) as a link to the first argument (no implicit protocol
+      added): \tbhref{https://tug.org/}{the \acro{TUG} home page}.
+\endlist
+
+At present, these commands only work in pdf\TeX. Other engines will be
+supported as needed.
+
+The links are displayed without a border, since we find link borders
+distracting rather than helpful. There are no display options, to keep
+things simple.
+
 \subhead * Figures and page layout *
 Figures are keyed as
 \verbatim[\makeescape\|]
 \figure
-|halfline
 <vertical mode material>
-|halfline
 \endfigure
 \endverbatim
 These are generally implemented as single-column floating

diff --git a/plain/tugboat.cmn b/plain/tugboat.cmn
@@ -29,8 +29,8 @@
 \fi
 \next
 
-\def\fileversion{v1.30}
-\def\filedate{2024-10-11}
+\def\fileversion{v1.31}
+\def\filedate{2024-10-26}
 
 \message{File `TUGBOAT.CMN' \fileversion \space\space <\filedate>}
 
@@ -1048,6 +1048,12 @@ that may not be obvious.  For full definitions, see real code above.
 
 Version   Date        Changes
 -------   ---------   ---------------------------------------------------
+1.31      26 Oct 24   \tbsurl, \tbhurl, \tbmailto, \tbhref: simple
+                        hyperlinks with pdftex.
+                      new abbrevs \macOS, \SQL.
+                      \volnumber, \issnumber: just the numbers.
+                      \tbissident: VV-n to help with urls, etc.
+
 1.30      15 Apr 24   remove duplicate \TP definition.
 
 1.29      28 Oct 23   in \AllTeX, kern around ).

diff --git a/plain/tugboat.sty b/plain/tugboat.sty
@@ -21,8 +21,8 @@
 %% $Id$
 
 \def\thistubstyle{plain}
-\def\fileversion{v1.30}
-\def\filedate{2024-10-11}
+\def\fileversion{v1.31}
+\def\filedate{2024-10-26}
 
 % general items
 
@@ -2240,6 +2240,7 @@
 
 Version   Date        Changes
 -------   ---------   ---------------------------------------------------
+1.31      26 Oct 24   \thedoi: use \tbissident.
                       \endarticle: avoid empty last page, also for
                       tb139wermuth-isdim.