summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/pracjourn
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-07-18 22:57:57 +0000
committerKarl Berry <karl@freefriends.org>2006-07-18 22:57:57 +0000
commitfc2c7ab430ef4b878fd3455118daa831e76db681 (patch)
tree9759b7507d148cb6700403a8eba1a2c637949204 /Master/texmf-dist/source/latex/pracjourn
parent56d4907f71c4e41b7c2eaf9a7a117e83efb0ccff (diff)
new package pracjourn (8mar06)
git-svn-id: svn://tug.org/texlive/trunk@1878 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/pracjourn')
-rw-r--r--Master/texmf-dist/source/latex/pracjourn/pracjourn.dtx1255
-rw-r--r--Master/texmf-dist/source/latex/pracjourn/pracjourn.ins45
2 files changed, 1300 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/pracjourn/pracjourn.dtx b/Master/texmf-dist/source/latex/pracjourn/pracjourn.dtx
new file mode 100644
index 00000000000..99c5224bfb3
--- /dev/null
+++ b/Master/texmf-dist/source/latex/pracjourn/pracjourn.dtx
@@ -0,0 +1,1255 @@
+% \iffalse
+% Copyright (C) 2004 TeX Users Group.
+%
+% This program is free software; you can redistribute it and/or modify
+% it under the terms of the GNU General Public License as published by
+% the Free Software Foundation; either version 2 of the License, or
+% (at your option) any later version.
+%
+% This program is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with this program; if not, write to the Free Software
+% Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+%
+%<*driver>
+\ProvidesFile{pracjourn.dtx}
+%</driver>
+%<class>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
+%<class>\ProvidesClass{pracjourn}
+%<*class>
+ [2006/02/20 v0.4k PracTeX Journal Class]
+%</class>
+%
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage{hyperref,multicol}
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+
+\makeatletter
+\usepackage{amsmath,amssymb,array,calc,graphicx,hyperref,ifpdf,ifthen,varioref}
+\usepackage[osf]{mathpazo}
+\renewcommand\sfdefault{lmss}
+\renewcommand\ttdefault{lmtt}
+\usepackage[T1]{fontenc}
+\ifpdf\IfFileExists{microtype.sty}{\usepackage[protrusion=true,expansion=false]{microtype}}{}\fi
+\linespread{1.069} % Palatino needs more space between lines
+\frenchspacing % Remove ugly extra space after punctuation
+\hypersetup{colorlinks, breaklinks, linktocpage,
+ linkcolor=red, citecolor=red, filecolor=blue, urlcolor=blue}
+\setlength\extrarowheight{2pt} % Make tables bearable
+% Crude referencing commands:
+\newcommand\tabref[1]{Table~\vref{tab:#1}}
+\newcommand\figref[1]{Figure~\vref{fig:#1}}
+\newcommand\secref[1]{Section~\vref{sec:#1}}
+% Various labelling commands:
+\newcommand*\name[1]{\textsc{#1}}
+\newcommand*\pkg[2][]{\relax
+ \edef\@tempa{#1}\relax
+ \ifx\@tempa\@empty
+ \textsf{#2}\else
+ \href{#1}{\textsf{#2}}\fi}
+\newcommand*\env[1]{\textsf{#1}}
+\let\latin\textit
+\def\eg{\latin{e.g.}}
+\def\ie{\latin{i.e.}}
+\def\etc{\@ifnextchar.{\latin{etc}}{\latin{etc.}\@}}
+% Better float parameters: (from the TeX FAQ)
+\renewcommand{\topfraction}{.85}
+\renewcommand{\bottomfraction}{.7}
+\renewcommand{\textfraction}{.15}
+\renewcommand{\floatpagefraction}{.66}
+\renewcommand{\dbltopfraction}{.66}
+\renewcommand{\dblfloatpagefraction}{.66}
+\setcounter{topnumber}{9}
+\setcounter{bottomnumber}{9}
+\setcounter{totalnumber}{20}
+\setcounter{dbltopnumber}{9}
+% Section heading customisation:
+\renewcommand\section{\@startsection {section}{1}{\z@}%
+ {-3ex \@plus -1ex \@minus -.2ex}%
+ {2ex \@plus 0.2ex}%
+ {\centering\normalsize\scshape}}
+\renewcommand\subsection{\@startsection{subsection}{2}{\z@}%
+ {-2.5ex\@plus -1ex \@minus -.2ex}%
+ {1.5ex \@plus 0.2ex}%
+ {\centering\normalsize\itshape}}
+\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
+ {-2ex\@plus -1ex \@minus -.2ex}%
+ {1.5ex \@plus 0.2ex}%
+ {\centering\normalfont\normalsize}}
+\renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}%
+ {3.25ex \@plus1ex \@minus.2ex}%
+ {-1em}%
+ {\normalfont\normalsize\itshape}}
+\let\subparagraph\undefined
+\def\@maketitle{%
+ \newpage
+ {\centering
+ {\large\@title\par}\vskip1em
+ \textsc\@author\par\vskip1em
+ \@date\par}\vskip2em}
+% Abstract customisation:
+\renewenvironment{abstract}{%
+ \begin{trivlist}\item[]
+ \setlength\leftskip{0.15\textwidth}
+ \setlength\rightskip{0.15\textwidth}
+ \small\textit{Abstract}\quad}{\end{trivlist}}
+% TOC customisation: Make it two-column to save space;
+% Remove leaders in the TOC, replace with \quad.
+\setcounter{tocdepth}{2}
+\renewcommand\tableofcontents{%
+ \section*{\contentsname}
+ \begin{trivlist}\item[]
+ \begin{multicols}{2}
+ \setlength\parskip{0pt}
+ \small
+ \@starttoc{toc}%
+ \end{multicols}
+ \end{trivlist}}
+\renewcommand*\l@section[2]{%
+ \ifnum \c@tocdepth >\z@
+ \addpenalty\@secpenalty
+ \addvspace{1.0em \@plus\p@}%
+ \setlength\@tempdima{1.5em}%
+ \begingroup
+ \raggedright
+ \parindent \z@
+ \rightskip \z@
+ \parfillskip \@flushglue
+ \leavevmode
+ \advance\leftskip\@tempdima
+ \hskip -\leftskip
+ #1\quad\nobreak#2\hfil\par
+ \endgroup
+ \fi}
+\def\@dottedtocline#1#2#3#4#5{%
+ \ifnum #1>\c@tocdepth \else
+ {\leftskip #2\relax \rightskip \@tocrmarg \parfillskip \@flushglue
+ \parindent #2\relax\@afterindenttrue
+ \interlinepenalty\@M
+ \leavevmode
+ \raggedright
+ \@tempdima #3\relax
+ \advance\leftskip \@tempdima \null\nobreak\hskip -\leftskip
+ {#4}\quad\nobreak#5\hfil\par}%
+ \fi}
+% Better footnotes:
+\let\old@makefntext\@makefntext
+\renewcommand\@makefntext[1]{%
+ \vspace{2pt}%
+ \setlength\parindent{-1.8em}%
+ \setlength\leftskip{1.8em}%
+ \makebox[1.8em][l]{\normalfont\small\@thefnmark.}#1}
+% LOGOS, tuned for Palatino:
+\def\TeX{T\kern-.15em\lower.5ex\hbox{E}\kern-.07em X\spacefactor1000\relax}
+
+\begin{document}
+ \DocInput{pracjourn.dtx}
+\end{document}
+%</driver>
+%
+% \fi
+%
+% \CheckSum{720}
+%
+%
+% \changes{v0.0}{2004/10/03}{KB: Initial version}
+% \changes{v0.2}{2004/11/13}{KB: Palatino, no date printing}
+% \changes{v0.3}{2005/01/03}{AO: Add \cmd\TPJissue, \cmd\TPJrevision, \cmd\TPJcopyright}
+% \changes{v0.3}{2005/01/03}{AO: Rewrite using \LaTeXe{} idioms}
+% \changes{v0.3a}{2005/01/03}{AO: changes to \cmd\TPJissue, \cmd\TPJrevision, \cmd\TPJcopyright}
+% \changes{v0.3b}{2005/01/07}{AO: change \cmd\evensidemargin}
+%
+%
+% \GetFileInfo{pracjourn.dtx}
+%
+% \DoNotIndex{\if}
+%
+% \title{The \textsf{pracjourn} class}
+% \author{%
+% Karl Berry \\
+% Arthur Ogawa\\
+% Will Robertson\\
+% Correspondence to: \texttt{pracjourn@tug.org}}
+% \date{\filedate\qquad\fileversion}
+%
+% \maketitle
+%
+% \begin{abstract}
+% \noindent\textsf{pracjourn} is a class based on \texttt{article.cls},
+% to be used for typesetting articles in The Prac\TeX\ Journal,
+% \url{http://tug.org/pracjourn}.
+% \end{abstract}
+%
+% \tableofcontents
+%
+% \section{Introduction}
+%
+% The \pkg{pracjourn} \LaTeX{} document class is to be used for
+% articles written for the The Prac\TeX\ Journal,
+% \url{http://tug.org/pracjourn}. The source for the document class
+% resides at \url{http://tug.org/pracjourn/dtx}, and is also
+% available at CTAN.
+%
+% \section{Usage}
+%
+% Refer to the sample document, \url{www.tug.org/pracjourn/dtx/pjsample.tex},
+% for context. Issue a |\documentclass{pracjourn}| command at
+% the beginning of your document as usual. No class options are necessary.
+%
+% This document class automatically loads the packages
+% \pkg{color}, \pkg{graphicx}, \pkg{hyperref}, and \pkg{textcomp}.
+% These are all standard packages in every \TeX\ distribution.
+%
+% \subsection{Formatting}
+%
+% Page metrics are appropriate for printing on either A4 or
+% letter size paper. The type size is 12/15.5 Palatino.
+% Except in exceptional circumstances, please refrain from
+% using typefaces other than those defined by this class.
+%
+% Hyperlinks are inserted automatically in the relevant locations in
+% a dark blue colour. If you wish to adjust this colour to suit your
+% own colour requirements, simply redefine the \texttt{linkcolour}. E.g.,
+% to change it to dark red,\\
+% \indent|\definecolor{linkcolour}{rgb}{0.7,0.2,0.2}|.
+%
+% \subsection{Author/article metadata}
+%
+% All author and article information must be defined before \cmd\maketitle, which
+% should probably be the first thing after |\begin{document}|.
+%
+% \DescribeMacro{\author}
+% \DescribeMacro{\title}
+% \DescribeMacro{\abstract}
+% The \cmd\author, \cmd\title, and \cmd\abstract\ commands are used to
+% define those pieces of metadata about the article, and are mandatory.
+% Note that the \cmd\abstract\ is a plain old command, \emph{not} an environment.
+%
+% \DescribeMacro{\noabstract}
+% Should you have a reason for not having an abstract,
+% this may be signified by declaring \cmd\noabstract\ instead.
+%
+% \DescribeMacro{\license}
+% It is optional to specify a copyright and/or license declaration,
+% to be typeset in the footer of the first page, with the \cmd\license\
+% command.\footnote{The \cmd\TPJcopyright\ command, which used to provide this
+% functionality is still provided for backwards compatibility.}
+%
+% \DescribeMacro{\email}
+% \DescribeMacro{\website}
+% \DescribeMacro{\address}
+% Additional author information may be specified, to be typeset appropriately,
+% with the following commands: \cmd\email, \cmd\website, and \cmd\address.
+%
+% If the \pkg{switcheml} package is installed somewhere that
+% \TeX\ will find it, it is loaded for the purpose of obfuscating
+% the typeset email address. This is done to prevent harvesting by
+% spammers, but if the package cannot be found the email address
+% will by typeset as a hyperlink.
+%
+% \DescribeMacro{\hyperlinkemail}
+% Should you wish to typeset your
+% email address as a hyperlink (that is, theoretically harvestable
+% by spammers) despite having \pkg{switcheml} installed, you may
+% simply include the command \cmd\hyperlinkemail\ anywhere before
+% \verb|\begin{document}|.
+%
+% \subsubsection{Adding more author/article information}
+%
+% As previously
+% mentioned, this class provides the \cmd\email, \cmd\website, and \cmd\address\
+% macros for typesetting that information in the header block. These commands are defined
+% in the source code of the class file with (something like) the following:\footnote{\cmd\typesetemail\ is an internal command defined by either \cmd\hyperlinkemail\ or \cmd\obfuscateemail.}
+% \begin{quote}
+% |\addinfo[\typesetemail]{Email}|\\
+% |\addinfo[\url]{Website}|\\
+% |\addinfo{Address}|
+% \end{quote}
+% Additional blocks my be added on a per-article basis in the same manner.
+%
+% \DescribeMacro{\addinfo}
+% To be specific, the \cmd\addinfo\ command takes one mandatory argument,
+% which is the title of the item to be added to the list, and one optional
+% argument, which is used to define the formatting of the block.
+%
+% This command will then define the macro used to input the additional information
+% by taking the lowercase of the title of the information and turning it into
+% a \TeX\ macro. This creates the obvious limitation on the name of the information
+% blocks that only single words may be used to describe any additional metadata. This
+% should not cause concern in practice.
+%
+% \DescribeMacro{\addinfospace}
+% If you wish to add some vertical space after the previous item in the front matter,
+% the \cmd\addinfospace\marg{height} command will insert some. This may be necessary
+% after multi-line blocks, which require some breathing room.
+%
+% \DescribeMacro{\clearinfo}
+% If you don't like the ordering of the information blocks or you wish to edit
+% the formatting of the current setup, the \cmd\clearinfo\ command allows you to start
+% fresh and redefine the address, email, and website information blocks however you may wish.
+%
+% \subsection{Additional user commands}
+% \DescribeMacro{\dash} For `smart' dashes in text. Thinly spaced from the text, it ignores surrounding spaces, and permits only succeeding line breaks.
+% \begin{quote}
+% |use like this \dash for consistent dashes|
+% \end{quote}
+% produces `use like this \unskip\thinspace\nobreak\textemdash\thinspace for consistent dashes'.
+%
+%
+% \DescribeMacro{\note} For easier footnotes. This command ignores preceding space, so linebreaks before the footnote text in the source will not give the wrong spacing.
+% \begin{quote}
+% |And here's an example.|\\
+% | \note{Albeit a trivial one.}|\\
+% |And continuing|
+% \end{quote}
+% produces `And here's an example.
+% \unskip\footnote{Albeit a trivial one.}
+% And continuing'.
+%
+% \DescribeEnv{itemise} For non-US writers, it is probably more natural
+% to use |\begin{itemise}| over what \LaTeX\ provides by default.
+%
+% \DescribeMacro{\ctanfile}
+% \changes{v0.4j}{2006/02/09}{Implemented.}
+% \DescribeMacro{\ctanloc}
+% \changes{v0.4j}{2006/02/09}{Implemented.}
+% These commands are used to refer to online locations and documentation within the Comprehensive \TeX\ Archive Network. Usage is as follows:
+% \begin{quote}
+% |\ctanfile{macros/latex/contrib/titlesec/titlesec.pdf}|\\
+% |\ctanloc{macros/latex/contrib/titlesec/}|
+% \end{quote}
+% It will print the input prefixed with `CTAN:' and provide a hyperlink to the location.
+%
+% \subsection{TPJ internal commands}
+%
+% Two commands are to be used at the direction of the Prac\TeX\
+% production team: \cmd\TPJrevision\ and \cmd\TPJissue. These
+% commands typeset information in the header of the first page
+% relating to the revision number (or date) of the article and the
+% issue number of the journal.
+%
+% This document class creates a file \verb+_rev.tex+ in the
+% current directory (if a \cmd\TPJrevision{} statement is present)
+% and reads a file \verb+_iss.tex+, if present. Please keep a
+% separate directory for each article you develop for TPJ.
+%
+% \subsection{Logos}
+%
+% \begingroup
+%
+% \DeclareRobustCommand\TeX{T\kern-.15em\lower.5ex\hbox{E}\kern-.07em X\spacefactor1000\relax}
+% \DeclareRobustCommand\LaTeX{L\kern-.32em\raise.37ex\hbox{\scalebox{0.76}{A}}\kern-.15em\TeX}
+% \DeclareRobustCommand\LaTeXe{\LaTeX2$_{\textstyle\varepsilon}$}
+% \DeclareRobustCommand\BibTeX{B{\textsc i\kern-.025em\textsc b}\kern-.08em\TeX}
+% \DeclareRobustCommand\logofamily{%
+% \not@math@alphabet\logofamily\relax
+% \fontencoding{U}\fontfamily{logo}\selectfont}
+% \def\textlogo#1{{\logofamily#1}}
+% \DeclareRobustCommand\MF{\textlogo{METAFONT}\@}
+% \DeclareRobustCommand\MP{\textlogo{METAPOST}\@}
+% \DeclareRobustCommand\ConTeXt{C\kern-.03em on\-\kern-.10em\TeX\kern-0.04em t}%
+% \DeclareRobustCommand\pdfTeX{pdf\/\TeX}
+% \DeclareRobustCommand\pdfLaTeX{pdf\/\LaTeX}
+% \DeclareRobustCommand\PS{PostScript}
+% \DeclareRobustCommand\PracTeX{Prac\kern-0.07em\TeX}
+% \DeclareRobustCommand\TPJ{The \PracTeX\ Journal}
+% \DeclareRobustCommand\XeTeX{\relax
+% X\lower.5ex\hbox{\kern-.07em\reflectbox{E}}\relax
+% \kern-.15em\TeX}
+% \DeclareRobustCommand\ExTeX{\textrm{\relax
+% \ensuremath{\textstyle\varepsilon\sb{\kern-0.15em\mathcal{X}}}\relax
+% \kern-.15em\TeX}}
+% The following logos and abbreviations are defined for your
+% convenience:
+% \begin{multicols}{2}\everypar{\parindent0pt\parskip0pt}
+% \def\showlogo#1{\@for\@ii:=#1\do{\expandafter\cmd\@ii:\hfill\@ii\endgraf}}
+% \showlogo{\noexpand\TeX,\LaTeX,\LaTeXe,\BibTeX,\MF,\MP,
+% \ConTeXt,\pdfTeX,\pdfLaTeX,\XeTeX,\ExTeX,\PracTeX,\TPJ,\PS}
+% \end{multicols}
+% \endgroup
+%
+% \StopEventually{\clearpage\PrintChanges\clearpage\PrintIndex}
+%
+% \section{History}
+%
+% The first revision of this class was written by Karl Berry.
+% KB: Gratefully based on the \texttt{dtxtut} skeleton.
+%
+% Revised by Arthur Ogawa, 2004/01/03, to include new features, per
+% Lance Carnes, as follows:
+%
+% \begin{enumerate}
+% \item Define an \cmd\articleID{} macro which typesets the article
+% identification in a block somewhere on the first page of the
+% article, and which can be used to identify the article/revision
+% date for reader comments. E.g. if this appears in the article
+% source file:
+% \begin{verbatim}
+% \author{A.U. Thor}
+% \title{Pracjourn Sample}
+% \TPJissue{TPJ Vol 1 No 1, 2005-1-15}
+% \TPJrevision{2005-2-12}%
+% \TPJcopyright{\textcopyright\ 2005 TeX Users Group}
+% \end{verbatim}
+% it will become a block of text typeset on the first page of the
+% article. See
+% e.g. \href{http://www.ams.org/bull/2004-41-04/S0273-0979-04-01032-8/S0273-0979-04-01032-8.pdf}{this example PDF}.
+%
+% \item Write the information from the argument of the
+% \cmd\articleID{} macro into a file called \verb+_id.tex+. Put
+% this file in the same directory as the source file, and overwrite
+% any previous files of the same name.
+%
+% \item Define a \cmd\TPJcopyright{} macro which will print a
+% copyright notice at the bottom of the first page.
+% E.g. \cmd\TPJcopyright\verb+{2005 TeX Users Group}+ will produce
+% ``\copyright2005 TeX Users Group'' in the page footer of the title
+% page.
+%
+% \item The page measures should work with both Letter and A4 paper
+% sizes.
+% \end{enumerate}
+%
+% Revised again by Will Robertson, mid-2005, to implement some
+% extra things. This snow-balled into the current version, a description
+% of which here would be redundant.
+%
+% \clearpage
+% \section{Implementation}
+%
+% The is fairly poorly documented, and the
+% class has undergone a multitude of small changes over the TPJ issues
+% 2005-4, 2006-1. It should now be fairly stable, and over time it's
+% conceivable (but unlikely) that the descriptions herein will be improved.
+%
+% \subsection{Base class and options}
+%
+% Use \LaTeX's \pkg{article} class, but at a bigger default type size.
+%
+% KB: 12pt seems a little too big, 11pt seems a little too small.
+% Implementing 11.5pt is not obvious.
+%
+% \changes{v0.3}{2004/01/03}{AO: Override the default option list of
+% \pkg{article.cls}}
+%
+% If the document instance calls for options that conflict with the
+% following choices, then the document wins. However our default
+% option list is not the same as those of \pkg{article.cls}.
+% \begin{macrocode}
+\let\ExecuteOptions@ltx\ExecuteOptions
+\def\ExecuteOptions#1{%
+ \ExecuteOptions@ltx{letterpaper,12pt,oneside,onecolumn,final}%
+}%
+\LoadClassWithOptions{article}
+\let\ExecuteOptions\ExecuteOptions@ltx
+% \end{macrocode}
+%
+% \subsection{Metrics}
+%
+% Default leading (from \texttt{classes.dtx}) for 11pt is 13.6pt
+% leading, for 12pt is 14.5pt. We want more---this factor gives us
+% 12pt type on 15.5pt leading.
+% \begin{macrocode}
+\linespread{1.069}
+% \end{macrocode}
+%
+% Change the text width to something that works for both A4 and
+% Letter paper, as well as possible.
+%
+% xx The vertical dimensions need to be changed as well, perhaps
+% for a 9in text height, taking account of the headline and
+% footline.
+% \begin{macrocode}
+\setlength\textwidth{432pt}
+\setlength\oddsidemargin{18pt}% xx depend on letter/a4
+\setlength\evensidemargin{18pt}
+% \end{macrocode}
+%
+% \subsection{Package loading}
+%
+% Palatino, including math (sc option for true small caps, not in TL
+% 2003). Try for \pkg{mathpazo}; if not available use \pkg{palatino}.
+%
+% Enable pdf\TeX's margin kerning, if available, but \emph{not} font expansion,
+% which increases the size and complexity of the resultant PDF. This side-effect
+% may be deemed negligible in the future.
+%
+% \changes{v0.3}{2004/01/03}{AO: rewrite using \cs{IfFileExists} idiom.}
+% \changes{v0.4e}{2005/08/22}{WR: requires the textcomp package.}
+% \changes{v0.4g}{2005/11/04}{WR: use \pkg{microtype}, if available}
+%
+% The \pkg{textcomp} package is loaded in order to provide a nice looking copyright logo, amongst other things.
+%
+% \begin{macrocode}
+\IfFileExists{mathpazo.sty}
+ {\RequirePackage[sc]{mathpazo}}
+ {\renewcommand\rmdefault{ppl}}
+\IfFileExists{microtype.sty}{\RequirePackage[protrusion=true,expansion=false]{microtype}}{}
+\RequirePackage{textcomp}
+% \end{macrocode}
+% \pkg{hyperref} is used for creating live hyperlinks, as well as
+% providing \cmd\url\ for typesetting URLs easily. All hyperlinks
+% are coloured in a dark shade of blue.
+% \begin{macrocode}
+\RequirePackage{color,hyperref,graphicx}
+\definecolor{linkcolour}{rgb}{0,0.2,0.6}
+\hypersetup{colorlinks,breaklinks,
+ linkcolor=linkcolour,citecolor=linkcolour,
+ filecolor=linkcolour, urlcolor=linkcolour}
+% \end{macrocode}
+% If the \pkg{switcheml} package is installed in the author's
+% system, use it to obfuscate their email address by default. Otherwise, just
+% use a hyperlink. The commands to do this are defined in a later section.
+%
+% An author may specify \cmd\hyperlinkemail\ explicitly
+% should they not care to obfuscate their email address even with the \pkg{switcheml}
+% package installed.
+% \begin{macrocode}
+\IfFileExists{switcheml.sty}
+ {\RequirePackage{switcheml}
+ \AtBeginDocument{\@ifx@undefined{\typesetemail}{\obfuscateemail}{}}}
+ {\AtBeginDocument{\@ifx@undefined{\typesetemail}{\hyperlinkemail}{}}}
+% \end{macrocode}
+%
+%
+% \subsection{Amendments from \pkg{article}}
+%
+% \begin{macro}{\maketitle}
+% Printing the date of the last \TeX\ run in the title block does
+% not seem warranted---if someone reprocesses the document with no
+% changes, we wouldn't want the date to change.
+%
+% xx use rcs.sty or something?
+%
+% xx include bibtex id?
+%
+% \changes{v0.3}{2004/01/03}{AO: reproduce entire definition from
+% \texttt{article.cls}, with modifications.}
+% \changes{v0.3}{2004/01/03}{AO: \cmd\thispagestyle{titlepage}. Do
+% not empty out \cmd\@author, \cmd\@title, etc.}
+% \changes{v0.4b}{2005/06/26}{WR: removed some twocolumn conditional code.}
+% \changes{v0.4b}{2005/06/26}{WR: added check for an abstract}
+% \begin{macrocode}
+\renewcommand\maketitle{\par
+ \iftpj@noabstract\else
+ \@ifx@undefined{\tpj@info@Abstract}
+ {\ClassError{pracjourn}
+ {Please specify an \string\abstract\space before \string\maketitle}
+ {It is a PracTeX Journal requirement to include an abstract. \MessageBreak
+ \MessageBreak
+ If you have exceptional reasons for not having one in this \MessageBreak
+ article, write \string\noabstract\space somewhere before \string\maketitle.}}{}
+ \fi
+ \begingroup
+ \renewcommand\thefootnote{\@fnsymbol\c@footnote}%
+ \def\@makefnmark{\rlap{\@textsuperscript{\normalfont\@thefnmark}}}%
+ \long\def\@makefntext##1{\parindent 1em\noindent
+ \hb@xt@1.8em{%
+ \hss\@textsuperscript{\normalfont\@thefnmark}}##1}%
+ \newpage
+ \global\@topnum\z@ % Prevents figures from going at top of page.
+ \@maketitle
+ \thispagestyle{titlepage}\@thanks
+ \endgroup
+ \setcounter{footnote}{0}%
+ \global\let\thanks\relax
+ \global\let\maketitle\relax
+ \global\let\@maketitle\relax
+ \global\let\title\relax
+ \global\let\author\relax
+ \global\let\date\relax
+ \global\let\and\relax
+}%
+% \end{macrocode}
+% \end{macro}
+%
+%
+%
+% \begin{macro}{\@maketitle}
+%
+% \changes{v0.4a}{2005/06/13}{WR: various changes to accommodate extras.}
+% \begin{macrocode}
+\def\@maketitle{%
+ \newpage
+ \null
+ \write@ID@aux\read@issue
+ \begin{flushleft}
+ \let\footnote\thanks
+ \begingroup\LARGE \@title \par\endgroup
+ \vspace{2ex}%
+ \begingroup\large \@author \par\endgroup
+ \end{flushleft}
+% \end{macrocode}
+% This is where the extra author information is typeset. As various
+% pieces of information are defined, they fill up the \cmd{\tpj@optional@author@info}
+% macro, which is subsequently used here as per the definition of the author.
+% \begin{macrocode}
+ \tpj@optional@author@info
+ \iftpj@noabstract\else
+ \vspace{2ex}%
+ \tpj@info@container{Abstract}
+ \fi}
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \subsubsection{Formatting changes}
+% \begin{macro}{\section}
+% \begin{macro}{\subsection}
+% \begin{macro}{\subsubsection}
+% \begin{macro}{\paragraph}
+% \begin{macro}{\subparagraph}
+% Remove bold from the all the section headings, just for something a
+% little different. This is verbatim from \texttt{article.cls} with a
+% bunch of \cmd\bfseries's omitted.
+% \begin{macrocode}
+\renewcommand\section{\@startsection {section}{1}{\z@}%
+ {-3.5ex \@plus -1ex \@minus -.2ex}%
+ {2.3ex \@plus.2ex}%
+ {\normalfont\Large\raggedright}}
+\renewcommand\subsection{\@startsection{subsection}{2}{\z@}%
+ {-3.25ex\@plus -1ex \@minus -.2ex}%
+ {1.5ex \@plus .2ex}%
+ {\normalfont\large\raggedright}}
+\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
+ {-3.25ex\@plus -1ex \@minus -.2ex}%
+ {1.5ex \@plus .2ex}%
+ {\normalfont\normalsize\raggedright}}
+\renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}%
+ {3.25ex \@plus1ex \@minus.2ex}%
+ {-1em}%
+ {\normalfont\normalsize\itshape}}
+\renewcommand\subparagraph{\@startsection{subparagraph}{5}{\parindent}%
+ {3.25ex \@plus1ex \@minus .2ex}%
+ {-1em}%
+ {\normalfont\normalsize\itshape}}
+% \end{macrocode}
+% \end{macro}\end{macro}\end{macro}\end{macro}
+% \changes{v0.4i}{2006/01/19}{Added \cs{raggedright} to section headings.}
+% \end{macro}
+%
+% \paragraph{Lists}
+% \begin{environment}{itemize}
+% \begin{environment}{enumerate}
+% \begin{environment}{description}
+% Decrease the amount of vertical space between items in the list environments. To do this, save the old environment macros under new names, and then change the `real' environments to call the originals plus some space-adjusting parameters.
+%
+% Note that description lists shouldn't contain more than on paragraph.
+% \begin{macrocode}
+\let\tpj@itemize\itemize
+\let\tpj@enditemize\enditemize
+\let\tpj@enum\enumerate
+\let\tpj@endenum\endenumerate
+\let\tpj@desc\description
+\let\tpj@enddesc\enddescription
+\renewenvironment{itemize}
+ {\tpj@itemize\parskip0pt}{\tpj@enditemize}
+\renewenvironment{enumerate}
+ {\tpj@enum\parskip0pt}{\tpj@endenum}
+\renewenvironment{description}
+ {\tpj@desc\parskip0pt\parindent1.8em}{\tpj@enddesc}
+% \end{macrocode}
+% \changes{v0.4g}{2006/01/05}{Space removed between list items.}
+% \end{environment}
+% \end{environment}
+% \end{environment}
+% \begin{environment}{itemise}
+% Provide an environment with the correct spelling of `itemize'.
+% \begin{macrocode}
+\let\itemise\itemize
+\let\enditemise\enditemize
+% \end{macrocode}
+% \end{environment}
+%
+% \begin{macro}{\labelitemi(...)}
+% Get rid of the nasty blob that is the \cmd\textbullet, and replace
+% it with more unobtrusive dashes.
+% \begin{macrocode}
+\renewcommand\labelitemi{\normalfont\bfseries\textendash}
+\renewcommand\labelitemii{\normalfont\bfseries\textperiodcentered}
+% \end{macrocode}
+% \changes{v0.4g}{2006/01/05}{Itemise bullets changed.}
+% \end{macro}
+%
+% \begin{macro}{\descriptionlabel}
+% Change the description label to italics instead of bold.
+% \begin{macrocode}
+\renewcommand*\descriptionlabel[1]{\hspace\labelsep
+ \normalfont\itshape #1}
+% \end{macrocode}
+% \end{macro}
+%
+% \paragraph{Footnotes}
+% Here we change the footnote formatting a little bit from the default.
+% \begin{macro}{\@makefntext}
+% \changes{v0.4f}{2005/10/06}{WR: Removed the footnote superscript}
+% \changes{v0.4g}{2005/11/01}{WR: Added a period after the footnote number}
+% Make the footnote number at the bottom of the page not a superscript (recommended by Bringhurst, if you're curious---the superscript is there originally to get the number out of the way, but that's no longer needed when you're labelling the note with the number).
+% \begin{macrocode}
+\renewcommand\@makefntext[1]{%
+ \parindent 1.8em%
+ \noindent
+ \hb@xt@1.8em{\hbox{\strut\normalfont\small\@thefnmark.}\hss}#1}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{TPJ additions}
+%
+% \subsubsection{Boolean logic}
+%
+% \begin{macro}{\@ifx@empty}
+% \begin{macro}{\@ifx@undefined}
+% \begin{macro}{\@ifeof}
+% The following three procedures implement part of the boolean logic
+% facility, an expansion-only calculating engine.
+% \begin{macrocode}
+\def\@ifx@empty#1{% Implicit #2#3
+ \ifx#1\@empty
+ \expandafter\@firstoftwo
+ \else
+ \expandafter\@secondoftwo
+ \fi}%
+\def\@ifx@undefined#1{% Implicit #2#3
+ \ifx#1\@undefined
+ \expandafter\@firstoftwo
+ \else
+ \expandafter\@secondoftwo
+ \fi}%
+\def\@ifeof#1{% Implicit #2#3
+ \ifeof#1
+ \expandafter\@firstoftwo
+ \else
+ \expandafter\@secondoftwo
+ \fi}%
+\def\boolean@true#1{\let#1\@firstoftwo}%
+\def\boolean@false#1{\let#1\@secondoftwo}%
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+%
+% \subsubsection{Titlepage pagestyle}
+%
+% \begin{macro}{\ps@titlepage}
+% The \cmd{\ps@titlepage} procedure effects a page style
+% called \texttt{titlepage}, which applies only to the title page.
+% The \cmd{\titlepage@head} procedure sets type in the page header,
+% \cmd{\titlepage@foot} in the page footer.
+%
+% \changes{v0.3}{2004/01/03}{AO: add page header and footer to title page}
+% \begin{macrocode}
+\def\ps@titlepage{%
+ \def\@oddhead{\titlepage@head\hfil}%
+ \let\@evenhead\@oddhead
+ \def\@oddfoot{\hfil\titlepage@foot}%
+ \let\@evenfoot\@oddfoot}%
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\titlepage@head}
+%
+% This is the text block before the article title. Changes depending
+% on the production stage.
+%
+% \changes{v0.4b}{2005/06/26}{WR: More conditional text.}
+% \changes{v0.4b}{2005/06/26}{WR: Added hyperref link to email article
+% comments for both reviewers and readers.}
+% \changes{v0.4c}{2005/06/27}{WR: Tweaked conditionals; revision date is important even after publication!}
+% \changes{v0.4c}{2005/06/27}{WR: Added error check for \cmd\TPJrevision\ defined without \cmd\TPJissue.}
+% \changes{v0.4d}{2005/07/17}{WR: Make the header \cmd\small.}
+% \changes{v0.4e}{2005/07/17}{WR: Removed email comments links.}
+% \changes{v0.4k}{2006/02/20}{WR: Simplified \& made smaller.}
+% \begin{macrocode}
+\def\titlepage@head{\footnotesize
+ \parbox{\linewidth}{%
+ \@ifx@empty\@TPJissue{For submission to \TPJ}{\@TPJissue}\par
+ \@ifx@empty\@TPJissue
+ {\@ifx@empty\@TPJrevision{Draft of \today}{Article revision \@TPJrevision}}%
+ {\@ifx@empty\@TPJrevision
+ {\ClassError{pracjourn}
+ {\string\TPJrevision\space must be defined if
+ \string\TPJissue\space is also}
+ {It is a requirement for PracTeX Journal articles to contain\MessageBreak
+ revision information for version tracking. Please input this\MessageBreak
+ information, or omit \protect\TPJissue.}}
+ {Article revision \@TPJrevision}}}}%
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\titlepage@foot}
+% To typeset the optional copyright declaration by the author.
+%
+% \changes{v0.4d}{2005/07/17}{WR: Removed \cmd\copyright\ from the copyright
+% notice and put the whole thing in a lowered \cmd\vbox\ to allow multi-line declarations.}
+% \changes{v0.4k}{2006/02/20}{WR: Made smaller.}
+% \begin{macrocode}
+\def\titlepage@foot{%
+ \vtop{\raggedleft\footnotesize\@TPJcopyright}}%
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+% Better float parameters: (from the TeX FAQ)
+\renewcommand{\topfraction}{.85}
+\renewcommand{\bottomfraction}{.7}
+\renewcommand{\textfraction}{.15}
+\renewcommand{\floatpagefraction}{.66}
+\renewcommand{\dbltopfraction}{.66}
+\renewcommand{\dblfloatpagefraction}{.66}
+\setcounter{topnumber}{9}
+\setcounter{bottomnumber}{9}
+\setcounter{totalnumber}{20}
+\setcounter{dbltopnumber}{9}
+% \end{macrocode}
+%
+% \subsubsection{Additional author/article information}
+%
+% \begin{macro}{\addinfo}
+%
+% This command defines a new block of information to be typeset
+% in the title block of the document. For every new item, a new
+% \cmd{\tpj@info@container} is appended to \cmd{\tpj@optional@author@info}, which
+% is called in \cmd{\@maketitle}.
+%
+% \changes{v0.4d}{2005/07/30}{WR: Name change to user-space.}
+% \begin{macrocode}
+\newcommand\addinfo[2][]{%
+ \tpj@define@info@block[#1]{#2}%
+ \g@addto@macro\tpj@optional@author@info{\tpj@info@container[#1]{#2}}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\addinfospace}
+% Adds some space after the previous item in the frontmatter.
+% \begin{macrocode}
+\newcommand\addinfospace[1]{\g@addto@macro\tpj@optional@author@info{\vspace{#1}}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\tpj@define@info@block}
+% \changes{v0.4a}{2005/06/13}{WR: Implemented for new \cmd{\@maketitle}.}
+% This macro actually does the work of \cmd\addinfo.
+% It takes the name of a piece of info to be typeset in the
+% title block of the article. The name of the info is lowercased to
+% create a control sequence for the user to input this data. E.g.,
+% \cs{addinfo{Abstract}} will create a control sequence
+% \cmd\abstract\ which saves its argument inside \cmd{\tpj@info@Abstract}.
+%
+% All commands are defined \cmd\long\ so that paragraphs are
+% allowed. This is much easier than
+% |\begin{abstract}...\end{abstract}| contortions
+% (cf. \texttt{ltugboat.cls}).
+% \begin{macrocode}
+\newcommand\tpj@define@info@block[2][]{%
+ \lowercase{\expandafter\long\expandafter\def\csname#2\endcsname}%
+ ##1{\expandafter\def\csname tpj@info@#2\endcsname{##1}}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\clearinfo}
+% If the \cmd{\tpj@optional@author@info} macro needs to be cleared for some reason,\footnotemark
+% the \cmd\clearinfo\ command will come quite in handy. This command is also used to
+% initialise the macro in question.
+% \footnotetext{The only reason I can think of to do this is to re-arrange the order of
+% the items in the title block of the article.}
+% \changes{v0.4d}{2005/07/30}{WR: Implemented to allow for re-definition of standard information blocks.}
+% \begin{macrocode}
+\newcommand\clearinfo{\let\tpj@optional@author@info\@empty}
+\clearinfo
+% \end{macrocode}
+% \end{macro}
+%
+% \paragraph{Optional fields}
+%
+% These are the default information blocks.
+% \cmd\typesetemail\ is defined by one of either \cmd\hyperlinkemail\ or \cmd\obfuscateemail.
+%
+% \begin{macrocode}
+\addinfo[\typesetemail]{Email}
+\addinfo[\url]{Website}
+\addinfo[\linespread{0.9}\selectfont]{Address}
+% \end{macrocode}
+%
+% \paragraph{Abstract} We bypass \cmd\addinfo\
+% so that the abstract info block is not added
+% to the \cmd{\tpj@optional@author@info} macro.
+%
+% The abstract block itself is called directly in \cmd{\@maketitle}.
+%
+% \begin{macrocode}
+\tpj@define@info@block{Abstract}
+% \end{macrocode}
+%
+% \begin{macro}{\noabstract}
+% However, the abstract may indeed be suppressed if that is the author's wish.
+% \changes{v0.4d}{2005/07/25}{WR: Implemented to turn off the abstract.}
+% \begin{macrocode}
+\newif\iftpj@noabstract
+\newcommand\noabstract{\tpj@noabstracttrue}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\endabstract}
+% If an abstract environment is used, give an error. Maybe I should
+% just support the environment, instead.
+% \begin{macrocode}
+\def\endabstract{%
+ \ClassError{pracjourn}
+ {Please input the abstract with \string\abstract{...}, before \string\begin{document}}
+ {Instead of the \string\begin{abstract}...\string\end{abstract} \MessageBreak
+ environment, use \string\abstract{...}. Paragraphs are allowed!\MessageBreak
+ \MessageBreak
+ Because the abstract is typeset with the title block, \MessageBreak
+ it must be input before the \string\begin{document}\space command.}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\TPJissue}
+% \changes{v0.4k}{2006/02/20}{WR: More user-friendly.}
+% \begin{macro}{\TPJrevision}
+% \changes{v0.4k}{2006/02/20}{WR: More user-friendly.}
+% \begin{macro}{\TPJcopyright}
+%
+% \changes{v0.3}{2004/01/03}{AO: add commands specifying issue,
+% revision, copyright.}
+%
+% The three user-level commands
+% \cmd\TPJissue, \cmd\TPJrevision, and \cmd\TPJcopyright{} specify
+% the issue, the revision, and the copyright information of the
+% document.
+%
+% Since these commands are like \cmd\author{} and \cmd\title, one
+% might wish to disable them upon executing the \cmd\titlepage{}
+% procedure. But we do not.
+%
+% If the document has a \cmd\TPJrevision{} statement, the title page
+% header contains words to that effect, otherwise it bears the current
+% date.
+%
+% If the document lacks a \cmd\TPJcopyright{} statement, the title
+% page footer contains nothing.
+% \begin{macrocode}
+\newcommand{\TPJissue}[2]{\gdef\@TPJissue{\TPJ, #1, No.\,#2}}%
+\newcommand{\TPJrevision}[3]{\gdef\@TPJrevision{#1/#2/#3}}%
+\newcommand{\TPJcopyright}[1]{\gdef\@TPJcopyright{#1}}%
+\let\@TPJissue\@empty
+\let\@TPJrevision\@empty
+\let\@TPJcopyright\@empty
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\license}
+%
+% For consistency with the other user commands of this class, \cmd\license\
+% is defined as an alias of \cmd\TPJcopyright.
+%
+% \changes{v0.4d}{2005/07/30}{WR: name change from \cmd\TPJcopyright\
+% for consistency with other commands.}
+%
+% \begin{macrocode}
+\let\license\TPJcopyright
+% \end{macrocode}
+%
+% \end{macro}
+%
+% \begin{macro}{\tpj@info@container}
+% This is the macro that typesets the optional author info for
+% fields defined as above. It splits it all up in minipages, in a
+% smaller font and with more compressed leading than the main
+% document text.\footnote{\LaTeX's \cmd\@hangfrom\ (or whatever it is) could well
+% have been much easier.} It takes the name of the info as a mandatory
+% argument, which is used to typeset the info label as well as
+% retrieve the actual data from the |\tpj@info@#1| macro (see
+% \cmd{\addinfo}).
+%
+% An optional argument is used as a hook to typeset the info data in
+% the equivalent form |#1{#2}|.
+%
+% For example, to typeset the info defined by the author in the
+% \cmd\abstract\ (recall, this is set up due to a corresponding
+% |\addinfo{Abstract}|---see above), input
+% |\tpj@info@container{Abstract}|. To typeset it, say, in italics,
+% it would be possible to write
+% |\tpj@info@container[\textit]{Abstract}|.
+%
+% \changes{v0.4a}{2005/06/13}{WR: Implemented for new \cmd\@maketitle.}
+% \changes{v0.4d}{2005/06/29}{WR: Warn if a title block command is used after \cmd\maketitle.}
+%
+% \begin{macrocode}
+\newcommand\tpj@info@container[2][]{%
+% \end{macrocode}
+% After \cmd\maketitle, redefine the info command to return an error.
+% \begin{macrocode}
+ \lowercase{\expandafter\gdef\csname#2\endcsname}%
+ {\ClassError{pracjourn}{#2 must be defined BEFORE \string\maketitle}{}}
+% \end{macrocode}
+% Now, we typeset the info block, but only if the info has actually been specified by the author.
+% \begin{macrocode}
+ \expandafter\ifx\csname tpj@info@#2\endcsname\relax\else
+ \noindent\null\hfill\small
+% \end{macrocode}
+% On the left, right-aligned sans serif item label, e.g., `Abstract':
+% \begin{macrocode}
+ \begin{minipage}[t]{0.1\textwidth}
+ \noindent\hfill\sffamily#2
+ \end{minipage}\hfill
+% \end{macrocode}
+% On the right, the content, defined by, e.g., \cmd\abstract:
+% \begin{macrocode}
+ \begin{minipage}[t]{0.85\textwidth}
+ \linespread{1.0}\selectfont
+ \setlength\parindent{1.5em}%
+ \noindent\ignorespaces
+ \expandafter#1\expandafter{\csname tpj@info@#2\endcsname}
+ \end{minipage}\par
+ \fi}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Email \& hyperlink macros}
+%
+% \begin{macro}{\typesetemail}
+%
+% We define the macro \cmd\typesetemail\ to be used for self-explanatory purposes.
+% The class contains methods to define it in one of two ways.
+%
+% \begin{macro}{\hyperlinkemail}
+%
+% The \cmd\hyperlinkemail\ command defines \cmd\typesetemail\ to use the \pkg{hyperref}
+% package's facilities to create a hyperlink email address in the output document.
+%
+% \begin{macro}{\obfuscateemail}
+%
+% The \cmd\obfuscateemail\ command defines \cmd\typesetemail\ to use the \pkg{switcheml}
+% package's facilities to create a machine-obfuscated email address in the output
+% document.\footnote{The \pkg{switcheml} package defines, among a couple of other things, a macro for
+% typesetting email addresses that obfuscates their representation in the PDF file,
+% ensuring protection against harvesting email addresses from web-public
+% PDF documents.}
+%
+% \begin{macrocode}
+\newcommand\obfuscateemail{%
+ \def\typesetemail##1{\ttfamily\switchemail{##1}}}
+\newcommand\hyperlinkemail{%
+ \def\typesetemail##1{\ttfamily\tpj@compose@mailto{##1}{Re: PracTeX Journal article}{##1}}}
+% \end{macrocode}
+% \end{macro}\end{macro}\end{macro}
+%
+% \begin{macro}{\tpj@compose@mailto}
+%
+% This macro takes three arguments to typeset a mailto email
+% hyperlink. The |#1| takes the email address, |#2| takes the
+% default subject of the email, and |#3| is the text to appear in
+% the output as the hyperlink.
+%
+% All spaces in the hyperlink source are converted to |%20| to
+% accommodate Mac~OS~X's PDF reader; this isn't necessary for Adobe
+% Reader. Oh well.
+%
+% \changes{v0.4b}{2005/06/26}{WR: Implemented; creates a workable mailto
+% hyperlink.}
+%
+% \begin{macrocode}
+\newcommand\tpj@compose@mailto[3]{%
+ \edef\@tempa{mailto:#1?subject=#2 }%
+ \edef\@tempb{\expandafter\html@spaces\@tempa\@empty}%
+ \href{\@tempb}{#3}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\html@spaces}
+% \changes{v0.4b}{2005/06/25}{WR: Implemented to overcome the mailto
+% problems in Mac~OS~X's PDF reader.}
+
+% This macro takes a string and (hopefully) converts all spaces (or
+% is it all whitespace?) to `\%20', creating a string that can be
+% used for encoding the subject of the email comments hyperlink in
+% \cmd{\titlepage@head}. Using \cmd\catcode, we remove the comment
+% ability of the \verb|%| character, making it a normal letter.
+% (This code was heavily influenced by the \LaTeX\ kernel's
+% \cmd{\zap@space} command.)
+% \begin{macrocode}
+\catcode`\%=11
+\def\html@spaces#1 #2{#1%20\ifx#2\@empty\else\expandafter\html@spaces\fi#2}
+\catcode`\%=14
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{User commands}
+%
+% \begin{macro}{\note}
+% \begin{macro}{\dash}
+% \begin{macro}{\ctanfile}
+% \begin{macro}{\ctanloc}
+% Fairly straightforward.
+% \begin{macrocode}
+\newcommand\note[1]{\unskip\footnote{#1}}
+\DeclareRobustCommand\dash{%
+ \unskip\nobreak\thinspace\textemdash\thinspace\ignorespaces}
+\pdfstringdefDisableCommands{\renewcommand{\dash}{ - }}
+\newcommand\ctanfile[1]{%
+ \href{http://www.ctan.org/get?fn=/#1}
+ {\path{CTAN:#1}}}
+\newcommand\ctanloc[1]{%
+ \href{http://www.ctan.org/tex-archive/#1}
+ {\path{CTAN:#1}}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \subsubsection{Logos}
+%
+% \changes{v0.4a}{2005/06/05}{WR: Incorporated code from \pkg{texnames}
+% and \pkg{mflogo}.}
+%
+% The \pkg{texnames} and \pkg{mflogo} packages have been incorporated
+% into the class in order to remove the dependence on external
+% packages and to tune the logos for Palatino. First, here are the
+% relevant parts\footnote{No-one still refers to AMSTeX and SLITeX and
+% so on, right?} of \texttt{texnames.sty}, v1.10, tuned for Palatino
+% and adapted to use \cs{textsc} where appropriate:
+% \begin{macrocode}
+\DeclareRobustCommand\TeX{T\kern-.15em\lower.5ex\hbox{E}\kern-.07em X\spacefactor1000\relax}
+\DeclareRobustCommand\LaTeX{L\kern-.32em\raise.37ex\hbox{\scalebox{0.76}{A}}\kern-.15em\TeX}
+\DeclareRobustCommand\LaTeXe{\LaTeX2$_{\textstyle\varepsilon}$}
+\DeclareRobustCommand\BibTeX{B{\textsc i\kern-.025em\textsc b}\kern-.08em\TeX}
+% \end{macrocode}
+% And now \texttt{mflogo.sty}, unchanged in its entirety:
+% \begin{macrocode}
+\DeclareRobustCommand\logofamily{%
+ \not@math@alphabet\logofamily\relax
+ \fontencoding{U}\fontfamily{logo}\selectfont}
+\DeclareTextFontCommand{\textlogo}{\logofamily}
+\DeclareRobustCommand\MF{\textlogo{META}\@dischyph\textlogo{FONT}\@}
+\DeclareRobustCommand\MP{\textlogo{META}\@dischyph\textlogo{POST}\@}
+% \end{macrocode}
+% Now some new definitions. Despite the fact that it makes no
+% difference with the main font used for this class, I define
+% \cs{pdfTeX} with some italic correction to set a good
+% precedent. Compare Computer Modern with and without:
+% {\usefont{OT1}{cmr}{m}{n}pdf\/\TeX}
+% vs.~{\usefont{OT1}{cmr}{m}{n}pdf\TeX}; I find the former more
+% attractive because the ascender of the `f' doesn't collide.
+% \begin{macrocode}
+\DeclareRobustCommand\ConTeXt{C\kern-.03em on\-\kern-.10em\TeX\kern-0.04em t}%
+\DeclareRobustCommand\pdfTeX{pdf\/\TeX}
+\DeclareRobustCommand\pdfLaTeX{pdf\/\LaTeX}
+\DeclareRobustCommand\PS{PostScript}
+\DeclareRobustCommand\PracTeX{Prac\kern-0.07em\TeX}
+\DeclareRobustCommand\TPJ{The \PracTeX\ Journal}
+\DeclareRobustCommand\XeTeX{%
+ X\lower.5ex\hbox{\kern-.07em\reflectbox{E}}%
+ \kern-.15em\TeX}
+\DeclareRobustCommand\ExTeX{\textrm{\relax
+ \ensuremath{\textstyle\varepsilon_{\kern-0.15em\mathcal{X}}}\relax
+ \kern-.15em\TeX}}
+% \end{macrocode}
+% \changes{v0.4j}{2006/02/09}{Added \cmd\XeTeX\ logo.}
+% \changes{v0.4k}{2006/02/09}{Added \cmd\ExTeX\ logo.}
+%
+% \subsubsection{Version tracking}
+%
+% \begin{macro}{\write@ID@aux}
+% \changes{v0.3}{2004/01/03}{AO: add ID file}
+% Establish an auxiliary file, \verb+_id.tex+, for TPJ tracking information.
+%
+% \begin{macrocode}
+\def\write@ID@aux{%
+ \@ifx@empty\@TPJrevision{}{%
+ \begingroup
+ \let\thanks\@gobble
+ \immediate\openout\ID@aux _rev.tex
+% \immediate\write\ID@aux{\@percentchar\space
+% This file generated by the pracjourn document class}%
+ \immediate\write\ID@aux{\@TPJrevision}%
+ \immediate\closeout\ID@aux
+ \endgroup
+ }%
+}%
+\newwrite\ID@aux
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\read@iss@aux}
+% \begin{macrocode}
+\def\read@issue{%
+ \openin\@inputcheck _iss.tex
+ \@ifeof\@inputcheck{}
+ {\ifx\@TPJissue\@empty\else
+ \typeout{---------^^J
+ pracjourn: \protect\TPJissue\space info overwritten due to _iss.tex file^^J
+ ---------}
+ \fi
+ \read\@inputcheck to\@TPJissue
+ \closein\@inputcheck
+ \expandafter\parse@iss\@TPJissue\@nil}}
+% \end{macrocode}
+% \changes{v0.3}{2004/01/03}{AO: read the "issue" file.}
+% \changes{v0.4i}{2006/02/02}{WR: {\ttfamily\char`\_iss.tex} behaviour finally sorted out.}
+% \end{macro}
+%
+% \begin{macro}{\parse@iss}
+% \changes{v0.4k}{2006/02/20}{WR: Implemented for better article headers.}
+% \begin{macrocode}
+\def\parse@iss TPJ #1 No #2, #3-#4-#5\@nil{%
+ \@tempcnta#2\relax
+ \protected@xdef\@TPJissue{\TPJ, #1, No.\,\the\@tempcnta}}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Miscellaneous}
+%
+% \begin{macro}{\set@pdfpage}
+% \changes{v0.3}{2004/01/03}{AO: add commands setting pdftex's page
+% metrics from LaTeX's}
+%
+% The PDF\TeX{} parameters \cmd\pdfpagewidth\ and
+% \cmd\pdfpageheight\ determine the
+% CropBox/BleedBox/TrimBox/ArtBox. The procedure \cmd\setpdfpage{}
+% sets them to the values of the \LaTeX{} \cmd\paperwidth{} and
+% \cmd\paperheight. If PDF\TeX{} is not the engine, nothing is
+% done.
+%
+% We arrange for the procedure to be executed at Begin Document
+% time.
+% \begin{macrocode}
+\def\set@pdfpage{%
+ \@ifx@undefined\pdfoutput{}{%
+ \pdfpagewidth =\paperwidth
+ \pdfpageheight=\paperheight
+ \relax}}
+\AtBeginDocument{\set@pdfpage}
+% \end{macrocode}
+% \end{macro}
+%
+% \makeatother
+% \CharacterTable
+% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+% Digits \0\1\2\3\4\5\6\7\8\9
+% Exclamation \! Double quote \" Hash (number) \#
+% Dollar \$ Percent \% Ampersand \&
+% Acute accent \' Left paren \( Right paren \)
+% Asterisk \* Plus \+ Comma \,
+% Minus \- Point \. Solidus \/
+% Colon \: Semicolon \; Less than \<
+% Equals \= Greater than \> Question mark \?
+% Commercial at \@ Left bracket \[ Backslash \\
+% Right bracket \] Circumflex \^ Underscore \_
+% Grave accent \` Left brace \{ Vertical bar \|
+% Right brace \} Tilde \~}
+%
+% \Finale
+\endinput
diff --git a/Master/texmf-dist/source/latex/pracjourn/pracjourn.ins b/Master/texmf-dist/source/latex/pracjourn/pracjourn.ins
new file mode 100644
index 00000000000..4fa932030c6
--- /dev/null
+++ b/Master/texmf-dist/source/latex/pracjourn/pracjourn.ins
@@ -0,0 +1,45 @@
+%% This file will generate documentation and runtime files
+%% from pracjourn.dtx when run through LaTeX or TeX.
+%% See copyright notice below.
+\input docstrip
+\keepsilent
+\usedir{tex/latex/pracjourn}
+
+\preamble
+
+This is a generated file.
+
+Copyright (C) 2004 TeX Users Group.
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+\endpreamble
+\askforoverwritefalse
+\generate{%
+ \file{pracjourn.cls}{\from{pracjourn.dtx}{class}}%
+}%
+
+\Msg{***********************************************************}
+\Msg{*}
+\Msg{* To finish the installation, please move}
+\Msg{* \space\space pracjourn.cls}
+\Msg{* into a directory searched by TeX.}
+\Msg{*}
+\Msg{* To produce the documentation, run pracjourn.dtx through LaTeX.}
+\Msg{*}
+\Msg{* Happy TeXing!}
+\Msg{***********************************************************}
+
+\endbatchfile