From 38f1b1f824533095ff806ce10fd7009b518331c0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 28 May 2006 18:33:58 +0000 Subject: tugboat update git-svn-id: svn://tug.org/texlive/trunk@1603 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/plain/tugboat/README | 4 + Master/texmf-dist/doc/plain/tugboat/tubguide.pdf | Bin 140238 -> 117297 bytes Master/texmf-dist/doc/plain/tugboat/tubguide.tex | 107 ++++++++++++++--------- 3 files changed, 70 insertions(+), 41 deletions(-) create mode 100644 Master/texmf-dist/doc/plain/tugboat/README (limited to 'Master/texmf-dist/doc/plain') 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 Binary files a/Master/texmf-dist/doc/plain/tugboat/tubguide.pdf and b/Master/texmf-dist/doc/plain/tugboat/tubguide.pdf 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 {} \thenetaddress {} || -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 -- cgit v1.2.3