summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/README6
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx82
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/ltubguid.pdfbin260834 -> 211354 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/manifest.txt8
-rw-r--r--Master/texmf-dist/doc/latex/tugboat/tugboat.pdfbin380193 -> 282399 bytes
-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
8 files changed, 142 insertions, 65 deletions
diff --git a/Master/texmf-dist/doc/latex/tugboat/README b/Master/texmf-dist/doc/latex/tugboat/README
index 2726ccb6e12..736c57e3574 100644
--- a/Master/texmf-dist/doc/latex/tugboat/README
+++ b/Master/texmf-dist/doc/latex/tugboat/README
@@ -10,9 +10,15 @@ editor, if you're preparing an article for submission to a TUG
conference). Bother me, instead (the editors do, in any case, so you
might as well short-circuit them ;-)
+See the TUGboat web pages at http://tug.org/TUGboat for back issues,
+guidelines for authors, etc. We greatly appreciate new article
+submissions!
+
+
Robin Fairbairns
robin.fairbairns@cl.cam.ac.uk
+
Installation and use:
=====================
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx b/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
index afc85ad0165..8155296a13e 100644
--- a/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
+++ b/Master/texmf-dist/doc/latex/tugboat/ltubguid.ltx
@@ -1,3 +1,29 @@
+% ltubguid.ltx - documentation for ltugboat classes.
+%
+%% Copyright 1994,1995,1996,2001,2005,2006 TeX Users Group.
+%%
+%% This file is part of the tugboat package.
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either version 1.3
+%% of this license or (at your option) any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of LaTeX
+%% version 2003/12/01 or later.
+%%
+%% This work has the LPPL maintenance status "maintained".
+%%
+%% The Current Maintainer of this work is the TeX Users Group
+%% (http://tug.org/TUGboat).
+%%
+%% The list of all files belonging to the distribution is
+%% given in the file `manifest.txt'.
+%%
+%% The list of derived (unpacked) files belonging to the distribution
+%% and covered by LPPL is defined by the unpacking scripts (with
+%% extension .ins) which are part of the distribution.
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% tubguide.bib -- the bibliography for this paper (apart from the
@@ -148,7 +174,7 @@
%
\listfiles
\setcounter{errorcontextlines}{999}
-\documentclass[harvardcite]{ltugboat}
+\documentclass[harvardcite,final]{ltugboat}
\usepackage{ctandir}
\IfFileExists{booktabs.sty}%
{\usepackage{booktabs}}%
@@ -157,9 +183,6 @@
% only tell me important overfulls, please
\hfuzz=2pt
%
-% ahem, why not?
-\hyphenation{col-umns}
-%
% define CTAN addresses using the commands of the |ctandir| package
\CTANdirectory{bibextract}{biblio/bibtex/utils/bibextract}
\CTANdirectory{mflogo}{macros/latex/contrib/mflogo}
@@ -232,7 +255,7 @@
\begin{document}
%%%%%%%%%%%%%%%%
%
-\title{The New (\LaTeXe) \TUB{} Macros}
+\title{The \LaTeXe\ \TUB{} Macros}
\author{Robin Fairbairns}
\address{University of Cambridge Computer Laboratory\\
William Gates Building\\
@@ -278,6 +301,11 @@ within \LaTeX.}
present note.
\end{sloppypar}
+The \TUB\ web site is at \url{http://tug.org/TUGboat}. It contains much
+information for authors and reviewers, all the back issues, and plenty
+more. In particular, sample documents for both regular articles and
+proceedings articles are available from \url{http://tug.org/TUGboat}.
+
\section{The general structure of a paper}
The author need not understand the details of the production of
@@ -317,13 +345,11 @@ one/two-side and one/two-column options).
\begin{optlist}
\item[draft] Set up for a draft copy of a paper (this is the default
setting\Dash the author need not explicitly set it): page numbering
- to start at 1001, black marks for overfull boxes, and no
- registration marks.
+ to start at 1001, black marks for overfull boxes.
\item[extralabel] Use the extra label-distinguishing mark in the body
of the reference; see section~\ref{sec:biblio}.
\item[final] Set up for the final copy of a paper: page numbering to
- come from elsewhere, no black marks, and registration marks to be
- used.
+ come from elsewhere, no black marks.
\item[harvardcite] Specify Harvard-style citation; see
section~\ref{sec:biblio}.
\item[noextralabel] Don't use the extra label-distinguishing mark in
@@ -345,7 +371,7 @@ one/two-side and one/two-column options).
The \clsname{ltugproc} class accepts all of the options allowed with
\clsname{ltugboat}. In addition, it accepts an option that specifies
the year of the conference for which the paper is submitted. For
-example, the conference for 2004 would be specified by option
+example, the conference for \number\year\ would be specified by option
%
%% % although this paper will be published in 1996, it may be reprinted
%% % again in the future, so let's calculate `this year' on the fly
@@ -470,7 +496,7 @@ the main body of the paper. Therefore, for proceedings articles, the
\subsection{Appendices}
A paper may have appendices, which are expressed in exactly the same
-way as they would be in \LaTeX{} article class:
+way as they would be in the \LaTeX{} article class:
\begin{verbatim}[\small]
\appendix
@@ -590,7 +616,7 @@ between the \cs{maketitle} and (possibly) \cs{makesignature} commands.
are under the general (sub-)\penalty0\relax\hskip0pt plus0pt minus0pt\relax
editorship of the author\footnote{Or authors: there's no reason in
particular that compilation articles should not be put together
- more than one person} of the article. The author of the article
+ by more than one person.} of the article. The author of the article
is presented (using \cs{author} and suchlike commands) in the usual
way, and writes the introductory text. Each contributors' part then
follows. The contributor's name is quoted in the \cs{contributor}
@@ -715,42 +741,50 @@ set of the macros.
The classes provide macros that produce `correct' representations of a
large number of acronyms and logos; a small representative selection is
-shown in figure~\ref{fig:acro-logo}.
+shown in figure~\ref{fig:acro-logo}. The sample documents at
+\url{http://tug.org/TUGboat/location.html} have a more complete list,
+and of course the class sources are the ultimate reference.
\begin{figure}[htbp!]
\begin{center}
\begin{tabular}{@{}ll@{}}
\small\textsl{\textsf{Macro}}&\small\textsl{\textsf{Output}}\\
\midrule
+ \verb|\ConTeXt| & \ConTeXt \\
+ \verb|\Cplusplus| & \Cplusplus \\
\verb|\CTAN| & \CTAN \\
\verb|\eTex| & \eTeX \\
+ \verb|\FAQ| & \FAQ \\
\verb|\HTML| & \HTML \\
\verb|\ISBN| & \ISBN \\
\verb|\ISSN| & \ISSN \\
+ \verb|\MacOSX| & \MacOSX \\
+ \verb|\MathML| & \MathML \\
\verb|\MF| & \MF \\
\verb|\MP| & \MP \\
\verb|\NTS| & \NTS \\
\verb|\OMEGA| & \OMEGA \\
\verb|\OTP| & \OTP \\
+ \verb|\PDF| & \PDF \\
\verb|\SGML| & \SGML \\
\verb|\TUB| & \TUB \\
\verb|\TUG| & \TUG \\
\verb|\tug| & \tug \\
+ \verb|\XML| & \XML \\
\end{tabular}
\end{center}
- \caption{Some of the classes' acronyms and logos}
+ \caption{A few of the classes' acronyms and logos}
\label{fig:acro-logo}
\end{figure}
-Authors are urged to note the \cs{acro} command, which is defined in
-the classes. The visual appearance of (mostly) lower-case English
-text, with interpolated acronyms in the same point size, is generally
-unpleasing. Therefore, the \cs{acro} command typesets its argument
-slightly smaller than it would otherwise appear: compare `\acro{URL}'
-(\verb|\acro{URL}|, as used above) with `URL'\@. Many macros that
-simply generate calls to \cs{acro} are defined by the classes; two
-examples, \cs{CTAN} and \cs{tug} of the list in
-figure~\ref{fig:acro-logo} have already been used in the present
-paper.
+Authors are especially urged to note the \cs{acro} command, which is
+defined in the classes. The visual appearance of (mostly) lower-case
+English text, with interpolated acronyms in the same point size, is
+generally unpleasing. Therefore, the \cs{acro} command typesets its
+argument slightly smaller than it would otherwise appear: compare
+`\acro{URL}' (\verb|\acro{URL}|, as used above) with `URL'\@. Many
+macros that simply generate calls to \cs{acro} are defined by the
+classes; two examples, \cs{CTAN} and \cs{tug} of the list in
+figure~\ref{fig:acro-logo} have already been used in the present paper.
\subsection{Other special typesetting}
diff --git a/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf b/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
index 5211b28f836..ac781e3fc5c 100644
--- a/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
+++ b/Master/texmf-dist/doc/latex/tugboat/ltubguid.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tugboat/manifest.txt b/Master/texmf-dist/doc/latex/tugboat/manifest.txt
new file mode 100644
index 00000000000..b7076020e57
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tugboat/manifest.txt
@@ -0,0 +1,8 @@
+List of files in the tugboat LaTeX package.
+README
+ltubguid.ltx
+ltubguid.pdf
+ltugbib.bst
+tugboat.dtx
+tugboat.pdf
+tugboat.ins
diff --git a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
index 4d327cd84c1..9db6e63ea25 100644
--- a/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
+++ b/Master/texmf-dist/doc/latex/tugboat/tugboat.pdf
Binary files differ
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