From b74ab6d22996ea739453c7df39ee2abfb6c61f36 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 23 May 2012 23:32:15 +0000 Subject: tugboat-plain (23may12) git-svn-id: svn://tug.org/texlive/trunk@26611 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/plain/tugboat-plain/README | 1 + .../doc/plain/tugboat-plain/tubguide.pdf | Bin 117297 -> 225439 bytes .../doc/plain/tugboat-plain/tubguide.tex | 84 ++++++++++----------- .../texmf-dist/tex/plain/tugboat-plain/tugboat.cmn | 66 ++++++++-------- .../texmf-dist/tex/plain/tugboat-plain/tugboat.sty | 52 +++++++++---- 5 files changed, 112 insertions(+), 91 deletions(-) diff --git a/Master/texmf-dist/doc/plain/tugboat-plain/README b/Master/texmf-dist/doc/plain/tugboat-plain/README index 996049fd4fe..49b8e6eabb7 100644 --- a/Master/texmf-dist/doc/plain/tugboat-plain/README +++ b/Master/texmf-dist/doc/plain/tugboat-plain/README @@ -1,3 +1,4 @@ +$Id: README 100 2012-05-22 18:09:46Z bnb $ (This file in the public domain.) The plain style files for TUGboat, the journal of the TeX Users Group. diff --git a/Master/texmf-dist/doc/plain/tugboat-plain/tubguide.pdf b/Master/texmf-dist/doc/plain/tugboat-plain/tubguide.pdf index 5e00b9eea76..c7980af52c2 100644 Binary files a/Master/texmf-dist/doc/plain/tugboat-plain/tubguide.pdf and b/Master/texmf-dist/doc/plain/tugboat-plain/tubguide.pdf differ diff --git a/Master/texmf-dist/doc/plain/tugboat-plain/tubguide.tex b/Master/texmf-dist/doc/plain/tugboat-plain/tubguide.tex index 56a18c8602b..a51b5ab3b9b 100644 --- a/Master/texmf-dist/doc/plain/tugboat-plain/tubguide.tex +++ b/Master/texmf-dist/doc/plain/tugboat-plain/tubguide.tex @@ -1,37 +1,23 @@ %% @texfile{ %% filename = "tubguide.tex", -%% version = "1.03", -%% date = "2006/05/24", -%% time = "09:48:56 EDT", -%% checksum = "12752 869 4993 34296", +%% version = "1.04", +%% date = "2012/05/22", %% filetype = "TUGboat Authors' Guide", -%% copyright = "Copyright 1989, 1992, 2006 TeX Users Group. +%% copyright = "Copyright 1989, 1992, 2006, 2012 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", +%% keywords = "tex users group, tugboat, plain 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.", %% } +%% $Id: tubguide.tex 100 2012-05-22 18:09:46Z bnb $ %% ********************************************************* %% %% TeXing this file requires the following files: @@ -42,6 +28,12 @@ \input tugboat.sty +% tugboat.sty used to default to this, and no point in changing lots of +% text to fix overfull boxes. +\StretchyTenPointSpacing +\StretchyNinePointSpacing +\StretchyEightPointSpacing + \enablemetacode \everyverbatim{\enablemetacode} \def\halfline{\vskip 0.5\baselineskip \ignoreendline} @@ -49,16 +41,10 @@ % **************************************************************** \pageno=1 -\def\rtitlex{\def\tubfont{\tenpoint\rm}\TUB{} Authors' Guide, May 2006} +\def\rtitlex{\def\tubfont{\tenpoint\rm}\TUB{} Authors' Guide, May 2012} \def\midrtitle{} -\title *\TUB\/ Authors' Guide* - -\author * Ron Whitney * -\address * \TUG\\ - \POBox 9506\\ - Providence, RI 02940-9506 * -%\netaddress * TUGboat@Math.AMS.com * +\title *\TUB\/ authors' guide* \author * Barbara Beeton * \address * American Mathematical Society\\ @@ -66,8 +52,12 @@ Providence, RI 02904-2294 * \netaddress * TUGboat@tug.org * +\author * Ron Whitney * +%\address * \TUG * +%\netaddress * TUGboat@Math.AMS.com * -\vfootnote{}{Revised March 1992, May 2006; the original appeared in + +\vfootnote{}{Revised March 1992, May 2006, May 2012; the original appeared in \tubissue 10(3), November 1989.} \article @@ -276,7 +266,7 @@ produces assemble streams of articles in \TUB. -\subhead * Section Heads * +\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. @@ -355,7 +345,7 @@ rather than giving an option to each list. Implementation of sublists is under construction. -\subhead * Verbatim Modes * +\subhead * Verbatim modes * There are several variations on this theme. In each case, text is printed in a typewriter font and (almost) all input characters @@ -379,8 +369,14 @@ for longer items the form (although \verbinline||...||\endverbatim is a good way to display a single line of code). -In addition to formatting text between |\verbatim| and -|\endverbatim|, |\verbatim| may read and write data from and to +The display verbatim output is in nine-point typewriter by default, as +shown in this document. We've found the extra characters of width +gained as a result are very useful. If |\smallverbdisplay| is defined +to be a no-op, it will be in the usual ten-point. (This change was +introduced in 2012.) + +As well as formatting verbatim text between |\verbatim| and +|\endverbatim|, |\verbatim| can read and write data from and to files. We find this variant useful in ({\it almost\/}) guaranteeing consonance between macros in use and their published listings. ||[\makeescape\!] @@ -545,7 +541,7 @@ text may or may not start a new paragraph depending on whether an intervening blank line (or |\par|) is or is not present. -\subhead * Figures and Page Layout * +\subhead * Figures and page layout * Figures are keyed as \verbatim[\makeescape\|] \figure @@ -625,7 +621,7 @@ switching between one- and two-column format within a year. |\newpage| in each format is defined to fill and eject enough columns to get to the next page. |\newcol| is just |\par\vfill\eject|. -\subhead * Command List Summary * +\subhead * Command list summary * Tags are listed in the order discussed. Options are listed under tags. || @@ -716,7 +712,7 @@ direction. -\head * Common Abbreviations and Utilities * +\head * Common abbreviations and utilities * Definitions of a number of commonly used abbreviations such as |\MF| and |\BibTeX| are contained in |tugboat.cmn|. Please use these whenever @@ -759,7 +755,7 @@ this article. Readers may look at the end of |tugboat.cmn| after the |\endinput| statement to see further documentation on the contents of the file. -\subhead * Issue Makeup * +\subhead * Issue makeup * Constructing an entire issue of \TUB\/ requires use of a few features that authors may notice when articles are returned for proofing. |\xrefto| allows for symbolic cross-referencing, but is enabled only @@ -772,7 +768,7 @@ remember, and these appear as |\TBremark{...}|. Authors can look for such things, if they are interested. -\head * General Coding Suggestions * +\head * General coding suggestions * Probably 90\% of the code we receive is easily handled, and for this we are most appreciative. We do have suggestions of a general nature @@ -801,7 +797,7 @@ case, until the last minute. We also use floating insertions for figure and table placement when we first receive an article. It is easier for us to work with a clean file containing some bad breaks, overfull boxes or other unsightliness, than it is to handle a document -containing {\it ad hoc\/} code dedicated to a beauteous (albeit +containing {\it ad hoc\/} code dedicated to a beauteous (but narrowly specific) result. @@ -821,7 +817,7 @@ other reasonable formats of their texts are made. In the case of the two-column format. Since these types of items are not generally susceptible to automatic line-breaking, we give thanks to stuffings made by authors ahead of time. In this context, we recommend the use -of |\verbfile{...}| (see the section {\bf Verbatim Modes}) to maintain +of |\verbfile{...}| (see the section `{Verbatim modes}') to maintain consistency between documentation and reality. Specifically in the domain of \TeX\ macros, we find that many authors @@ -849,11 +845,13 @@ appreciated. \TBremark{Anything about formatting macros?} -\head * Electronic Documentation and Submission Procedure * +\head * Electronic documentation and submissions * In addition to |tugboat.sty|, |ltugboat.sty|, and |tugboat.cmn|, -a copy of this article, |tubguide.tex|, will be available at -most \TeX{} archives, in particular \CTAN. +a copy of this article, |tubguide.tex|, will be available in +most \TeX{} distributions and on \CTAN: +||http://ctan.org/pkg/tugboat +http://ctan.org/pkg/tugboat-plain|| Please address all electronic correspondence to the \TUB{} maildrop: ||TUGboat@tug.org|| @@ -863,6 +861,8 @@ an abstract of any expository article. This will be used as the basis for translation of abstracts to languages other than that in which the article is published. +\smallskip +The \TUB\ home page on the web is |http://tug.org/TUGboat|. \makesignature diff --git a/Master/texmf-dist/tex/plain/tugboat-plain/tugboat.cmn b/Master/texmf-dist/tex/plain/tugboat-plain/tugboat.cmn index 1f2bb8ef391..24f48135e19 100644 --- a/Master/texmf-dist/tex/plain/tugboat-plain/tugboat.cmn +++ b/Master/texmf-dist/tex/plain/tugboat-plain/tugboat.cmn @@ -1,45 +1,29 @@ %% @texfile{ %% filename = "tugboat.cmn", -%% version = "1.19", -%% date = "2008/05/20", -%% time = "10:14:37 EDT", -%% checksum = "01850 1112 3202 36735", +%% version = "see below \fileversion" +%% date = "see below \filedate", %% filetype = "common macros for TUGboat", -%% copyright = "Copyright 1993-1996, 2006 TeX Users Group. +%% copyright = "Copyright 1993-1996,2006,2008,2011,2012 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, common macros", +%% keywords = "tex users group, tugboat, common macros, plain tex", %% supported = "yes", -%% abstract = "This file contains macros common to both -%% the PLAIN and LaTeX style files for TUGboat, -%% the Communications of the TeX Users Group. +%% abstract = "This file contains macros potentially common to +%% the various style files for TUGboat, %% Among other things, it contains supplementary %% definitions for abbreviations and logos that -%% appear in TUGboat.", -%% 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.", +%% appear in TUGboat." %% } -%% +%% $Id: tugboat.cmn 100 2012-05-22 18:09:46Z bnb $ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\fileversion{v1.19} -\def\filedate{2008/05/20} +\def\fileversion{v1.20} +\def\filedate{2012/05/22} \message{File `TUGBOAT.CMN' \fileversion \space\space <\filedate>} @@ -119,8 +103,9 @@ \def\AmSLaTeX{\AmS-\LaTeX} \def\AmSTeX{\AmS-\TeX} \def\ANSI{\acro{ANSI}} +\def\API{\acro{API}} \def\ASCII{\acro{ASCII}} -\def\aw{A\kern.1em-W} +\def\aw{\acro{A\kern.04em\raise.115ex\hbox{-}W}} \def\AW{Addison\kern.1em-\penalty\z@\hskip\z@skip Wesley} \def\BibTeX{{\rm B\kern-.05em{\smc i\kern-.025emb}\kern-.08em\TeX}} \def\CandT{{\sl Computers \& Typesetting}} @@ -141,6 +126,7 @@ \def\Hawaii{Hawai`i} \def\HTML{\acro{HTML}} \def\HTTP{\acro{HTTP}} +\def\IDE{\acro{IDE}} \def\ISBN{\acro{ISBN}} \def\ISO{\acro{ISO}} \def\ISSN{\acro{ISSN}} @@ -184,6 +170,7 @@ \def\PCTeX{PC\thinspace\TeX} \def\pcTeX{\leavevmode\raise.5ex\hbox{p\kern-.3ptc}\TeX} \def\PDF{\acro{PDF}} +\def\PGF{\acro{PGF}} \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC\spacefactor1000 } \def\PiCTeX{\PiC\kern-.11em\TeX} \def\plain{{\tt plain}} @@ -191,6 +178,8 @@ \def\POBox{P.\thinspace O.~Box } %\def\POBoxTUG{\POBox\unskip~9506, Providence, RI~02940} \def\PS{{Post\-Script}} +\def\PSTricks{\acro{PST}ricks} +\def\RGB{\acro{RGB}} \def\RTF{\acro{RTF}} \def\SC{Steering Committee} \def\SGML{\acro{SGML}} @@ -213,10 +202,12 @@ % \TeX\-\hbox{$\fam\TestCount\scriptstyle TURES$}} \def\TeXtures{{\it Textures}} \let\Textures=\TeXtures +\def\TeXworks{\TeX\kern-.07em works} \def\TeXXeT{\TeX-{}-\XeT} \def\TFM{\acro{TFM}} \def\Thanh{H\`an~Th\^e\llap{\raise.5ex\hbox{\'{}}}~Th\`anh} \def\TIFF{\acro{TIFF}} +\def\TikZ{Ti{\it k}Z} \def\ttn{{\sl TTN}\spacefactor1000 } \def\TTN{{\sl \TeX{} and TUG NEWS}\spacefactor1000 } \def\tubfont{\sl} % redefined in other situations @@ -736,7 +727,9 @@ \def\signaturemark{\leavevmode\llap{$\diamond$\enspace}} -% some hyphenation exceptions: +% some hyphenation exceptions, unless \tubomithyphenations +% is defined (used in tb*hyf.tex). +\ifx\tubomithyphenations\@thisisundefined \hyphenation{Del-a-ware Dijk-stra Duane Eijk-hout Flor-i-da Free-BSD Ghost-script Ghost-view Hara-lam-bous Jac-kow-ski Karls-ruhe @@ -744,33 +737,34 @@ Net-BSD Open-BSD Open-Office Pfa-Edit Post-Script Rich-ard Skoup South-all Vieth VM-ware Win-Edt - acro-nym ap-pen-dix asyn-chro-nous - bit-map bit-mapped bit-maps buf-fer buf-fers bool-ean + acro-nym acro-nyms analy-sis ap-pen-di-ces ap-pen-dix asyn-chro-nous + bib-lio-graph-i-cal bit-map bit-mapped bit-maps buf-fer buf-fers bool-ean col-umns com-put-able com-put-abil-ity cus-tom-iz-able data-base data-bases de-allo-cate de-allo-cates de-allo-cated de-allo-ca-tion - de-riv-a-tive de-riv-a-tives de-riv-a-ble der-i-va-tion + de-riv-a-tive de-riv-a-tives de-riv-a-ble der-i-va-tion dis-trib-ut-able es-sence fall-ing half-way in-fra-struc-ture key-note long-est - ma-gyar man-u-script man-u-scripts mne-mon-ic mne-mon-ics - mono-space mono-spaced + ma-gyar man-u-script man-u-scripts meta-table meta-tables + mne-mon-ic mne-mon-ics mono-space mono-spaced name-space name-spaces off-line over-view pal-ettes par-a-digm par-a-dig-mat-ic par-a-digms pipe-line pipe-lines plug-in plug-ins pres-ent-ly pro-gram-mable - re-allo-cate re-allo-cates re-allo-cated + re-allo-cate re-allo-cates re-allo-cated re-printed set-ups se-vere-ly spell-ing spell-ings stand-alone strong-est - sub-ex-pres-sion syn-chro-ni-city syn-chro-nous + sub-ex-pres-sion sub-tables sur-gery syn-chro-ni-city syn-chro-nous text-height text-length text-width time-stamp time-stamped time-stamps vis-ual vis-ual-ly which-ever white-space white-spaces wide-spread wrap-around } +\fi \restorecat\@ @@ -1006,6 +1000,8 @@ that may not be obvious. For full definitions, see real code above. Version Date Changes ------- --------- --------------------------------------------------- +1.20 4 Apr 12 allow omission of hyphenation list + 1.19 20 May 08 additions to hyphenation list 1.18 7 Jun 06 another fix to repair a stupid mistake diff --git a/Master/texmf-dist/tex/plain/tugboat-plain/tugboat.sty b/Master/texmf-dist/tex/plain/tugboat-plain/tugboat.sty index 6df1624419a..84dae0b1f8c 100644 --- a/Master/texmf-dist/tex/plain/tugboat-plain/tugboat.sty +++ b/Master/texmf-dist/tex/plain/tugboat-plain/tugboat.sty @@ -1,9 +1,9 @@ %% @texfile{ %% filename = "tugboat.sty", -%% version = "1.19", -%% date = "2011/03/11", +%% version = "see below \fileversion" +%% date = "see below \filedate", %% filetype = "Plain TeX macros for TUGboat", -%% copyright = "Copyright 1993, 1999, 2003, 2006, 2011 TeX Users Group. +%% copyright = "Copyright 1993,1999,2003,2006,2011,2012 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,6 +17,8 @@ %% for preparation of items in TUGboat, the %% Communications of the TeX Users Group.", %% } +%% $Id: tugboat.sty 100 2012-05-22 18:09:46Z bnb $ +%% %% ********************************************************* %% %% TeXing with this file also requires the following files: @@ -27,8 +29,8 @@ % TUGBOAT.STY \def\thistubstyle{plain} -\def\fileversion{v1.19} -\def\filedate{2011/03/04} +\def\fileversion{v1.20} +\def\filedate{2012/05/22} % general items @@ -137,6 +139,14 @@ \font\ninett=cmtt9 \font\eighttt=cmtt8 +\ifx\tubhyphenatett\@thisisundefined + % do not hyphenate typewriter unless explicitly requested (as + % tb0hyf.tex does). + \hyphenchar\tentt=-1 + \hyphenchar\ninett=-1 + \hyphenchar\eighttt=-1 +\fi + \font\tensl=cmsl10 \font\ninesl=cmsl9 \font\eightsl=cmsl8 @@ -592,12 +602,15 @@ \splitmaxdepth\dp\strutbox \floatingpenalty\@MM \leftskip\z@skip \rightskip\z@skip \spaceskip\z@skip \xspaceskip\z@skip \rm \parindent=\normalparindent % always indent footnotes; added for TUGboat + \TUBstartfootnotehook \textindent{#1}\makestrut[10pt;\z@]\futurelet\next\fo@t} -\def\@foot{\strut\egroup +\def\@foot{\strut\egroup\TUBendfootnotehook \ifDelayFirstPar \SetupFirstPar \global\DelayFirstParfalse \fi } \newif\ifFirstPar \FirstParfalse \def\SetupFirstPar{\global\parindent=\z@ \global\FirstPartrue } +\def\TUBstartfootnotehook{} +\def\TUBendfootnotehook{} %% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -1644,12 +1657,12 @@ \def\CurrentTag{verbatim}% \@defaultoptions \def\inline{\let\@verbstyle\@inlinestyle}% - \def\display{\let\@verbstyle\@displaystyle}% + \def\display{\par\smallverbdisplay\let\@verbstyle\@displaystyle}% \def\displaystyle##1{\def\@altdisplaystyle{##1}}% \def\inlinestyle##1{\def\@altinlinestyle{##1}}% \def\numbered{\@numberedtrue}% \def\ruled{\@ruledtrue}% - \def\smallcode{\ninepoint\tt\baselineskip=10pt}% + \def\smallcode{\ninepoint\tt\baselineskip=10pt }% \let\@verbinputvar\relax \let\@verbinputfile\relax \@SpecialsGetOther @@ -1660,6 +1673,9 @@ \the\everyverbatim } +% By default, switch to 9pt tt for verbatim displays. +\def\smallverbdisplay{\smallcode} + \def\@SpecialsGetOther{% \catcode`\\=\other \catcode`\{=\other \catcode`\}=\other \catcode`\$=\other @@ -1848,8 +1864,8 @@ % Options and variants. -\def\verbinline{\verbatim[\inline]} -\def\verbdisplay{\verbatim[\display]} +\def\verbinline{\@verbatim[\inline]} % \@verbatim to avoid \display +\def\verbdisplay{\verbatim[\display]} % already the default, but what the heck \def\verbfile#1{\verbatim[\inputfromfile{#1}]} @@ -1885,7 +1901,7 @@ \expandafter\@checknexttoken\expandafter{\the\@verbchar}% {\expandafter\@ignoreone\expandafter{\the\@verbchar}% {\endgroup\verbatim[\longform\maketwoendverb]}}% - {\endgroup\verbatim[\inline\longform\makeoneendverb]}% + {\endgroup\@verbatim[\inline\longform\makeoneendverb]}% } \def\setupverbchar{% @@ -2165,9 +2181,11 @@ \initializearticle \pageno=1001 % number of title page -\StretchyTenPointSpacing -\StretchyNinePointSpacing -\StretchyEightPointSpacing +% Stretchy spacing was the default for many years, but in summer 2011 it +% looked too stretchy. Comment out. +%\StretchyTenPointSpacing +%\StretchyNinePointSpacing +%\StretchyEightPointSpacing \makevertverbchar @@ -2179,6 +2197,12 @@ Version Date Changes ------- --------- --------------------------------------------------- +1.20 22 May 12 Do not hyphenate in typewriter. + Add footnote hooks. + No \Stretchy*Spacing by default. + \smallcode for verbatim displays (not inline) + via \smallverbdisplay. + 1.19 4 Mar 11 added \r 1.18 4 Feb 11 changed \rfoot to give same results as LaTeX class -- cgit v1.2.3