new package pracjourn (8mar06)

git-svn-id: svn://tug.org/texlive/trunk@1878 c570f23f-e606-0410-a88d-b1316a301751

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