diff options
author | Karl Berry <karl@freefriends.org> | 2009-06-24 16:38:12 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-06-24 16:38:12 +0000 |
commit | 4873be2e9722a5d9a95aa8edb9859d735853ab27 (patch) | |
tree | 3a3ba44ae3136602dfe6cb8f9f26d55b78a35ff6 /Master/texmf-dist/source/latex | |
parent | f1fef055879de5641d7a1fcfab20d36da85686b2 (diff) |
tugboat update (23jun09)
git-svn-id: svn://tug.org/texlive/trunk@13943 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex')
-rw-r--r-- | Master/texmf-dist/source/latex/tugboat/ltubguid.ltx | 1026 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/tugboat/tugboat.dtx | 378 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/tugboat/tugboat.ins | 11 |
3 files changed, 239 insertions, 1176 deletions
diff --git a/Master/texmf-dist/source/latex/tugboat/ltubguid.ltx b/Master/texmf-dist/source/latex/tugboat/ltubguid.ltx deleted file mode 100644 index 8155296a13e..00000000000 --- a/Master/texmf-dist/source/latex/tugboat/ltubguid.ltx +++ /dev/null @@ -1,1026 +0,0 @@ -% 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 -% references to TUGboat itself) -% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -\begin{filecontents}{tubguide.bib} -% BibTeX bibliography file (generated by aux2bib) - -@Misc{Arseneau:url:1996, - author = {Donald Arseneau}, - title = {The {\textsf{url}} package}, - year = {1996}, - howpublished = {Available from {\CTAN}, {\CTANref{url}}} -} - -@Article{Baxter:TB15-3-331, - author = {William Erik Baxter}, - title = {{{An object-oriented programming system in {\TeX}}}}, - journal = {{\TUB}}, - year = {1994}, - month = {September}, - volume = {15}, - number = {3}, - pages = {331--338} -} - -@Misc{Duggan:moreverb:1996, - author = {Angus Duggan and Rainer Sch{\umlaut{o}}pf and Victor Eijkhout and - Robin Fairbairns}, - title = {The {\textsf{moreverb}} package}, - year = {1997}, - howpublished = {Available from {\CTAN}, {\CTANref{moreverb}}} -} - -@Misc{Rahtz:hyperref:1997, - author = {Sebastian Rahtz}, - title = {The {\textsf{hyperref}} system}, - year = 1997, - howpublished = {Available from {\CTAN}, {\CTANref{hyperref}}} -} - -@Book{Lamport:1994, - author = {Leslie Lamport}, - title = {{\LaTeX}, a Document Preparation System}, - edition = {\nth{2}}, - year = {1994}, - publisher = {Addison-Wesley} -} - -@Article{Ogawa:TB15-3-325, - author = {Arthur Ogawa}, - title = {{{Object-oriented programming, descriptive markup, and {\TeX}}}}, - journal = {{\TUB}}, - year = {1994}, - month = {September}, - volume = {15}, - number = {3}, - pages = {325--330} -} - -@Article{Rowley:TB15-1-63, - author = {Chris Rowley}, - title = {{{{\LaTeXe} update, dateline: 31 January 1994}}}, - journal = {{\TUB}}, - year = {1994}, - month = {March}, - volume = {15}, - number = {1}, - pages = {63} -} - -@Misc{Schoepf:verbatim:1996, - author = {Rainer Sch{\umlaut{o}}pf}, - title = {The {\textsf{verbatim}} package}, - year = {1996}, - month = {June}, - howpublished = {Part of the \textsf{tools} bundle, available from {\CTAN}, - {\CTANref{tools}}} -} - -@Article{Swift:TB16-3-269, - author = {Matt Swift}, - title = {Modularity in {\LaTeX}}, - journal = {{\TUB}}, - year = {1995}, - volume = {16}, - number = {3}, - pages = {269--275} -} - -@Misc{Vieth:mflogo:1995, - author = {Ulrik Vieth}, - title = {The {\textsf{mflogo}} package}, - year = {1995}, - howpublished = {Available from {\CTAN}, {\CTANref{mflogo}}} -} - -@Article{Whitney:TB10-3-378, - author = {Ron Whitney and Barbara Beeton}, - title = {{{{\TUB} authors' guide}}}, - journal = {{\TUB}}, - year = {1989}, - month = {November}, - volume = {10}, - number = {3}, - pages = {378--385} -} - -\end{filecontents} -% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% ctandir.sty -- an experimental style file to go with Donald -% Arseneau's url.sty to perform some of the functions that we use the -% \FAQverb stuff in the UK TUG FAQ for -% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -\begin{filecontents}{ctandir.sty} -% -% Experimental CTAN location information macros for use with Donald -% Arseneau's |url.sty| -% -% we need url.sty; we can rely on it to demand anything it needs of -% LaTeX -\IfFileExists{url.sty}% - {\RequirePackage{url}}% - {\PackageWarning{ctandir}{You should acquire a copy of url.sty}% - \newcommand\urldef[3]{\def#1{\texttt{#3}}}% - \let\url\texttt - } -% -\newcommand\CTANdirectory[1]{\expandafter\urldef - \csname CTAN@#1\endcsname\path} -\newcommand\CTANfile[1]{\expandafter\urldef - \csname CTAN@#1\endcsname\path} -% -% Use the standard label-referencing mechanism to get the warning for -% an undefined label -\newcommand\CTANref[1]{\expandafter\@setref\csname CTAN@#1\endcsname - \relax{#1}} -\end{filecontents} -% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -\listfiles -\setcounter{errorcontextlines}{999} -\documentclass[harvardcite,final]{ltugboat} -\usepackage{ctandir} -\IfFileExists{booktabs.sty}% - {\usepackage{booktabs}}% - {\let\midrule\hline} -% -% only tell me important overfulls, please -\hfuzz=2pt -% -% define CTAN addresses using the commands of the |ctandir| package -\CTANdirectory{bibextract}{biblio/bibtex/utils/bibextract} -\CTANdirectory{mflogo}{macros/latex/contrib/mflogo} -\CTANdirectory{moreverb}{macros/latex/contrib/moreverb} -\CTANdirectory{packages}{macros/latex/required} -\CTANdirectory{tools}{macros/latex/required/tools} -\CTANdirectory{tub-latex}{macros/latex/contrib/tugboat} -\CTANdirectory{hyperref}{macros/latex/contrib/hyperref} -% -\CTANfile{cite}{macros/latex/contrib/cite/cite.sty} -\CTANfile{tub-biblio}{digests/tugboat/biblio/tugboat.bib} -\CTANfile{url}{macros/latex/contrib/misc/url.sty} -% -% commands that would be defined by changebar if we were using it: -\providecommand\cbstart{} -\providecommand\cbend{} -% -% this isn't really all that much of a `proof' copy -\NoBlackBoxes -% -% ***** Commands provided by this paper ***** -% -% Typeset the name of an environment, class, package, option, program -\providecommand\envname[1]{\textsf{#1}} -\providecommand\clsname[1]{\textsf{#1}} -\providecommand\pkgname[1]{\textsf{#1}} -\providecommand\optname[1]{\textsf{#1}} -\providecommand\progname[1]{\textsf{#1}} -% -% A list of options for a package/class -\newenvironment{optlist}{\begin{description}% - \renewcommand\makelabel[1]{% - \descriptionlabel{\mdseries\optname{##1}}}% - \itemsep0.25\itemsep}% - {\end{description}} -% -% A list of command names (using \mdwcmd, which as its name implies -% comes from the work of Mark Wooding) -\newenvironment{cmdlist}{\begin{description}% - \renewcommand\makelabel[1]{% - \descriptionlabel{\mdseries\mdwcmd##1}}% - \itemsep0.25\itemsep}% - {\end{description}} -% -\makeatletter -\providecommand{\mdwcmd}[1]{% - \expandafter\texttt\expandafter{\string#1}% - \mdwcmd@i} -\def\mdwcmd@i{\futurelet\@let@token\mdwcmd@ii} -\def\mdwcmd@ii{% - \let\@tempa\relax% - \ifx\@let@token\bgroup% - \def\@tempa##1{\texttt{\char`\{}\textit{##1}\texttt{\char`\}}\mdwcmd@i}% - \fi% - \ifx\@let@token[% - \def\@tempa[##1]{\texttt{[}\textit{##1}\texttt{]}\mdwcmd@i}% - \fi% - \@tempa% -} -\makeatother -% -% for raggedy-footnotes (necessary for CTAN references, I find) -\newcommand\raggedfoot{\rightskip=\raggedskip plus\raggedstretch\relax} -% -% To use umlauts in a bibliography entry in BibTeX 0.99, we have to -% use a certain amount of subterfuge... -\let\umlaut\" -% -%%%%%%%%%%%%%%%% -\begin{document} -%%%%%%%%%%%%%%%% -% -\title{The \LaTeXe\ \TUB{} Macros} -\author{Robin Fairbairns} -\address{University of Cambridge Computer Laboratory\\ - William Gates Building\\ - J J Thomson Avenue,\\ - Cambridge CB3 0FD,\\ - UK} -\netaddress{rf@cl.cam.ac.uk} -\personalURL{http://www.cl.cam.ac.uk/users/rf/robin.html} -\maketitle - -\section{Introduction} - -This note reports on a new set of macros for use by \TUB{} authors. -The macros represent a development of the earlier \clsname{ltugboat} and -\clsname{ltugproc} styles that were written for use with \LaTeX~2.09. The -development was started by others than I, notably Sebastian Rahtz, -Michel Goossens, Nico Poppelier and Johannes Braams; I have been -assisted in my work both directly and indirectly by many others, -including Barbara Beeton, Mimi Burbank and (of course) the \LaTeX3 -team. - -The ultimate aim of the work is to provide a single production -environment for the whole of \TUB{}. That aim has not (yet) been -achieved, though it is still believed to be achievable for a -significant proportion of papers.\footnote{\TUB{} will continue to -accept papers written using the `plain' macros; it's probably -fanciful to hope that \emph{every} paper can be moulded into use -within \LaTeX.} - -\section{Availability} - -\begin{sloppypar} - The macros are released for general use, and are distributed via - \CTAN{}\footnote{\raggedfoot From directory \CTANref{tub-latex}} in the usual - \LaTeX{} way as files \path|tugboat.dtx| and \path|tugboat.ins|. - When the\,\verb|.ins| file is processed by \LaTeX{}, the files - \path|ltugboat.cls|, \path|ltugproc.cls| and \path|ltugbib.bst| (for - ordinary production work) and \path|ltugcomn.sty| (a cooking pot of - useful macros, for documentation, etc.)\ are produced. The\,\verb|.dtx| - file may itself be processed by \LaTeX{} to produce a formatted - (somewhat `literate') source listing for those who feel they need - more detailed description of the macros than is offered in the - 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 -\TUB{}\Dash her business is to produce the text that the editor is to -mould into the body of an issue. - -However, any modern author wants to be able to view the progress of -her efforts; for this, she needs to use the \TUB{} class -\path|ltugboat.cls|\Dash it defines the way an article in a normal issue of -\TUB{} will appear, and is therefore a useful aid. - -Similarly, one submitting a paper for presentation at an annual \tug{} -conference may use the \path|ltugproc.cls|, which will set the paper as it -should appear in a proceedings issue of \TUB{}. - -Each paper, therefore, is written as a document that may stand on its -own. It starts with a \cs{documentclass} command, and its body is -enclosed in a \envname{document} environment. Each of the document -classes specifies a set of options, described in the next two -subsections (\ref{sec:boat-opts} and~\ref{sec:proc-opts}). In the -ordinary course of events the author needn't bother with any of these -options, since the defaults are designed for creating proof copies of -papers. - -Since the author typesets her paper in a `proof mode', the paper's -published appearance will differ from its appearance at the time of -submission. The changes required in this process are the -responsibility of the \TUB{} production team, and the author need not -be concerned with them. - -\subsection{Class options: the \clsname{ltugboat} class} -\label{sec:boat-opts} - -The \clsname{ltugboat} class accepts all the options of the -\clsname{article} class (though it suppresses the font-size selection, -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. -\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. -\item[harvardcite] Specify Harvard-style citation; see - section~\ref{sec:biblio}. -\item[noextralabel] Don't use the extra label-distinguishing mark in - the body of the reference; see section~\ref{sec:biblio}. -\item[nonumber] Sections are not to be numbered; section heading - layout is to be as in the `plain' \pkgname{tugboat} styles. -\item[numbersec] Sections, subsections and subsubsections are to be - numbered (this is the default setting\Dash the author need not - explicitly set it). -\item[preprint] Set up for a preprint. - -\item[rawcite] Specify default (unnumbered) citation; see - section~\ref{sec:biblio}. -\end{optlist} - -\subsection{Class options: the \clsname{ltugproc} class} -\label{sec:proc-opts} - -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 \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 -%% \newcount\y -%% \y\year -%% \divide\y100 -%% \multiply\y100 -%% \advance\y-\year -%% \y-\y -% -% from 2000 on, the option is just the year -\optname{tug\number\year}. Such an option may be necessary if the -(detailed) type design of papers for the year's proceedings issue is -changed by the year's editor. Unless ``instructions to authors'' -say otherwise, authors should not specify such an option, and -\clsname{ltugproc} will choose an appropriate default. - -The class reads a configuration file -\path|ltugproc.cfg|, in which you may specify the year by a command of -the form: -\begin{verbatim}[\small] - \newcommand{\tugProcYear}{97} -\end{verbatim} - -The class deals with two-digit year selections for conferences up to -2069 (which date was chosen entirely at random, uninfluenced, of -course, by the Unix\texttrademark Epoch\dots); however, the user -should not feel constrained to write such confusing dates since -\clsname{ltugproc} will cope with the full year number (4 digits, for -quite a while yet). - -\section{Command syntax} -\label{sec:syntax} - -We would have liked to offer perfectly uniform syntax for people to -use when preparing their papers. Unfortunately, uniform syntax is not -available with any widely-available set of macros (though see, for -example, the discussions in \citeNP{Ogawa:TB15-3-325}, -\citeNP{Baxter:TB15-3-331}, and \citeNP{Swift:TB16-3-269}). In the -circumstances, we have sought simply to keep to the spirit of -Lamport's \citeyear{Lamport:1994}, as modified\footnote{The cited - edition of Lamport's book documents the modified version of \LaTeX{}, - but it's worth emphasising that we use the modified version as the - reference.} by the \LaTeXe{} work (see, for example, -\citeNP{Rowley:TB15-1-63}). - -In the few cases that it has proved possible to emulate (what seems to -a staid old \LaTeX{} programmer, such as the present author) the gay -abandon of the syntax of the `plain' \pkgname{tugboat} styles -\cite{Whitney:TB10-3-378}, we have done. Nevertheless, on the whole, -the new \clsname{ltugboat} macros simply define \LaTeX{} commands and -environments, or modify the definitions of \LaTeX{} `standard' -commands. Section~\ref{sec:equiv} lists equivalences between macros -defined by the `plain' package and those defined by the new package. - -The `down' side of this decision is, of course, the `welter of -\LaTeX{} braces' that Barbara Beeton has been heard to complain of in -production team discussions. One has to hope that the (near) -uniformity of syntax offers those who think like Barbara some small -recompense! - -\section{Divisions of the paper} -\label{sec:divs-paper} - -Papers in \TUB{} may be subdivided in the normal way of a \LaTeX{} -article (the classes are defined in terms of \LaTeX{}'s -\clsname{article} class). Thus the author may use \cs{section}, -\cs{subsection}, \dots, \cs{paragraph} commands (but \cs{part} and -\cs{subparagraph} from \clsname{article} are suppressed, and -\cs{chapter}, which doesn't even appear in the parent class, receives -the same treatment). - -Authors should note that the style of ordinary issues of \TUB{} makes -no distinction between the titles of the divisions; the visual style -relies on the section numbers to indicate where the divisions lie in -the hierarchy. As a result, the un-numbered `\verb|*|' forms of the -\cs{section}, etc., commands, are inappropriate. The -\clsname{ltugboat} class therefore warns the author who (possibly -inadvertently) uses one of these forms. (The author who wishes to use -un-numbered sections throughout her paper may use the -\optname{nonumber} class option (see~\ref{sec:boat-opts}). - -By contrast, whether or not sections are numbered in a conference -proceedings issues of \TUB{} is a matter of that year's editor's -choice (in collaboration with the \TUB{} team). If sections are not -to be numbered, the use of `\texttt{*}' forms is inappropriate, and the -class equally warns the author. Since the sections don't have -numbers, references to section numbers don't work; they therefore -(once they're resolved) warn the author of potential problems. - -Reference may, however, be made to the `title' of divisions of the -paper, whether they are numbered or not. The \cs{nameref} command -(which uses the technique developed for the \textsf{hyperref} package -\cite{Rahtz:hyperref:1997}) permits such references; for example, the -present section was introduced by: -\begin{verbatim}[\small] - \section{Divisions of the paper} - \label{sec:divs-paper} -\end{verbatim} -and the command \verb|\nameref{sec:divs-paper}| produces -`\nameref{sec:divs-paper}'. - -\subsection{Abstracts} - -The classes make provision for abstracts, but the provision is -different for the two classes. - -The \clsname{ltugboat} class provides two environments, \envname{abstract} -and \envname{longabstract}. The \envname{abstract} environment simply -typesets its body as an un-numbered section whose title is -`Abstract'. The \envname{longabstract} environment typesets its body in -small text, and separates the abstract from the rest of the paper with -a decorative line. - -The \clsname{ltugproc} class typesets abstracts as part of the title -of the paper, below the names and addresses of the authors, but before -the main body of the paper. Therefore, for proceedings articles, the -\envname{abstract} environment must appear in the source of the paper -\emph{before} the \cs{maketitle} command (it may even appear before -\verb"\begin{document}", if the author so chooses). - -\subsection{Appendices} - -A paper may have appendices, which are expressed in exactly the same -way as they would be in the \LaTeX{} article class: - -\begin{verbatim}[\small] -\appendix -\section{This is appendix A} -... -\section{This is appendix B} -\end{verbatim} -Which will produce `section' headings similar to: -\begin{quote} -\textbf{A\quad This is appendix A} -\end{quote} - -\TUB{} articles may have a small extension to this format: this -extension was originally developed for proceedings issues, but is also -available in normal issues: - -\begin{verbatim}[\small] -\begin{appendix} -\section{This is the first one} -... -\end{appendix} -\end{verbatim} -Which will produce `section' headings similar to: -\begin{quote} -\textbf{Appendix A\quad This is the first one} -\end{quote} - -In both cases, the subsections are numbered as normal (i.e., as -`A.\ensuremath{n}' in normal \TUB{} papers, and not at all in -proceedings classes). - -\section{Titles, addresses and so on} - -The title and author(s) of a paper are quoted using commands that are -familiar (in syntax, at least) to most \LaTeX{} users; the \cs{title} -command is exactly that used in the standard \LaTeX{} classes. - -The \cs{author} command is used once for each co-author of the paper, -and for each \cs{author} there should be a \cs{address} command that -gives a (postal) correspondence address. In addition (wherever -possible), \TUB{} likes to quote an email address for authors: for -this, the \cs{netaddress} command is used. Finally, each -author may advertise a `home' Web page, using a \cs{personalURL} command. - -For example, the present paper has at its start: - -\begin{verbatim}[\small] -\title{The New (\LaTeXe) \TUB{} Macros} -\author{Robin Fairbairns} -\address{University of Cambridge - Computer Laboratory\\ - Pembroke Street,\\ - Cambridge, CB2 3QG,\\ - UK} -\netaddress{rf@cl.cam.ac.uk} -\personalURL{http://www.cl.cam.ac.uk/...} -\maketitle -\end{verbatim} - -Since this paper is prepared for a normal issue of \TUB{} and -therefore uses the \clsname{ltugboat} class, the \cs{maketitle} merely -typesets the title of the paper and the author's name. The -address(es) are typeset at the end of the paper where the author gives -a \cs{makesignature} command. - -The \clsname{ltugproc} class typesets all the information about the -author at the head of the paper, when the \cs{maketitle} is given; -this class disallows the \cs{makesignature} command. - -Note that the author had a problem typesetting the above example -verbatim: the lines are too long. If the information being given is -to be typeset as ordinary text (as in the case of the \cs{address} -line above), it can be `wrapped' perfectly happily, as in normal text. -If one of the verbatim items (\cs{netaddress} or \cs{personalURL} -commands) is going to be too wide for the column, what is the author -to do? (Abbreviating the text, as in the \cs{personalURL} above, is -\emph{not} usually an acceptable option!) Unfortunately, the \verb|%| -sign is an entirely acceptable element of both email addresses and -\acro{URL}s, so that the normal `fall-back' isn't available. -Therefore, the classes typeset these electronic addresses in an -environment where some of the characters (notably `\verb|.|' and -`\verb|/|') are treated as word-divisions for the purposes of laying -out the line. This is visible in the case of my personal \acro{URL}, -in the signature block at the end of the present paper. - -If the paper is the result of more than one author's labours, a sequence of -\cs{author}, \cs{address}, \cs{netaddress} and \cs{personalURL} -commands may be given, as in the following, which comes from a paper -given at \tug'95 (slightly edited): - -\begin{verbatim}[\small] -\author{Michel Goossens} -\address{CN Division, CERN\\ - ...} -\netaddress{...} - -\author{Sebastian Rahtz} -\address{Elsevier Science Ltd\\ - ...} -\netaddress{...} - -\author{Robin Fairbairns} -\address{University of Cambridge - Computer Laboratory\\ - ...} -\netaddress{...} -\personalURL{...} -\end{verbatim} - -The class files will take care of arranging author names and addresses -between the \cs{maketitle} and (possibly) \cs{makesignature} commands. - -\subsection{Compilation articles} - -\begin{sloppypar} - Compilation articles are built from a set of contributed parts, and - 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 - 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} - command, which is an analogue of the \cs{author} command; - contributors' \cs{address}, \cs{netaddress} or \cs{personalURL}. - The \cs{contributor} command opens a group in which the contribution - appears, and the contributor's signature (produced with a - \cs{makesignature} command) closes the group. The general scheme - looks like: -\end{sloppypar} -\begin{verbatim}[\small\makeescape\|\makebgroup\[\makeegroup\]] -\title{Example compilation article} -\author{Robin Fairbairns} -\address{University of Cambridge ...} -\netaddress{...} - ... - |emph[introductory text] - ... -\makesignature - -\contributor{Betsy the Dog} -\address{Romsey Town, Cambridge} - ... - |emph[Betsy's contribution] - ... -\makesignature - -... -\end{verbatim} - -\section{Verbatim text} -\label{sec:verbatim} - -The classes do not at present provide the same wide range of -facilities as the `plain' \pkgname{tugboat} style -\cite{Whitney:TB10-3-378}; the author had hoped to `borrow' facilities -from a package which is believed to be in development, but in the -event that package has not materialised. - -For in-line verbatim text, authors should ordinarily employ the -facilities of \LaTeX{} itself (the \cs{verb} macro). This macro, of -course, is highly restricted as to its usage (primarily, that it may -not appear in the argument of \emph{any} other macro, even -\cs{footnote}). - -For `display verbatim' (to employ the term used by -\citeANP{Whitney:TB10-3-378}), the classes add a small increment to -the functionality of \LaTeX{}'s \envname{verbatim} environment, by -introducing an optional argument. The optional argument may contain -commands to be executed before starting the verbatim text; the set of -commands which have useful effect is strictly limited, but the -following are commonly used: -\begin{itemize} -\itemsep=0.2\itemsep -\item Font size selection commands: for example, all the display - verbatim in the present paper starts with: - - {\small\verb| \begin{verbatim}[\small]|} -\item The command \cs{ruled}, which is available \emph{only} in - \envname{verbatim}'s optional argument, and specifies that a - column-wide rule should be drawn before and after the verbatim text -\item One of the \cs{make*} commands,\footnote{\cs{makeescape}, - \cs{makebgroup}, \dots, \cs{makecomment}; used, for example, as - \cs{makeescape}\cs{|}} which change the category code of - characters within the verbatim text. This is (of course) a facility - that should only be used with the utmost caution, but it can, for - example, be employed to provide interesting effects by knowledgeable - authors. -\end{itemize} -Two caveats about the use of this facility should be noted: -\begin{itemize} -\itemsep=0.2\itemsep -\item The search for the optional argument can be confused by the - appearance of a \verb|[| character as the first of the displayed - verbatim. An author who wishes to start verbatim text with a - \verb|[| character should provide an empty optional argument (i.e., - simply `\verb|[]|') to the \envname{verbatim} environment. -\item The facility is lost when certain packages are loaded. An - example is the \pkgname{verbatim} package - \cite{Schoepf:verbatim:1996}, which redefines the \envname{verbatim} - environment in its entirety. Of course, any package that loads - \pkgname{verbatim} (such as \pkgname{moreverb}, - \shortciteNP{Duggan:moreverb:1996}) will necessarily have the same - effect. (It should be noted that \pkgname{verbatim} and - \pkgname{moreverb} provide some of the facilities that are available - in the `plain' \pkgname{tugboat} styles, so that an author could - reasonably be tempted to use them. There is no objection in - principle to authors using these packages.) -\end{itemize} - -\section{Floating inserts} - -The classes do not make any change to \LaTeX{}'s built-in provision -for floating inserts, so that authors may generate figures and tables -just as they would in any `normal' \LaTeX{} document. Figure and -table captions, and labels referring to them, are also substantially -untouched. - -However, since both classes typeset in two columns, authors must -distinguish between the \envname{figure} and \envname{table} environments -(which produce floats that are the same width as the column) and the -\envname{figure*} and \envname{table*} (which produce floats that are the same -width as the page). - -%\begin{itemize} -%\item figures and tables as normal -%\item captions and labels work whatever (i.e., no restriction on -% numbering) -%\item twocolumn setting implies distinction between \envname{figure} and -% \envname{figure*} -%\end{itemize} - -\section{Special-purpose typesetting} - -The classes define a rather large set of commands for special-purpose -typesetting. Some of them are available for historical reasons only, -and many are only useful in somewhat restricted circumstances. For -this reason, the present paper only outlines a representative, small -set of the macros. - -\subsection{Acronyms and logos} - -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}. 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{A few of the classes' acronyms and logos} - \label{fig:acro-logo} -\end{figure} - -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} - -A small list of special typesetting commands follows: a large set of -such commands is defined in the classes, but the list covers most of -the `everyday' ones. -\begin{cmdlist} -\item[\cs{cmd}] Typeset a control sequence name. (The command - \verb|\cs{fred}| is typeset as \cs{fred}.) -\item[\env{environment}] Typeset an environment name as if at the - start of the environment. (The command \verb|\env{fred}| is typeset - as \env{fred}.) -\item[\meta{arg}] Typeset a formal argument name. (The command - \verb|\meta{fred}| is typeset as \meta{fred}.) -\item[\Dash] Typeset an em-dash, surrounded by thin spa\-ces, only - breakable \emph{after} the dash; this is the preferred method of - specifying a dash in running text. -\item[\dash] Typeset an en-dash, in the same way as \cs{Dash} does. -\item[\nth{n}] Typeset an ordinal number. For example, \verb|\nth{1}| is - set as \nth{1}, \verb|\nth{27}| is set as \nth{27}, and so on. -\item[\sfrac{num}{denom}] Typeset a fraction to match running text; - for example \verb|\sfrac{3}{4}| is set as \sfrac{3}{4}\,. -\end{cmdlist} - -\section{Use of packages} - -In general, the \TUB{} team will be sympathetic to authors who wish to -use non-standard packages in their papers; indeed, in a journal -devoted to the usage of \TeX{}, the editor would be churlish indeed to -refuse such usage. However, the team does need to be able to process -the paper on the \TUB{} production computers, and the author who is -slapdash about the way she submits her paper will cause confusion and -delay. (Remember that the editorial team is a group of volunteers, -each working in his or her spare time.) - -In general, packages currently on \CTAN, and known to work with -\emph{current} \LaTeX{},\footnote{The team's version of \LaTeX{} is - regularly updated, though not during the course of a production - run.} are unlikely to give problems. - -In particular, the team is happy to accept papers using packages -that are supported by members of the \LaTeX3 team,\footnote{%\raggedfoot - Those in the \LaTeX{} base distribution, or one of those on the - \CTANref{packages} sub-tree on \CTAN.} subject to the two provisos: -\begin{itemize} -\itemsep=0.2\itemsep -\item Use of the \pkgname{verbatim} package has implications for the - \envname{verbatim} facilities provided by the classes\Dash see - section~\ref{sec:verbatim}. -\item Use of \pkgname{babel} almost inevitably implies use of - hyphenation patterns that the team may not have installed in their - \LaTeX{} format; it is therefore important that the author explains - her \pkgname{babel} configuration to the editorial team. The - minimum documentation required is a copy of the author's - \url{language.dat} file, and copies (or \CTAN{} pointers to) any - hyphenation files used. -\end{itemize} - -Usage of other packages should always be subject to negotiation with -the team. If the team does not have access to a copy of the package, -life is going to be very difficult; authors are urged to be sensible -in this regard. A sensible mechanism for submitting -out-of-the-ordinary packages (as for paper-specific bibliographies) is -by use of the \envname{filecontents} environment. - -\cbstart -\tug{} has a policy that macro packages described in \TUB{} should be -available for readers to use. Since typing macros from printed -sources is such an error-prone undertaking, authors of publicly -available packages are urged to submit their macros to the \CTAN{} -archives. If a package is only available under restricted terms, -authors are urged to make this fact clear when first submitting an -article to the editor. -\cbend - -Some facilities are considered inappropriate to delivery by the -\TUB{} classes, and as a result, the \TUB{} team recommend certain -packages to authors. - -At present, the list of recommended packages consists of only two, -\path|mflogo.sty| \cite{Vieth:mflogo:1995} and \path|url.sty| -\cite{Arseneau:url:1996}. - -Both classes will load the \pkgname{mflogo} package if it is present on the -author's system; if the package is not present, the classes will -emulate its more important features; the package defines \MF{} and -\MP{} logos using recent versions of Knuth's \verb|logo10| font family. - -The \pkgname{url} package is useful when one is typesetting significant -numbers of file names, network addresses or \acro{URL}s; it is being -used in the present paper (not least in the bibliography). - -\section{Bibliography} -\label{sec:biblio} - -Bibliographic citations give much grief to the editorial team. Good -publishing practice requires that there be editorial control of the -way citations in a journal are presented yet, all too often, authors -submit articles whose bibliography is formatted according to their -preference. The important rules for authors, then, are that they -\emph{shouldn't} supply a \verb|.bbl| file (\BibTeX{} processed output), -and that they \emph{shouldn't} write out a \envname{thebibliography} -environment, but should rather submit a working \verb|.bib| file with their -paper.\footnote{The program \progname{bibextract}, available from - \CTAN{} in directory \CTANref{bibextract}, provides a convenient - mechanism for extracting just the relevant portions of your - bibliography database for submitting your paper; many of the common - \BibTeX{}-database management packages, such as \textsc{BibDB} or - \textsc{Bib}Tools offer similar facilities.} As with uncommon -packages, the \envname{filecontents} environment is a convenient way to -deliver the bibliography file. - -A special case is made of the accumulated bibliography of \TUB{} -itself;\footnote{\raggedfoot Available on \CTAN{} as - \CTANref{tub-biblio}} it is always available to the production team, -so that authors may make reference to items from that \verb|.bib| file -without further ado. - -Two citation styles are supported within \TUB{} articles, `\emph{raw}' -and `\emph{harvard}' (the present article is employing \emph{harvard} -citation). The raw citation style uses the `standard' -\BibTeX{} `\pkgname{plain}' (numeric) citation style; its modification -by use of Donald Arseneau's \pkgname{cite} -package\footnote{\raggedfoot Available on \CTAN{} as \CTANref{cite}} -is acceptable. Raw citation is selected by default (by execution of -class option \optname{rawcite}). - -Harvard citation may be selected by specifying \optname{harvardcite} as an -option of the \cs{documentclass} command. The macros used derive -pretty directly from the \textsl{\pkgname{harvard}} styles written by Glenn -Paulley and now maintained by Peter Williams; the \BibTeX{} style -derives from one developed by Patrick Daly. - -The basic citation format is `author-year', but the macros are capable -of many variations: this in turn places somewhat of a load on the -author to use the correct citation macro. The macros available are -shown in figure~\ref{fig:citation-macros}; the figure assumes an entry -in the bibliography with authors Tom, Dick, and~Harry, and with a -1990 date. - -\begin{figure}[htbp!] - \begin{center} - \leavevmode - \begin{tabular}{@{}ll@{}}% @{ $\rightarrow$ } between columns removed - \small\textsf{\textsl{Macro}} &\small\textsf{\textsl{Output}}\\ - \midrule - \verb|\cite{key}| & (Tom, Dick, and Harry, 1990)\\ - \verb|\citeA{key}| & (Tom, Dick, and Harry)\\ - \verb|\citeNP{key}| & Tom, Dick, and Harry, 1990\\ - \verb|\citeANP{key}| & Tom, Dick, and Harry\\ - \verb|\citeN{key}| & Tom, Dick, and Harry (1990)\\ - \verb|\shortcite{key}| & (Tom et al., 1990)\\ - & [also has \texttt{A} and \texttt{NP} - variants]\\ - \verb|\citeyear{key}| & (1990)\\ - & [also has an \texttt{NP} variant] - \end{tabular} - \end{center} - \caption{The range of citations in \optname{harvard} style} - \label{fig:citation-macros} -\end{figure} - -Note that, if Tom, Dick, and Harry are a prolific team, there can -easily be more than one reference to their work in one year. In such -a case, the citations will be (Tom, Dick, and Harry, 1990a), (Tom, -Dick, and Harry, 1990b), and so on. These extra `a', `b', etc., tags -may also appear in the references section of the paper, attached to -the year recorded for the reference: whether this indeed happens is -controlled by the \optname{extralabel} and \optname{noextralabel} class -options. The default state (option \optname{extralabel}) attaches the -extra characters. - -Bibliographies provide further problems because they're notoriously -difficult to typeset at the best of times. \LaTeX{} sets \cs{sloppy} -when typesetting the bibliography, but this can often lead to pretty -unpleasant output in the narrow columns typical of \TUB{}. The author -may control the typesetting using the command -\cs{SetBibJustification}. The classes set \cs{sloppy}, by default -(just like \LaTeX{}), but the author may (for example) say: -\begin{verbatim} - \SetBibJustification{\raggedright} -\end{verbatim} -as the present article does, to achieve somewhat better results. - -\section{Equivalences between the `plain' and the \LaTeX{} packages} -\label{sec:equiv} - -A good proportion of the commands in the `plain' packages also appear -(with the same meaning) in the \LaTeX{} classes. -Figure~\ref{fig:plain-equiv} gives a brief summary of where the macros -differ significantly. - -\begin{figure}[htbp] - \begin{center} - \leavevmode - \begin{tabular}{@{}ll@{}} - \small\textsf{Plain macro} & \small\textsf{\LaTeX{} macro} \\ - \midrule - \cs{head} & \cs{section} \\ - \cs{subhead} & \cs{subsection} \\ - \cs{subsubhead} & \cs{subsubsection} \\ - \cs{list} & \envname{itemize}, \envname{enumerate}, etc., \\ - & environments \\ - \cs{verbatim} & \envname{verbatim} or \cs{verb} \\ - \cs{figure} & \envname{figure} or \envname{figure*} environments \\ - \end{tabular} - \end{center} - \caption{Equivalences between \pkgname{plain} and \LaTeX{} macros} - \label{fig:plain-equiv} -\end{figure} - -\LaTeX{} itself makes comprehensive provision for lists; the \TUB{} -classes make no attempt to emulate the list facilities of the `plain' -macros. - -The `plain' styles' provision for verbatim text is also somewhat -different from the \LaTeX{} approach; the \TUB{} classes offer a small -subset of the extra facilities that the `plain' styles provide; for -more elaborate facilities, the user is referred to the -\pkgname{verbatim} and \pkgname{moreverb} packages (see -section~\ref{sec:verbatim}). - -Of course, the syntax of commands given to the \LaTeX{} classes is -different (as discussed in section~\ref{sec:syntax}); arguments are -(almost always) enclosed in braces, and neither of the forms of -argument provision promulgated by the `plain' macros -(\cs{macro}\meta{argument}\linebreak[0]\cs{endmacro} and -\cs{macro * }\meta{argument}\verb| *|) are provided by the \LaTeX{} -classes. - -%\EdNote[Should I mention the lack of \cs{every*} token registers (for -%all sorts of instances of \texttt{*}?)] - -\SetBibJustification{\raggedright} -\bibliography{tubguide} - -\makesignature - -\end{document} diff --git a/Master/texmf-dist/source/latex/tugboat/tugboat.dtx b/Master/texmf-dist/source/latex/tugboat/tugboat.dtx index 009487a7c21..3f7934a9205 100644 --- a/Master/texmf-dist/source/latex/tugboat/tugboat.dtx +++ b/Master/texmf-dist/source/latex/tugboat/tugboat.dtx @@ -1,32 +1,22 @@ %^^A This (the production version of the macros) started life as xpt3 %^^A and no need has arisen to perform other experiments... -% tugboat.dtx - main source for LaTeX TUGboat classes. -% +% % \iffalse (this is a meta-comment (so they say)) -%% Copyright 1994,1995,1996,1997,1998,2000,2001,2004,2005,2006,2007,2008 -%% 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. +% tugboat.dtx - main source for LaTeX TUGboat classes. +% +% Copyright 1994,1995,1996,1997,1998,2000,2001,2004,2005,2006,2007,2008,2009 +% 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. +% % \fi % % \section{Document preambles} @@ -41,7 +31,7 @@ %<ltugboatsty>\ProvidesPackage{ltugboat} %<ltugprocsty>\ProvidesPackage{ltugproc} %<ltugcomn> \ProvidesPackage{ltugcomn} - [2007/09/19 v2.4b + [2009/06/21 v2.6 %<ltugboatcls> TUGboat journal class% %<ltugproccls> TUG conference proceedings class% %<ltugboatsty|ltugprocsty> TUG compatibility package% @@ -129,23 +119,24 @@ % \end{macrocode} % % \fi -% \CheckSum{4500} +% \CheckSum{4638} % % \section{Introduction} % % This file contains all the macros for typesetting \TUB{} with % both plain \TeX\ and \LaTeXe. % \subsection{Summary of control sequences} -% +% % Abbreviations. Just a listing with indications of expansion where % that may not be obvious. For full definitions, see real code below % (Section~\ref{abbr-logo}). -% +% % \begin{longtable}{lp{3in}} % |\AllTeX|& (\La)\TeX\\ % |\AMS|& American Mathematical Society\\ % |\AmSTeX|&\\ % |\aw|& \aw\ (abbreviation for Addison-Wesley)\\ +% |\API|&\\ % |\AW|& Addison-Wesley\\ % |\BibTeX|&\\ % |\CandT|& Computers \& Typesetting\\ @@ -156,7 +147,10 @@ % |\DVD|&\\ % |\DVIPDFMx|& \DVIPDFMx\\ % |\DVItoVDU|& DVItoVDU\\ +% |\ECMA|&\\ +% |\EPS|&\\ % |\eTeX|& \eTeX\\ +% |\ExTeX|& \ExTeX\\ % |\Ghostscript|&\\ % |\Hawaii|& \Hawaii\\ % |\HTML|&\\ @@ -166,6 +160,7 @@ % |\JTeX|&\\ % |\JoT|& The Joy of \TeX\\ % |\LaTeX|&\\ +% |\LyX|&\\ % |\MacOSX|& Mac OS X\\ % |\MathML|&\\ % |\Mc|& M with raised c\\ @@ -177,6 +172,7 @@ % in maths)\\ % |\OMEGA|& Omega `logo' (\ensuremath{\Omega})\\ % |\OCP|& Omega compiled process\\ +% |\OOXML|&\\ % |\OTP|& Omega translation process\\ % |\mtex|& multilingual \TeX\\ % |\NTS|& New Typesetting System\\ @@ -211,6 +207,7 @@ % |\UNIX|&\\ % |\UTF|&\\ % |\VAX|&\\ +% |\VnTeX|&\\ % |\VorTeX|&\\ % |\XeT|&\\ % |\XeTeX|& reflected and lowered first `E'\\ @@ -218,6 +215,7 @@ % |\XML|&\\ % |\WEB|&\\ % |\WEAVE|&\\ +% |\WYSIWYG|&\\ % \end{longtable} % % Macros for things that are slightly more significant. @@ -290,7 +288,7 @@ % |\revpubinfo|& with one argument, other info pertaining to \ldots \\ % |\endreviewitem|& end data for item being reviewed\\ % |\booktitle|& with one argument, format book title in text\\ -% |\Input|& |\input| with some other bookkeeping for +% |\Input|& |\input| with some other bookkeeping for % case where multiple articles are put together\\ % |\TBremark|& reminder to \TUB{} editorial staff\\ % |\TBEnableRemarks|& enable \cs{TBremark}s (normally suppressed)\\ @@ -317,7 +315,7 @@ % % \subsection{Setup and options} % -% Check for reloading. Hmmm\dots Does this happen with \LaTeXe +% Check for reloading. Hmmm\dots Does this happen with \LaTeXe\ % classes? Probably, in fact, as well that it doesn't, since the % \cs{tugstyinit} referenced here doesn't exist; however, it's % possible that we might need a similar mechanism in the future, so we @@ -437,6 +435,15 @@ \DeclareOption{nonumber}{\let\if@numbersec\iffalse} % \end{macrocode} % +% Minimal running headers/footers contain just the TUGboat volume/issue +% identification and page number. `runningfull' is the default, and +% includes title and author. +% +% \begin{macrocode} +\DeclareOption{runningminimal}{\AtEndOfClass{\@tubrunningminimal}} +\DeclareOption{runningfull}{\AtEndOfClass{\@tubrunningfull}} +% \end{macrocode} +% % Any other options, we pass on to |article.cls| before we load it: % % \begin{macrocode} @@ -444,11 +451,11 @@ % \end{macrocode} % % Request default options (draft mode, standard citation, double-sided -% printing), process all options, and then get the base document class -% on top of which we reside. +% printing, etc.), process all options, and then get the base document +% class on top of which we reside. % % \begin{macrocode} -\ExecuteOptions{draft,extralabel,numbersec,rawcite} +\ExecuteOptions{draft,extralabel,numbersec,rawcite,runningfull} \ProcessOptions \LoadClass[twoside]{article} % \end{macrocode} @@ -524,7 +531,7 @@ % default settings of typesetting parameters, and so on. The user (or % more typically, editor) may execute the commands by using the % command \cs{StartNewPaper}. Things I've not yet thought of may be -% added to the list of commands, by +% added to the list of commands, by % \begin{macrocode} \newtoks\ResetCommands \ResetCommands{% @@ -540,7 +547,7 @@ % \end{macro} % \end{macro} % \end{macro} -% +% % \subsection{Helpful shorthand (common code with Plain styles)} % % \cs{makeescape}, \dots, \cs{makecomment} allow users to change the @@ -629,21 +636,24 @@ \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{Addison\kern.1em-\penalty\z@\hskip\z@skip Wesley} % % make \BibTeX work in slanted contexts too; it's common in titles, and % especially burdensome to hack in .bib files. -\def\BibTeX{% +\def\Bib{% \ifdim \fontdimen1\font>0pt B{\SMC\SMC IB}% \else - \textsc{Bib}\kern-.08em + \textsc{Bib}% \fi - \TeX} +} +\def\BibTeX{\Bib\kern-.08em \TeX} % \def\CandT{\textsl{Computers \& Typesetting}} +\def\CJK{\acro{CJK}} % \end{macrocode} % We place our \cs{kern} after \cs{-} so that it disappears if the % hyphenation is taken: @@ -658,7 +668,11 @@ \def\DVI{\acro{DVI}} \def\DVIPDFMx{\acro{DVIPDFM}$x$} \def\DVItoVDU{DVIto\kern-.12em VDU} +\def\ECMA{\acro{ECMA}} +\def\EPS{\acro{EPS}} \DeclareRobustCommand\eTeX{\ensuremath{\varepsilon}-\kern-.125em\TeX} +\DeclareRobustCommand\ExTeX{% + \ensuremath{\textstyle\varepsilon_{\kern-0.15em\cal{X}}}\kern-.2em\TeX} \def\FAQ{\acro{FAQ}} \def\FTP{\acro{FTP}} \def\Ghostscript{Ghost\-script} @@ -704,6 +718,7 @@ % % \begin{macrocode} %<!latex>\def\LaTeX{\La\kern-.15em\TeX} +\def\LyX{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX} \def\MacOSX{Mac\,\acro{OS\,X}} \def\MathML{Math\acro{ML}} \def\Mc{\setbox\TestBox=\hbox{M}M\vbox @@ -731,6 +746,7 @@ \DeclareTextSymbolDefault{\textohm}{OT1} \newcommand\OMEGA{\textohm} \DeclareRobustCommand{\OCP}{\OMEGA\acro{CP}} +\def\OOXML{\acro{OOXML}} \DeclareRobustCommand{\OTP}{\OMEGA\acro{TP}} \def\mtex{T\kern-.1667em\lower.424ex\hbox{\^E}\kern-.125emX\@} % \end{macrocode} @@ -746,6 +762,7 @@ \def\PiC{P\kern-.12em\lower.5ex\hbox{I}\kern-.075emC\@} \def\PiCTeX{\PiC\kern-.11em\TeX} \def\PGF{\acro{PGF}} +\def\PHP{\acro{PHP}} \def\plain{\texttt{plain}} \def\PNG{\acro{PNG}} \def\POBox{P.\thinspace O.~Box } @@ -757,6 +774,7 @@ \def\SliTeX{\textrm{S\kern-.06em\textsc{l\kern-.035emi}% \kern-.06em\TeX}} \def\slMF{\textsl{\MF}} % should never be used +\def\SQL{\acro{SQL}} \def\stTeX{\textsc{st}\kern-0.13em\TeX} \def\STIX{\acro{STIX}} \def\SVG{\acro{SVG}} @@ -784,20 +802,22 @@ \def\UNIX{\acro{UNIX}} \def\UTF{\acro{UTF}} \def\VAX{V\kern-.12em A\kern-.1em X\@} +\def\VnTeX{V\kern-.03em n\kern-.02em \TeX} \def\VorTeX{V\kern-2.7\p@\lower.5ex\hbox{O\kern-1.4\p@ R}\kern-2.6\p@\TeX} \def\XeT{X\kern-.125em\lower.424ex\hbox{E}\kern-.1667emT\@} \def\XML{\acro{XML}} \def\WEB{\texttt{WEB}\@} \def\WEAVE{\texttt{WEAVE}\@} +\def\WYSIWYG{\acro{WYSIWYG}} % \end{macrocode} -% +% % Xe\TeX{} requires reflecting the first E, hence we complain if the % graphics package is not present. (For plain documents, this can be % loaded via Eplain.) Also, at Barbara's suggestion, if the current % font is slanted, we rotate by 180 instead of reflecting so there is at % least a chance to look ok. (The magic values here seem more or less % ok for \texttt{cmsl} and \texttt{cmti}.) -% +% % \begin{macrocode} \def\tubreflect#1{% \@ifundefined{reflectbox}{% @@ -811,7 +831,7 @@ }% } \def\tubhideheight#1{\setbox0=\hbox{#1}\ht0=0pt \dp0=0pt \box0 } -\def\Xe#1{\leavevmode +\DeclareRobustCommand\Xe[1]{\leavevmode \tubhideheight{\hbox{X% \setbox0=\hbox{\TeX}\setbox1=\hbox{E}% \lower\dp0\hbox{\raise\dp1\hbox{\kern-.125em\tubreflect{E}}}% @@ -1051,9 +1071,10 @@ } \def\bull{\vrule \@height 1ex \@width .8ex \@depth -.2ex } \def\cents{{\rm\raise.2ex\rlap{\kern.05em$\scriptstyle/$}c}} -\def\Dag{\raise .6ex\hbox{$\scriptstyle\dagger$}} \def\careof{\leavevmode\hbox{\raise.75ex\hbox{c}\kern-.15em /\kern-.125em\smash{\lower.3ex\hbox{o}}} \ignorespaces} +\def\Dag{\raise .6ex\hbox{$\scriptstyle\dagger$}} +% \DeclareRobustCommand\sfrac[1]{\@ifnextchar/{\@sfrac{#1}}% {\@sfrac{#1}/}} \def\@sfrac#1/#2{\leavevmode\kern.1em\raise.5ex @@ -1062,11 +1083,21 @@ /\kern-.15em\lower.25ex \hbox{$\m@th\mbox{\fontsize\sf@size\z@ \selectfont#2}$}} +% +% don't stay bold in description items, bold italic is too weird. +\DeclareRobustCommand\meta[1]{% + \ensuremath{\langle}% + \ifmmode \mbox\bgroup \fi % if in math + {\it #1}% no typewriter italics, please + \ifmmode \egroup \fi + \ensuremath{\rangle}% +} +% \DeclareRobustCommand\cs[1]{\texttt{\char`\\#1}} -\DeclareRobustCommand\meta[1]{% don't stay bold in description items - \ensuremath{\langle}{\mdseries\emph{#1}}\ensuremath{\rangle}} +% \DeclareRobustCommand\env[1]{% \cs{begin}\texttt{\char`\{#1\char`\}}} +% \def\thinskip{\hskip 0.16667em\relax} % \end{macrocode} % @@ -1124,6 +1155,12 @@ } % \end{macrocode} % +% One more accent. +% +% \begin{macrocode} +\def\r#1{\accent"17 #1} +% \end{macrocode} +% % \subsection{Reviews} % % Format information on reviewed items for book review articles. @@ -1163,7 +1200,7 @@ % % Starting with volume 23 (nominal 2002), we have \cs{issyear} instead % of \cs{issdate}, because issues don't have months any more. -% +% % For production, these are set in a separate file, % |tugboat.dates|, which is issue-specific. % @@ -1363,7 +1400,7 @@ Mac-OS Ma-la-ya-lam Math-Sci-Net Net-BSD Open-BSD Open-Office Pfa-Edit Post-Script Rich-ard Skoup South-all - Vieth VM-ware Win-Edt + 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 col-umns com-put-able com-put-abil-ity cus-tom-iz-able @@ -1374,7 +1411,7 @@ fall-ing half-way in-fra-struc-ture - key-note + key-note long-est ma-gyar man-u-script man-u-scripts mne-mon-ic mne-mon-ics mono-space mono-spaced @@ -1388,7 +1425,7 @@ sub-ex-pres-sion syn-chro-ni-city syn-chro-nous text-height text-length text-width time-stamp time-stamped - vis-ual vis-ual-ly + vis-ual vis-ual-ly which-ever white-space white-spaces wide-spread wrap-around } %<!latex>\restorecat\@ @@ -1495,7 +1532,7 @@ % % \subsection{Authors, contributors, addresses, signatures} % -% Each article may have several authors (of course), so we permit an +% An article may have several authors (of course), so we permit an % \cs{author} command for each of them. The names are then stored in % a set of \cs{csname}s called \cs{author1}, \cs{author2}, \dots % Similarly, there are several \cs{address<n>} and \cs{netaddress<n>} @@ -1526,7 +1563,7 @@ % \end{macrocode} % % \cs{@getauthorlist} processes the author list, passing every bit of -% stuff that needs to be typeset to its argument. +% stuff that needs to be typeset to the macro specified as its argument. % \begin{macrocode} \def\@getauthorlist#1{% \count@\authornumber @@ -1656,7 +1693,7 @@ \def\signaturemark{\leavevmode\llap{$\diamond$\enspace}} % \end{macrocode} % -% The code used to define the following: +% The code previously defined the following: % % {\small\begin{verbatim} % {\makeactive\@ @@ -1748,7 +1785,7 @@ % \item[\emph{Comment:}] I think this is a fantasy, since everyone (in % practice, nowadays) quotes an internet address. In principle, there % are people who will quote |X.400| addresses (but they're few and far -% between) and I have (during 1995!) seen an address with an |UUCP| +% between) and I have (during 1995!)\ seen an address with an |UUCP| % bang-path component on |comp.text.tex|, but \emph{really}! % \end{description} % @@ -1800,10 +1837,8 @@ % from (1) the lack of the eccentric optional argument, and (2) the % activation of `|/|'. % -% We could imagine needing an \cs{URL} command in general. If so, we -% must remember that the code here would naturally permit a break -% between the last two characters of |http://|, and some sort of -% special action must be taken to ensure that it doesn't happen. +% For general URLs, \texttt{url.sty} (with or without hyperref) suffices +% and is recommended. % % \begin{macrocode} \def\personalURL{\begingroup @@ -1876,7 +1911,7 @@ % that circumstance we need to use a declaration copied from % |latex209.def| rather than the way we would normally do the thing % (using the command \LaTeXe{} defines for the job). -% +% % \begin{macrocode} \if@compatibility \DeclareRobustCommand\net{\normalfont\ttfamily\mathgroup\symtypewriter} @@ -1887,6 +1922,22 @@ \def\@author{\@defaultauthorlist} % \end{macrocode} % +% For the online re-publication (as of 2009) by Mathematical Sciences +% Publishers |http://mathscipub.org|), lots and lots of metadata is +% needed, much of it redundant with things we already do. They are +% flexible enough to allow us to specify it in any reasonable way, so +% let's make one command \cs{mspmetavar} which takes two arguments. +% Example: |\mspmetavar{volumenumber}{30}|. For our purposes, it is +% just a no-op. +% +% \begin{macro}{\mspmetavar} +% \begin{macrocode} +\def\mspmetavar#1#2{} +% \end{macrocode} +% \end{macro} +% +% \subsection{Article title} +% % \begin{macro}{\if@articletitle} % \begin{macro}{\maketitle} % \begin{macro}{\@r@maketitle} @@ -1931,6 +1982,43 @@ % \end{macro} % \end{macro} % +% \begin{macro}{\title} +% \begin{macro}{\TB@title} +% We redefine the \cs{title} command, so as to set the \cs{rhTitle} +% command at the same time. While we're at it, we redefine it to have +% optional arguments for use as `short' versions, thus obviating the +% need for users to use the \cs{shortTitle} command. +% \begin{macrocode} +\def\rhTitle{}% avoid error if no author or title +\renewcommand\title{\@dblarg\TB@title} +\def\TB@title[#1]#2{\gdef\@title{#2}% + \bgroup + \let\thanks\@gobble + \def\\{\unskip\space\ignorespaces}% + \protected@xdef\rhTitle{#1}% + \egroup +} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\shortTitle} +% \begin{macro}{\ifshortAuthor} +% \begin{macro}{\shortAuthor} +% The \cs{rh*} commands are versions to be used in the running head of +% the article. Normally, they are the same things as the author and +% title of the article, but in the case that there are confusions +% therein, the text should provide substitutes, using the \cs{short*} +% commands. +% \begin{macrocode} +\def\shortTitle #1{\def\rhTitle{#1}} +\newif\ifshortAuthor +\def\shortAuthor #1{\def\rhAuthor{#1}\shortAuthortrue} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% % \subsection{Section titles} % % The following macros are used to set the large \TUB{} section heads @@ -2149,7 +2237,7 @@ \vspace{.5\baselineskip}} % \end{macrocode} % -% \subsection{Headings} +% \subsection{Section headings} % % Redefine style of section headings to match plain \TUB. % Negative beforeskip suppresses following parindent. (So @@ -2170,25 +2258,25 @@ \def\section{\TB@startsection{{section}% 1% \z@ - {-8\p@}% + {-8\p@ \@plus-2\p@ \@minus-2\p@}% {4\p@}% {\normalsize\bf\raggedright\hyphenpenalty=\@M}}} \def\subsection{\TB@startsection{{subsection}% 2% \z@ - {-8\p@}% + {-8\p@ \@plus-2\p@ \@minus-2\p@}% {4\p@}% {\normalsize\bf\raggedright\hyphenpenalty=\@M}}} \def\subsubsection{\TB@startsection{{subsubsection}% 3% \z@ - {-8\p@}% + {-8\p@ \@plus-2\p@ \@minus-2\p@}% {4\p@}% {\normalsize\bf\raggedright\hyphenpenalty=\@M}}} \def\paragraph{\TB@startsection{{paragraph}% 4% \z@ - {2.5ex\@plus 1ex}% + {4\p@ \@plus1\p@ \@minus1\p@}% {-1em}% {\normalsize\bf}}} % \end{macrocode} @@ -2203,21 +2291,21 @@ \TB@startsection{{section}% 1% \z@ - {-8\p@}% + {-8\p@ \@plus-2\p@ \@minus-2\p@}% {4\p@}% {\normalsize\bf\raggedright\hyphenpenalty=\@M}}} \def\subsection{\TB@nolimelabel \TB@startsection{{subsection}% 2% \z@ - {-8\p@}% + {-8\p@ \@plus-2\p@ \@minus-2\p@}% {-0.5em\@plus-\fontdimen3\font}% {\normalsize\bf\raggedright\hyphenpenalty=\@M}}} \def\subsubsection{\TB@nolimelabel \TB@startsection{{subsubsection}% 3% \parindent - {-8\p@}% + {-8\p@ \@plus-2\p@ \@minus-2\p@}% {-0.5em\@plus-\fontdimen3\font}% {\normalsize\bf\raggedright\hyphenpenalty=\@M}}} \fi @@ -2289,12 +2377,12 @@ % \end{macrocode} % % \cs{l@<sectioning-name>} is for table of contents (of an article). -% +% % We define new macros to allow easily changing the font used for toc % entries (for \TUB, we usually want roman, not bold), and the space % between entries. Nelson Beebe's articles are almost the only ones % that ever have toc's. -% +% % \begin{macrocode} \def\TBtocsectionfont{\normalfont} \newskip\TBtocsectionspace \TBtocsectionspace=1.0em\@plus\p@ @@ -2316,7 +2404,7 @@ \addvspace{\TBtocsectionspace}% \@tempdima 1.5em \begingroup - \parindent\z@ \rightskip\z@ % article style makes \rightskip > 0 + \parindent\z@ \rightskip\z@ % article style makes \rightskip > 0 \parfillskip\z@ \TBtocsectionfont \leavevmode\advance\leftskip\@tempdima\hskip-\leftskip#1\nobreak\hfil @@ -2477,28 +2565,50 @@ % we now do our best to discourage hyphenation within captions. We also % typeset them in \cs{small}. % +% First, let's define a dimension by which we will indent full-page +% captions. We'll also use this to indent abstracts in proceedings style. +% \begin{macro}{\tubfullpageindent} +% \begin{macrocode} +\newdimen\tubfullpageindent \tubfullpageindent=4.875pc +% \end{macrocode} +% \end{macro} +% +% Ok, here is the \cs{@makecaption}. % \begin{macrocode} \long\def\@makecaption#1#2{% \vskip\abovecaptionskip - \sbox\@tempboxa{\small #1: #2}% - \ifdim \wd\@tempboxa >\hsize - \raggedright\hyphenpenalty=\@M \parindent=1em - {\small \noindent #1: #2\par}% + \sbox\@tempboxa{\small #1: #2}% try in an hbox + \ifdim \wd\@tempboxa > \hsize + {% caption doesn't fit on one line; set as a paragraph. + \small \raggedright \hyphenpenalty=\@M \parindent=1em + % indent full-width captions {figure*}, but not single-column {figure}. + \ifdim\hsize = \textwidth + \leftskip=\tubfullpageindent \rightskip=\leftskip + \advance\rightskip by 0pt plus2em % increase acceptable raggedness + \fi + \noindent #1: #2\par}% \else - \global \@minipagefalse + % fits on one line; use the hbox, centered. Do not reset its glue. + \global\@minipagefalse \hb@xt@\hsize{\hfil\box\@tempboxa\hfil}% \fi \vskip\belowcaptionskip} % \end{macrocode} % % Also use \cs{small} for the caption labels, and put the label itself -% (Figure xx) in bold. -% +% (e.g., ``Figure 1'') in bold. +% % \begin{macrocode} \def\fnum@figure{{\small \bf \figurename\nobreakspace\thefigure}} \def\fnum@table{{\small \bf \tablename\nobreakspace\thetable}} % \end{macrocode} % +% Let's reduce the default space above captions a bit, and give it some +% flexibility. The default is |10pt|, which seems too much. +% \begin{macrocode} +\setlength\abovecaptionskip{6pt plus1pt minus1pt} +% \end{macrocode} +% % \subsection{Size changing commands} % % Apart from their `normal' effects, these commands change the glue @@ -2556,6 +2666,7 @@ } \def\quote{\list{}{\rightmargin.5\leftmargin}\item[]} % \end{macrocode} +% % From Dominik Wujastyk's font article. First paragraph of a quotation % will not be indented, and right margin is decreased for narrow columns. % \begin{macrocode} @@ -2563,6 +2674,18 @@ \rightmargin.5\leftmargin\parsep \z@\@plus\p@}\item[]} % \end{macrocode} % +% The |compactitemize| environment, without space between the items. +% +% \begin{macrocode} +\newenvironment{compactitemize}% + {\begin{itemize}% + \setlength{\itemsep}{0pt}% + \setlength{\parskip}{0pt}% + \setlength{\parsep} {0pt}% + }% + {\end{itemize}} +% \end{macrocode} +% % \subsection{Some fun with \texttt{verbatim}} % % The |plain| \TUB{} style allows \verb|[optional]| arguments to its @@ -2585,7 +2708,7 @@ % \end{macrocode} % % Impose an optional argument on the environment. -% +% % We start the macro with \cs{par} to avoid a common error: if the % optional argument is \cs{small}, and the document has no blank line % before the verbatim block, we don't want that preceding paragraph to @@ -2691,7 +2814,7 @@ % % \subsection{Bibliography} % \label{sec:citations} -% This is more or less copied verbatim from Glenn Paulley's +% This is more or less copied verbatim from Glenn Paulley's % \emph{chicago.sty} (\texttt{gnpaulle@\penalty0 bluebox.\penalty0 % uwaterloo.\penalty0 ca}). % It produces an author-year citation style bibliography, using @@ -2918,6 +3041,7 @@ % % \subsection{Registration marks} % +% We no longer use these since Cadmus does not want them. % \begin{macrocode} \def\HorzR@gisterRule{\vrule \@height 0.2\p@ \@depth\z@ \@width 0.5in } \def\DownShortR@gisterRule{\vrule \@height 0.2\p@ \@depth 1pc \@width 0.2\p@ } @@ -2947,7 +3071,6 @@ \dlap{\kern\textheight\kern3pc \rlap{\hb@xt@\pagewd{\midrtitle\hfil\midrtitle}} }} - % \end{macrocode} % registration marks; these are temporarily inserted in the running head % \begin{macrocode} @@ -2958,18 +3081,37 @@ \vbox{\dlap{\vbox to\trimlgt{\vfil\botregister}}% \topregister\vskip \headmargin \vskip 10\p@}}}}% } - +% put issue identification and page number in header. \def\@oddhead{\MakeRegistrationMarks\PrelimDraftfooter \normalsize\csname normalshape\endcsname\rm \rtitlex\qquad\midrtitle \hfil \thepage} \def\@evenhead{\MakeRegistrationMarks\PrelimDraftfooter \normalsize\csname normalshape\endcsname\rm \thepage\hfil\midrtitle\qquad\rtitlex} -\def\@oddfoot{} -\def\@evenfoot{} + +% put title and author in footer. +\def\@tubrunningfull{% + \def\@oddfoot{\hfil\rhTitle} + \def\@evenfoot{\@author\hfil} +} + +\def\@tubrunninggetauthor#1{#1 + \begingroup + \let\thanks\@gobble + \protected@xdef\rhAuthor{\the\toks@##1}% + \endgroup +}% + +% empty footer. +\def\@tubrunningminimal{% + \def\@oddfoot{\hfil} + \def\@evenfoot{\hfil} +} + \def\ps@headings{} \pagestyle{headings} % \end{macrocode} +% % \subsection{Output routine} % Modified to alter |\brokenpenalty| across columns % @@ -2992,7 +3134,7 @@ \@whilesw\if@fcolmade \fi{\@outputpage\@startdblcolumn}\endgroup \fi} % \end{macrocode} -% +% % \subsection{Font-related definitions and machinery} % These are mostly for compatibility with plain |tugboat.sty| % \begin{macrocode} @@ -3025,9 +3167,8 @@ % that's maintained in \cs{@currsize}: if the user does something % silly re.~selecting fonts, we'll get the wrong results. The % following code is adapted from an old version of |relsize.sty| by -% Donald Arseneau and Matt Swift. (Note that the -% order of examination of \cs{@currsize} is to get the commonest cases -% out of the way first.) +% Donald Arseneau and Matt Swift. (The order of examination of +% \cs{@currsize} is to get the commonest cases out of the way first.) % \begin{macrocode} %<*common> \DeclareRobustCommand\SMC{% @@ -3119,7 +3260,7 @@ % \begin{macro}{\creditfootnote} % \begin{macro}{\supportfootnote} % Sometimes we want the label ``Editor's Note:'', sometimes not. -% +% % \begin{macrocode} \def\creditfootnote{\nomarkfootnote\xEdNote} \def\supportfootnote{\nomarkfootnote\relax} @@ -3303,10 +3444,10 @@ \def\tugProcYear{2002}\fi % \end{macrocode} % \end{macro} -% +% % Now execute the default `year' option and get on with processing. % Note that this command gets ignored if the configuration file -% specifies a silly year. +% specifies a silly year. % % \begin{macrocode} \ExecuteOptions{tug\tugProcYear,title\TUGprocExtraOptions} @@ -3413,7 +3554,8 @@ % \begin{macro}{\aboveauthorskip} % \begin{macro}{\belowauthorskip} % \begin{macro}{\belowabstractskip} -% Some stretchable stuff to permit variability in page layout. +% Some changeable skips to permit variability in page layout depending +% on the particular paper's page breaks. % \begin{macrocode} \newskip\aboveauthorskip \aboveauthorskip=18\p@ \@plus4\p@ \newskip\belowauthorskip \belowauthorskip=\aboveauthorskip @@ -3450,7 +3592,7 @@ \centerline{\bfseries Abstract}% \vskip.5\baselineskip\rmfamily \list{}{\listparindent20\p@ - \itemindent\z@ \leftmargin4.875pc + \itemindent\z@ \leftmargin\tubfullpageindent \rightmargin\leftmargin \parsep \z@}\item[]\ignorespaces \the\abstract@toks \endlist\global\@ignoretrue @@ -3461,18 +3603,6 @@ % \end{macrocode} % \end{macro} % -% \begin{description} -% \item[\emph{Comment}] This is all very weird\dots why we (of all -% people) don't allow \cs{thanks} currently escapes me. -% \end{description} -% -% This restriction simply removed 1998/01/09 -% -% \begin{macrocode} -%\def\thanks#1{\@bsphack\TBWarning{\string\thanks\space -% is not supported}\@esphack} -% \end{macrocode} -% % \begin{environment}{abstract} % \begin{macro}{\if@abstract} % \begin{macro}{\abstract@toks} @@ -3579,42 +3709,6 @@ % \end{macrocode} % \end{macro} % -% \begin{macro}{\title} -% \begin{macro}{\TB@title} -% We redefine the \cs{title} command, so as to set the \cs{rhTitle} -% command at the same time. While we're at it, we redefine it to have -% optional arguments for use as `short' versions, thus obviating the -% need for users to use the \cs{shortTitle} command. -% \begin{macrocode} -\renewcommand\title{\@dblarg\TB@title} -\def\TB@title[#1]#2{\gdef\@title{#2}% - \bgroup - \let\thanks\@gobble - \let\\\ % - \protected@xdef\rhTitle{#1}% - \egroup -} -% \end{macrocode} -% \end{macro} -% \end{macro} -% -% \begin{macro}{\shortTitle} -% \begin{macro}{\ifshortAuthor} -% \begin{macro}{\shortAuthor} -% The \cs{rh*} commands are versions to be used in the running head of -% the article. Normally, they are the same things as the author and -% title of the article, but in the case that there are confusions -% therein, the text should provide substitutes, using the \cs{short*} -% commands. -% \begin{macrocode} -\def\shortTitle #1{\def\rhTitle{#1}} -\newif\ifshortAuthor -\def\shortAuthor #1{\def\rhAuthor{#1}\shortAuthortrue} -% \end{macrocode} -% \end{macro} -% \end{macro} -% \end{macro} -% % \begin{macro}{\ps@TBproctitle} % \begin{macro}{\ps@TBproc} % \begin{macro}{\dopagecommands} @@ -3659,7 +3753,7 @@ } \def\pfoottext{{\smc Preprint}: Proceedings of the \volyr{} Annual Meeting} -\def\rfoottext{\normalfont\TUB, \volx\Dash +\def\rfoottext{\normalfont\TUB, \volx\Dash {Proceedings of the \volyr{} Annual Meeting}} \pagestyle{TBproc} @@ -3679,7 +3773,7 @@ % natural tendency to reference sections, which is a matter that needs % attention. The class option \textsc{numbersec} once again numbers the % sections (and noticeably changes the layout). -% +% % \begin{macrocode} \if@proc@numbersec \else diff --git a/Master/texmf-dist/source/latex/tugboat/tugboat.ins b/Master/texmf-dist/source/latex/tugboat/tugboat.ins index 44a494748b6..885f8a0464a 100644 --- a/Master/texmf-dist/source/latex/tugboat/tugboat.ins +++ b/Master/texmf-dist/source/latex/tugboat/tugboat.ins @@ -3,7 +3,7 @@ %% driver files from the doc files in this package when run through %% LaTeX or TeX. %% -%% Copyright 1994,1995,1996,2001,2005,2006 TeX Users Group. +%% Copyright 1994,1995,1996,2001,2005,2006,2009 TeX Users Group. %% %% This file is part of the tugboat package. %% @@ -37,7 +37,7 @@ This is a generated file. -Copyright 1994,1995,1996,2001,2005,2006 TeX Users Group. +Copyright 1994,1995,1996,2001,2005,2006,2009 TeX Users Group. It may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 @@ -80,12 +80,7 @@ extension .ins) which are part of the distribution. \Msg{* files into a directory searched by TeX:} \Msg{* \space\space All *.sty and all *.cls} \Msg{*} -\Msg{* Then move ltugbib.bst to a directory searched by BibTeX} -\Msg{*} -\Msg{* Preferred TDS locations:} -\Msg{* tex/latex/tugboat (for *.sty, *.cls)} -\Msg{* bibtex/bst/misc (for ltugbib.bst)} -\Msg{*} +\Msg{* And move ltugbib.bst to a directory searched by BibTeX.} \Msg{***********************************************************} \endinput |