summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-05-28 18:33:58 +0000
committerKarl Berry <karl@freefriends.org>2006-05-28 18:33:58 +0000
commit38f1b1f824533095ff806ce10fd7009b518331c0 (patch)
tree99f79e29ab38e3d79814858d05e0fa273ee9aa5b /Master/texmf-dist/doc/plain
parent30d003c8ee52b4a4f4fc0e19b90f113bc6a71b3c (diff)
tugboat update
git-svn-id: svn://tug.org/texlive/trunk@1603 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/plain')
-rw-r--r--Master/texmf-dist/doc/plain/tugboat/README4
-rw-r--r--Master/texmf-dist/doc/plain/tugboat/tubguide.pdfbin140238 -> 117297 bytes
-rw-r--r--Master/texmf-dist/doc/plain/tugboat/tubguide.tex107
3 files changed, 70 insertions, 41 deletions
diff --git a/Master/texmf-dist/doc/plain/tugboat/README b/Master/texmf-dist/doc/plain/tugboat/README
new file mode 100644
index 00000000000..996049fd4fe
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/tugboat/README
@@ -0,0 +1,4 @@
+(This file in the public domain.)
+
+The plain style files for TUGboat, the journal of the TeX Users Group.
+See http://tug.org/TUGboat for back issues, author information, and more.
diff --git a/Master/texmf-dist/doc/plain/tugboat/tubguide.pdf b/Master/texmf-dist/doc/plain/tugboat/tubguide.pdf
index 19e97d6f1f0..5e00b9eea76 100644
--- a/Master/texmf-dist/doc/plain/tugboat/tubguide.pdf
+++ b/Master/texmf-dist/doc/plain/tugboat/tubguide.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/plain/tugboat/tubguide.tex b/Master/texmf-dist/doc/plain/tugboat/tubguide.tex
index ef930b2ebaa..56a18c8602b 100644
--- a/Master/texmf-dist/doc/plain/tugboat/tubguide.tex
+++ b/Master/texmf-dist/doc/plain/tugboat/tubguide.tex
@@ -1,27 +1,36 @@
%% @texfile{
-%% filename="tubguide.sty",
-%% version="1.02",
-%% date="9-Mar-1992",
-%% filetype="TUGboat Authors' Guide",
-%% copyright="Copyright (C) TeX Users Group.
-%% Copying of this file is authorized only if either:
-%% (1) you make absolutely no changes to your copy, OR
-%% (2) if you do make changes, you first rename it to some
-%% other name.",
-%% author="TeX Users Group",
-%% address="TeX Users Group",
-%% P. O. Box 9506,
-%% Providence, RI 02940,
-%% USA",
-%% telephone="401-751-7760",
-%% email="Internet: TUGboat@Math.AMS.com",
-%% codetable="ISO/ASCII",
-%% checksumtype="line count",
-%% checksum="844",
-%% keywords="tex users group, tugboat, authors' guide",
-%% abstract="This file is an updated version of the file
-%% that produced the original Authors' Guide in
-%% TUGboat 10, no. 3, November 1989."
+%% filename = "tubguide.tex",
+%% version = "1.03",
+%% date = "2006/05/24",
+%% time = "09:48:56 EDT",
+%% checksum = "12752 869 4993 34296",
+%% filetype = "TUGboat Authors' Guide",
+%% copyright = "Copyright 1989, 1992, 2006 TeX Users Group.
+%% Unlimited copying and redistribution of this file
+%% are permitted as long as this file is not
+%% modified. Modifications (and redistribution of
+%% modified versions) are also permitted, but only if
+%% the resulting file is renamed."
+%% author = "TeX Users Group",
+%% address = "TeX Users Group,
+%% P.O.Box 2311,
+%% Portland, OR 97208-2311,
+%% USA",
+%% telephone = "+1 503 223-9994",
+%% FAX = "+1 206 203-3960",
+%% email = "TUGboat@tug.org",
+%% codetable = "ISO/ASCII",
+%% keywords = "tex users group, tugboat, authors' guide",
+%% supported = "yes",
+%% abstract = "This file is an updated version of the file
+%% that produced the original Authors' Guide in
+%% TUGboat 10, no. 3, November 1989.",
+%% docstring = "The checksum field above contains a CRC-16
+%% checksum as the first value, followed by the
+%% equivalent of the standard UNIX wc (word
+%% count) utility output of lines, words, and
+%% characters. This is produced by Robert
+%% Solovay's checksum utility.",
%% }
%% *********************************************************
%%
@@ -39,23 +48,27 @@
% ****************************************************************
+\pageno=1
+\def\rtitlex{\def\tubfont{\tenpoint\rm}\TUB{} Authors' Guide, May 2006}
+\def\midrtitle{}
+
\title *\TUB\/ Authors' Guide*
\author * Ron Whitney *
\address * \TUG\\
\POBox 9506\\
Providence, RI 02940-9506 *
-\netaddress * TUGboat@Math.AMS.com *
+%\netaddress * TUGboat@Math.AMS.com *
\author * Barbara Beeton *
\address * American Mathematical Society\\
- \POBox 6248\\
- Providence, RI 02940-6248 *
-\netaddress * TUGboat@Math.AMS.com *
+ 201 Charles Street\\
+ Providence, RI 02904-2294 *
+\netaddress * TUGboat@tug.org *
-\vfootnote{}{Revised March 1992; the original appeared in \tubissue 10(3),
-November 1989.}
+\vfootnote{}{Revised March 1992, May 2006; the original appeared in
+\tubissue 10(3), November 1989.}
\article
@@ -79,7 +92,7 @@ make comment on various aspects of the \TUB\/ package, first for the
\plain-based macros, then for \LaTeX. The macro sets share
the file |tugboat.cmn|,\footnote{$^1$}{This file used to be named
{\tt tugboat.com}, but that notation was in conflict with conventions
-of MS-DOS and other operating systems; no conflicts are known to
+of \acro{MS-DOS} and other operating systems; no conflicts are known to
exist for the new name.} and users of either style should read the
section entitled ``Common Abbreviations and Utilities''. We conclude
with some general suggestions to help make the lives of those on the
@@ -212,7 +225,11 @@ of
\theaddress {<author number>}
\thenetaddress {<author number>}
||
-to get the desired result. For example, for an article with
+to get the desired result. For example, for an article with%
+\footnote{$^2$}{\xEdNote The \TUB{} address shown in examples
+was current when this article first appeared, but is now obsolete;
+it has been left intact to avoid other problems. The correct address
+is now {\tt TUGboat@tug.org}.}
\verbatim[\outputtofile{ray.vbm}]
\author * Ray Goucher *
\address * \TUG *
@@ -262,7 +279,7 @@ assemble streams of articles in \TUB.
\subhead * Section Heads *
Heads of sections, subsections, etc.\ are introduced with |\head|,
|\subhead|, etc., respectively. The underlying macros all use
-|\head|, so |\endhead| is the long-form ending for all these tags.
+|\head|, so |\endhead| is the long-form ending for all these tags.
For example, the first two heads of this article could have been
keyed as
||
@@ -467,13 +484,13 @@ escape character in that block. Thus,
||
really calls the italic font in the middle of the listing (one might
also want to use |\makebgroup| and |\makeegroup| in the options to define
-characters to localize this call; see p.~384). Situations
+characters to localize this call; see p.~7). Situations
will dictate preferences for what character may be used as an escape
(we use the \verbinline|\endverbatim, |!|, and |/| in this article).
There is also a means of changing the setup of every occurrence of
verbatim mode. The contents of token register |\everyverbatim|
is scanned after the defaults of verbatim mode
-have been set. In this article, for example, we have made
+have been set. In this article, for example, we have made
|[\makeother\<]<| active and defined it in such a way that
|[\makeother\<]<...>| typesets as metacode. Since |\verbatim|
ordinarily changes |[\makeother\<]<| to type `other' on startup, we key
@@ -543,7 +560,7 @@ top-insertions, but the options |[\lastoption][\mid]| and
bottom-insertions, respectively. Here we recommend that the
long-form terminator be used ({\it not\/} the |*...*| form). One can
think of the information ``passed'' as being ``long'' in the sense of
-possibly containing paragraphs, this being a mnemonic device only.
+possibly containing paragraphs, this being a mnemonic device only.
The primary reason for the recommendation is that one is (in some
sense, maybe) more likely to encounter a rogue |*| in longer text
than in shorter text and hence more likely to encounter a surprising
@@ -552,7 +569,7 @@ result due to a macro stopping short at the wrong |*|.
\subtext
Perhaps here is a natural place to mention also that these macros
sometimes read their arguments and then act, and sometimes act on the
-fly, not actually storing an argument as a string of tokens at all.
+fly, not actually storing an argument as a string of tokens at all.
|\title|, for example, is in the former category, while |\figure| is
in the latter. Reasons may vary for the choice in
methods. Storing a string of tokens as an argument does not allow
@@ -649,12 +666,15 @@ listed under tags.
||
and, of course, \verbinline|\endverbatim and \verbinline||\endverbatim.
-\head * The \LaTeX\ macros: {\tt ltugboat.sty} *
+\head * The \LaTeX\ macros: {\tt ltugboat.sty}%
+\footnote{$^3$}{This discussion of {\tt ltugboat.sty} is now of
+historical interest only; it has been superseded by a \LaTeXe{}
+documentclass, {\tt ltugboat.cls}, available from \CTAN.} *
|ltugboat.sty| is the primary macro file, and is based on the \LaTeX{}
|article.sty|. |tugboat.cmn|, a collection of items common to both
\LaTeX\ and \plain\ input, is also required. Articles will have
-the form:\footnote{$^2$}{{\tt ltugboat} used to be a substyle; it now
+the form:\footnote{$^4$}{{\tt ltugboat} used to be a substyle; it now
stands on its own, by automatically inputting {\tt article.sty}.}
\verbatim[\makeescape\|]
\documentstyle{ltugboat}
@@ -703,6 +723,11 @@ and |\BibTeX| are contained in |tugboat.cmn|. Please use these whenever
possible rather than creating your own. We will add to the list as
necessary.
+A nicety for the sake of appearance is the command |\acro|, which
+sets an acronym in caps one size smaller than the surrounding text.
+Compare CTAN (full size), \CTAN{} (|\acro{CTAN}|) and {\smc ctan}
+(small caps). Acronyms in |tugboat.cmn| use |\acro| consistently.
+
Several other constructions that we have found useful for both
\plain- and \LaTeX-style input have been incorporated in
|tugboat.cmn|. Various |\*lap|\,s (|\ulap|, |\dlap|, |\xlap|,
@@ -828,11 +853,11 @@ appreciated.
In addition to |tugboat.sty|, |ltugboat.sty|, and |tugboat.cmn|,
a copy of this article, |tubguide.tex|, will be available at
-most \TeX{} archives, including those at SHSU, Aston, and Stuttgart.
+most \TeX{} archives, in particular \CTAN.
Please address all electronic correspondence to the \TUB{} maildrop:
-||TUGboat@Math.AMS.com||
-Mail to either of our personal addresses is liable to go unseen if
+||TUGboat@tug.org||
+Mail to personal addresses is liable to go unseen if
vacation or illness intervenes. We also request that you supply
an abstract of any expository article. This will be used as the
basis for translation of abstracts to languages other than that