%%% ===================================================================
%%%  @LaTeX-file{
%%%     filename = "uwalet.dtx",
%%%     version  = "2.0a",
%%%     date     = "1998/04/07",
%%%     time     = "13:20:42 WST",
%%%     checksum = "02165 737 3479 32108"
%%%     author   = "Greg Gamble",
%%%     address  = "Department of Mathematics,
%%%                 University of Western Australia,
%%%                 Nedlands, W.A. 6907,
%%%                 Australia",
%%%     telephone = "+61 8 9380 3340,"
%%%     FAX       = "+61 8 9380 1028",
%%%     copyright = "Copyright (C) 1996 Greg Gamble,
%%%                  all rights reserved.  Copying of this file is
%%%                  authorised only if either:
%%%                   (1) you make absolutely no changes to your copy,
%%%                       including name; OR
%%%                   (2) if you do make changes, you first rename it
%%%                       to some other name.",
%%%     email     = "gregg@maths.uwa.edu.au (Internet)",
%%%     codetable = "ISO/ASCII",
%%%     keywords  = "latex, amslatex, ams-latex, installation",
%%%     supported = "yes",
%%%     abstract  = "This is class \cls{uwalet}. It is built on the
%%%                  standard letter class with option \opt{a4paper},
%%%                  but we adjust \cn{textheight} and \cn{topmargin}
%%%                  slightly, to use more of the page. We define the 
%%%                  macros \cn{fax}, \cn{email} and \cn{www} to provide 
%%%                  for Fax no., email and World Wide Web addresses 
%%%                  that appear in the letterhead. Also, \cn{name} and
%%%                  \cn{address} appear in the letterhead, along with
%%%                  the logo of The University of Western Australia.
%%%                  The default arguments for these macros are as follows
%%%                     \cn{name}:                %(null)
%%%                     \cn{address}: Department of Mathematics\\
%%%                                   Nedlands, Western Australia 6907
%%%                     \cn{telephone}: +61 8 9380 3340
%%%                     \cn{fax}:       +61 8 9380 1028
%%%                     \cn{email}:               %(null)
%%%                     \cn{www}:     {}www.maths.uwa.edu.au/
%%%                  The user may redefine any of these.",
%%%     docstring = "The checksum field above contains a CRC-16
%%%                  checksum as the first value, followed by the
%%%                  equivalent of the standard UNIX wc (word
%%%                  count) utility output of lines, words, and
%%%                  characters.  This is produced by Robert
%%%                  Solovay's checksum utility.",
%%%  }
%%% ===================================================================
%
% \iffalse
%<*driver>
\documentclass{amsdtx}
\EnableCrossrefs
\CodelineIndex
\RecordChanges
\begin{document}
\title{The \cls{uwalet} class}
\author{Greg Gamble}
\date{Version \fileversion, \filedate}
\hDocInput{uwalet.dtx}
\end{document}
%</driver>
% \fi
%
% \maketitle
% \tableofcontents
% \markboth{THE \cls{UWALET} CLASS}{}
%
% \changes{v1.0}{96/07/04}{First release}
% \changes{v1.0a}{96/09/19}{We use package \pkg{graphicx}
%                           in lieu of package \pkg{epsf}}
% \changes{v1.0b}{96/12/20}{Added option \opt{resreport}
%                           to generate the first page for 
%                           Research Reports as well as generate
%                           a letter to the AustMS Gazette to
%                           include a notice of the report
%                           as suggested by Alice Niemeyer}
% \changes{v1.0b}{96/12/20}{Added \cn{fullmonthname} and \cn{oztoday}
%                           as suggested by Alice Niemeyer}
% \changes{v1.0b}{96/12/20}{The default address was altered to
%                           abbreviate `Western Australia' to `WA'
%                           as suggested by Alice}
% \changes{v1.0c}{97/01/22}{Added option \opt{consgroup} to generate
%                           an alternative letterhead for Consulting
%                           Groups}
% \changes{v1.0c}{97/01/23}{Altered fontsize for block containing
%                           Tel, Fax, email and WWW in letterhead
%                           to \cn{footnotesize} as suggested by
%                           Adrian Baddeley}
% \changes{v1.0d}{97/01/27}{Added option \opt{manager} to provide
%                           a variation on the letterhead that puts
%                           the manager's \cn{name} and \cn{role}
%                           below the logo}
% \changes{v1.0e}{97/06/05}{Changed phone and fax numbers to
%                           the new 8 digit numbers and changed
%                           the area codes}
% \changes{v2.0}{98/03/27}{Changes made affecting the letterhead
%                           owing to change of logo. Some defaults
%                           were changed: `WA' abbreviation in default
%                           address changed to `Western Australia',
%                           and some punctuation was removed;
%                           WWW URL default no longer leads with `http://'}
% \changes{v2.0a}{98/04/07}{When \cn{www} is given a URL beginning
%                           with \fn{www} the WWW address is not set
%                           correctly in the letterhead. This is very curious!
%                           To fix this problem \cn{WWW} had, in the
%                           previous version, been set to include braces
%                           before the URL. This fixed the problem
%                           but created another -- empty URLs were
%                           no longer detected. So the default value
%                           of \cn{www} is now \fn{{}www.maths.uwa.edu.au}
%                           and \cn{WWW} doesn't insert the braces.}
%                           
%
% \makeatletter
% \DoNotIndex{\@date,\@empty,\@oddfoot,\@oddhead,\ps@firstpage}
% \DoNotIndex{\@andlista,\@andlistb,\@andlistc,\@asabove,\@authors}
% \DoNotIndex{\@dblarg,\@emptytoks,\@iden,\@ifempty,\@ifnotempty}
% \DoNotIndex{\@maketitle,\@nx,\@resreporttrue,\@setshortaddresses}
% \DoNotIndex{\@title,\@topnum,\@xp,\c@footnote,\g@addto@macro}
% \DoNotIndex{\if@resreport,\toks@,\toks@address,\toks@author,\z@}
% \DoNotIndex{\@subjclass,\@consgrouptrue,\@picoffset,\if@consgroup}
% \DoNotIndex{\@managertrue,\if@manager,\left@width,\right@width}
% \makeatother
%
% \section{Introduction}
%    The file \fn{uwalet.dtx} is the master file for the \latex/
%    class, \cls{uwalet}, which provides a letter class
%    for \latex/ users in the Department of Mathematics at the
%    University of Western Australia. It is built on the
%    standard letter class with option \opt{a4paper},
%    but we adjust \cn{textheight} and \cn{topmargin}
%    slightly, to use more of the page. We define the 
%    macros \cn{fax}, \cn{email} and \cn{www} to provide 
%    for Fax no., email and World Wide Web addresses 
%    that appear in the letterhead. Also, \cn{name},
%    \cn{address} and \cn{telephone} appear in the letterhead, 
%    along with the logo of The University of Western Australia.
%    Each of these letterhead field macros has a default value
%    so that it is not necessary for a user to set any of them,
%    but it is expected that most users will want to reset
%    the \cn{name} and \cn{email} macros, which by default are empty.
%
%    Alternative letterheads are provided by options \opt{consgroup}
%    and \opt{manager}. Option \opt{consgroup} is intended for 
%    Consulting Groups; under the option, two further commands
%    are defined: \cn{groupname} and \cn{director} for the name
%    and director of the Consulting Group. 
%
%    Option \opt{manager} is intended for those with a special role 
%    within the department, e.g.\ \emph{Head of Department}. 
%    Under the option, the command \cn{role} is provided, and
%    \cn{name} and \cn{role} appear under the university logo.
%
%    If \fn{uwalet.dtx} is used with the option \opt{resreport}
%    the titlepage for a Research Report is generated along with
%    a letter to the Australian Mathematical Society Gazette
%    that requests the inclusion of a notice advertising the Report
%    in their next issue. Under this option the user must specify
%    the \cn{title} and \cn{author} and \cn{Address} for each
%    author of the report. Note that the address of the sender of
%    the letter to the Gazette is defined by \cn{address} (\emph{not}
%    \cn{Address} which is only defined if \opt{resreport} is active).
%
%    It is recommended that users specify 
%    \begin{quote}\slshape
%      \verb|\pagestyle{headings}|
%    \end{quote}
%    to put addressee, date and page number in the header of pages
%    subsequent to the first page of the letter. 
%
% \StopEventually{
%    \begin{thebibliography}{9}
%      \addcontentsline{toc}{section}{\numberline{}Bibliography}
%      \bibitem{Companion} M.~Goossens, F.~Mittelbach, and A.~Samarin,
%        \emph{The \latex/ Companion} (Addison-Wesley, 1994).
%      \bibitem{LaTeX} L.~Lamport, 
%        \emph{\latex/ -- A Document Preparation System} 
%        (Addison-Wesley, first ed., 1985). Describes \latex/ 2.09.
%      \bibitem{LaTeXe} L.~Lamport, 
%        \emph{\latex/ -- A Document Preparation System} 
%        (Addison-Wesley, second ed., 1994). Updated for \LaTeXe.
%      \bibitem{clsguide} The \latex/3 Project,
%        \emph{\LaTeXe\ for class and package writers} (Jun.\ 1996).
%        Filename: \fn{clsguide.dvi}.
%    \end{thebibliography}
%    \pagebreak
%    \addcontentsline{toc}{section}{\numberline{}Index}
%    \DisableCrossrefs
%    \PrintIndex 
%    \addcontentsline{toc}{section}{\numberline{}Change History}
%    \PrintChanges
% }
%
% \section{Implementation}
%    The usual name, date, and version information.
%    \begin{macrocode}
\typeout{uwalet 2.0a}
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{uwalet}[1998/04/07 v2.0a]
%    \end{macrocode}
%    We build the class \cls{uwalet} on top of \latex/'s
%    \cls{letter} class with option \opt{a4paper} but we
%    prefer to use a little more of the page. Also we declare
%    the options \opt{consgroup} and \opt{resreport}; the latter we describe 
%    in more detail in Section~\ref{sec:resrep} below.
%    \begin{macrocode}
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{letter}}
\newif\if@resreport
\DeclareOption{resreport}{\@resreporttrue}
\newif\if@consgroup
\DeclareOption{consgroup}{\@consgrouptrue}
\newif\if@manager
\DeclareOption{manager}{\@managertrue}
\ProcessOptions\relax
\LoadClass[a4paper]{letter}
\advance\textheight by 25mm
\advance\topmargin by -12.5mm
%    \end{macrocode}
%    To set the logo we need the graphics package \pkg{graphicx}.
%    \begin{macrocode}
\RequirePackage{graphicx}
%    \end{macrocode}
%    We provide \cn{fax}, \cn{email} and \cn{www} for setting the
%    Fax number, email address and World Wide Web URL, respectively, 
%    in the letterhead.
%    \begin{macrocode}
\newcommand*{\fax}[1]{\def\faxnum{#1}}
\newcommand*{\email}[1]{\def\Email{#1}}
\newcommand*{\www}[1]{\def\WWW{#1}}
%    \end{macrocode}
%    If the option \opt{consgroup} is active we define \cn{groupname}
%    and \cn{director}.
%    \begin{macrocode}
\if@consgroup%
  \newcommand*{\groupname}[1]{\def\consgpname{#1}}
  \newcommand*{\director}[1]{\def\consdirector{#1}}
\fi
%    \end{macrocode}
%    If the option \opt{manager} is active we define \cn{role}.
%    \begin{macrocode}
\if@manager%
  \newcommand*{\role}[1]{\def\mgrrole{#1}}
\fi
%    \end{macrocode}
%    We provide \cn{fullmonthname} and \cn{oztoday} to provide
%    other alternatives for \cn{date}, e.g.\
%    \begin{quote}\slshape
%      \verb+\date{\oztoday}+
%    \end{quote}
%    will cause the date to appear in \emph{the} Australian style,
%    rather than the default American style.
%    \begin{macrocode}
\newcommand{\fullmonthname}{%
  \relax\ifcase\month\or
    January\or February\or March\or April\or May\or June\or
    July\or August\or September\or October\or November\or December\fi}
\newcommand{\oztoday}{\number\day\space\fullmonthname\space\number\year}
%    \end{macrocode}
%    The macro \cn{name}, which is also set in the letterhead,
%    is already provided by the \latex/ \cls{letter} class. 
%    By default it is already set as null, so we do nothing. 
%    Also, \cn{address} and \cn{telephone} are
%    provided by the \latex/ \cls{letter} class. We give them the
%    following default values.
%    \begin{macrocode}
\address{Department of Mathematics\\
         Nedlands, Western Australia 6907}
\telephone{+61 8 9380 3340}
%    \end{macrocode}
%    Now we provide default values for \cn{fax}, \cn{email} and
%    \cn{www}.
%    \begin{macrocode}
\fax{+61 8 9380 1028}
\email{}
\www{{}www.maths.uwa.edu.au/}
%    \end{macrocode}
%    If option \opt{consgroup} is active we give the following 
%    defaults for \cn{groupname} and \cn{director}.
%    \begin{macrocode}
\if@consgroup%
  \groupname{The University of Western Australia}
  \director{}
\fi
%    \end{macrocode}
%    If option \opt{manager} is active we define \cn{role} to be
%    blank by default.
%    \begin{macrocode}
\if@manager%
  \role{}
\fi
%    \end{macrocode}
%    The user is free to alter any of the letterhead field macros,
%    which are:
%    \begin{quote}
%      \cn{name}, \cn{address}, \cn{telephone}, \cn{fax},
%      \cn{email} and \cn{www}; and \cn{groupname} and \cn{director}
%      (if option \opt{consgroup} is active); and \cn{role}
%      (if option \opt{manager} is active).
%    \end{quote}
%    There is no macro for a Telex number (obsolete?).
%    Note that if the macro \cn{signature}, which is normally set
%    (if option \opt{resreport} is not active) 
%    in the \cn{closing}, is empty, then \cn{name}
%    is used instead of \cn{signature} in the \cn{closing} 
%    (see the definition of \cn{closing} below -- note that the 
%    macro \cn{name} defines \cn{fromname} and \cn{signature} defines 
%    \cn{fromsig}). If option \opt{resreport} is active the sender's
%    name is omitted entirely.
%
%    Now we provide the code that sets the letterhead. Note we use
%    the \env{picture} environment to make \latex/ treat the 
%    letterhead as if it were 10 points high, so headers on subsequent
%    pages are appropriately placed.
%    \begin{macrocode}
\renewcommand{\ps@firstpage}{%
  \renewcommand{\@oddhead}{%
    \begin{picture}(250,10)(0,0)
      \if@consgroup%
        \put(0,0){\begin{picture}(250,10)%
         \begin{minipage}[t]{\textwidth}
          {\large\bfseries\itshape\consgpname}\\
          \xdef\@picoffset{-33}%
          \if\@empty\consdirector\relax%
          \else\textsf{Director:} \consdirector\\\relax%
             {\xdef\@picoffset{-50}}%
          \fi
          \vrule width0pt\hrulefill\vrule width0pt\\
         \end{minipage}
        \end{picture}}
      \else%
        \xdef\@picoffset{0}
      \fi%
      \newlength{\left@width}
      \setlength{\left@width}{200pt}
      \newlength{\right@width}
      \setlength{\right@width}{\textwidth}
      \addtolength{\right@width}{-\left@width}
      \put(0,\@picoffset){\begin{minipage}[t]{\left@width}
        \null
        \includegraphics*[width=180pt]{uwalogo.ps}
        \if@manager%
           \if\@empty\fromname\relax\else\textit{\fromname}\\\fi
           \if\@empty\mgrrole\relax\ \else\textit{\mgrrole}\fi
        \fi%
       \end{minipage}
       \begin{minipage}[t]{\right@width}
        \renewcommand{\baselinestretch}{0.9}\small
        \begin{list}{}\item%
           \if@manager\else%
            \if\@empty\fromname\relax\else\fromname\\\fi%
           \fi
           \if\@empty\fromaddress\relax\ \else\fromaddress\fi
        \end{list}
        \renewcommand{\baselinestretch}{0.8}\footnotesize
        \begin{list}{}\item%
           \if\@empty\telephonenum\relax\else\textsf{Telephone:\quad}\telephonenum\\\fi
           \if\@empty\faxnum\relax%
	      \else\textsf{\rlap{Facsimile:}\hphantom{Telephone:\quad}}\faxnum\\\fi
           \if\@empty\Email\relax       
	      \else\textsf{\rlap{email:}\hphantom{WWW:}}\nobreak~\texttt{\Email}\\\fi
           \if\@empty\WWW\relax         \else\textsf{WWW:}\nobreak~\texttt{\WWW}\fi
           \newline\vrule width0pt\hrulefill\vrule width0pt\\
           \normalsize\@date
        \end{list}%
       \end{minipage}}
    \end{picture}}
    \renewcommand{\@oddfoot}{}
  }
%    \end{macrocode}
%    We simplify \cn{opening} somewhat as the (from) address is
%    already in the letterhead. We need to put some whitespace,
%    because \latex/ thinks the letterhead is only 10 points high.
%    \begin{macrocode}
\renewcommand*{\opening}[1]{%
  \thispagestyle{firstpage}%
  \vspace*{90pt}%
  {\raggedright \toname \\ \toaddress \par}%
  \vspace{2\parskip}%
  #1\par\nobreak}
%    \end{macrocode}
%    We simplify \cn{closing} a little \dots\ essentially we force
%    \latex/ to set the closing midpage rather than flush left.
%    When option \opt{resreport} is active we omit the sender's
%    name entirely.
%    \begin{macrocode}
\renewcommand{\closing}[1]{\par\nobreak\vspace{\parskip}%
  \stopbreaks
  \noindent
  \hspace*{\longindentation}
  \parbox{\indentedwidth}{\raggedright
       \ignorespaces #1%
        \if@resreport\else%
           \\[6\medskipamount]%
           \ifx\@empty\fromsig
               \fromname
           \else \fromsig \fi\strut%
        \fi}%
   \par}
%    \end{macrocode}
% \section{Option \opt{resreport}}\label{sec:resrep}
%    Now we define the macros we need under option \opt{resreport},
%    which are used to generate a titlepage for Research Reports.
%    These have been taken with slight modification from the
%    \cls{amsart} document class. Note that the standard \latex/ \cn{title}
%    macro is ok for the title of the research report \dots so we don't 
%    need to define it here. The authors of the research report and their
%    respective addresses are specified by a sequence of \cn{author}
%    and \cn{Address} declarations.
%    We use \cn{Address} in lieu of \cn{address} here, since \cn{address}
%    is already used for the sender's address of the accompanying letter
%    (to the Australian Mathematical Society Gazette).
%    The \cn{author} macro takes one or two arguments; the optional
%    argument allows one to give an abbreviation of the author's name, where
%    desired. For convenience there is an \cn{asabove} macro which may
%    and \emph{should} be used if the address of an author is the same
%    as that of the most recent previously specified author. As well,
%    there are \cn{reportnumber} and \cn{reportmonth}, so that the user may
%    specify, as one might expect, the report's number and month. 
%
%    Other macros are not specified by the user: \cn{authors} lists the
%    unabbreviated authors names (with commas and the word \emph{and} in
%    the appropriate place, where there is more than one author);
%    \cn{shortauthors} is similar to \cn{authors} except that it lists
%    abbreviated authors names; \cn{addresses} lists the sequence of
%    authors with their respective addresses, as specified by the
%    sequence of \cn{author} and \cn{Address} commands; \cn{shortaddresses}
%    is similar to \cn{addresses} except that where the \cn{asabove} macro
%    is used the authors are listed on the one line (with appropriate commas
%    and word \emph{and}) followed by their common address; 
%    \cn{maketitle} sets the report's title, \cn{addresses},
%    \cn{shortauthors}, \cn{reportnumber} and \cn{reportmonth} in the
%    Research Report title page; and \cn{Report} is an abbreviation for 
%    the report's title followed by \cn{shortaddresses}, which is intended
%    to be used in the body of the letter to the Australian Mathematical 
%    Society Gazette. Of the above list, the user only really needs
%    to know about \cn{maketitle} and \cn{Report}.
%    \begin{macrocode}
\if@resreport%
  \RequirePackage{amsmath}
  \newcommand*{\reportnumber}[1]{\def\repnumber{#1}}
  \newcommand*{\reportmonth}[1]{\def\repmonth{#1}}
  \def\subjclass#1{\def\@subjclass{#1}}
  \renewcommand{\author}[2][]{%
    \ifx\@empty\authors
      \gdef\shortauthors{#1}\gdef\authors{#2}%
    \else
      \g@addto@macro\shortauthors{\and#1}%
      \g@addto@macro\authors{\and#2}%
    \fi
    \toks@author={#2}
    \g@addto@macro\addresses{\bigbreak#2\\}%
    }
  \edef\author{\@nx\@dblarg
    \@xp\@nx\csname\string\author\endcsname}
  \newtoks\toks@author  \newtoks\toks@address
  \let\shortauthors\@empty   \let\authors\@empty
  \let\shortaddresses\@empty \let\addresses\@empty
  \let\@authors\@empty       \let\@subjclass=\@empty
  \newcommand{\Address}[1]{\ifx#1\asabove%
                              \@xp\g@addto@macro\@xp\addresses\@xp%
                                 {\the\toks@address}%
                              \@asabove%
                           \else%
                              \g@addto@macro\addresses{#1}%
                              \@setshortaddresses%
                              \toks@address={#1}%
                              \xdef\@authors{\the\toks@author}%
                           \fi}
  \newcommand{\@asabove}{\@xp\g@addto@macro\@xp\@authors\@xp%
                           {\@xp\and\the\toks@author}}
  \def\@setshortaddresses{%
         \ifx\@empty\@authors\else%
            \andify\@authors%
            \ifx\@empty\shortaddresses
               \toks@\@xp\@xp\@xp{\@xp\@authors\@xp\\\the\toks@address}
            \else
               \toks@\@xp\@xp\@xp\@xp\@xp\@xp\@xp{\@xp\@xp\@xp\shortaddresses%
                  \@xp\@xp\@xp\bigbreak\@xp\@authors%
                  \@xp\\\the\toks@address}%
            \fi%
            \xdef\shortaddresses{\the\toks@}%
         \fi}
  \newcommand{\Report}{\@setshortaddresses%
                       ``\@title''
                       \bigbreak
                       \shortaddresses
                       \bigbreak
                       \repmonth\space\repnumber.
                       \bigbreak
                       AMS Subject Classification: \@subjclass.}
  \newcommand{\xandlist}[4]{\@andlista{{#1}{#2}{#3}}#4\and\and}
  \def\@andlista#1#2\and#3\and{\@andlistc{#2}\@ifnotempty{#3}{%
    \@andlistb#1{#3}}}
  \def\@andlistb#1#2#3#4#5\and{%
    \@ifempty{#5}{%
      \@andlistc{#2#4}%
    }{%
      \@andlistc{#1#4}\@andlistb{#1}{#3}{#3}{#5}%
    }}
  \let\@andlistc\@iden
  \newcommand{\nxandlist}[4]{%
    \def\@andlistc##1{\toks@\@xp{\the\toks@##1}}%
    \toks@{\toks@\@emptytoks \@andlista{{#1}{#2}{#3}}}%
    \the\@xp\toks@#4\and\and
    \edef#4{\the\toks@}%
    \let\@andlistc\@iden}
  \newcommand{\andify}{%
    \nxandlist{\unskip, }{\unskip{} and~}{\unskip, and~}}
  \def\and{\unskip{ }and \ignorespaces}
  \def\maketitle{\par
    \@topnum\z@ % this prevents figures from falling at the top of page 1
    \begingroup
      \@maketitle
    \endgroup
    \thispagestyle{empty}%
    \c@footnote\z@
    \def\do##1{\let##1\relax}%
    \do\maketitle \do\@maketitle \do\title
    \do\author \do\address 
    }
  \def\@maketitle{%
    \begin{center}
     \Huge \@title
    \end{center}
    \vspace{4cm}
    \normalfont\normalsize
    \begin{center}
     \addresses
    \end{center}
    \vfill
    \copyright \andify\shortauthors\shortauthors, \repmonth\space\repnumber.
    } % end \@maketitle
\fi
\endinput
%    \end{macrocode}
% \section{A typical letter example}
%    Here is an example of a typical
%    letter. First we must specify the class and fontsize:
%    \begin{quote}\slshape
%      \verb+\documentclass[12pt]{uwalet}+
%    \end{quote}
%    Next comes the preamble information:
%    \begin{quote}\slshape
%      \verb+\pagestyle{headings}+\\
%      \verb+\name{Greg Gamble}+\\
%      \verb+\email{gregg@maths.uwa.edu.au}+\\
%      \verb+\www{maths.uwa.edu.au/\~{ }gregg/}+
%    \end{quote}
%    If your WWW address starts with \texttt{www} please insert
%    a pair of curly braces when defining the \cn{www}, e.g.
%    \begin{quote}\slshape
%      \verb+\www{{}www.maths.uwa.edu.au}+
%    \end{quote}
%    otherwise you will get some rather \emph{odd} effects,
%    which to date I can't explain! Very mysterious!
%    If you wish to specify the date should be set according to the
%    Australian style, rather than the default American style, include:
%    \begin{quote}\slshape
%      \verb+\date{\oztoday}+
%    \end{quote}
%    You won't notice the effect of the \cn{pagestyle} declaration
%    unless your letter is more than one page -- it's optional, of
%    course, but recommended. Note, how to get the tilde in a 
%    World Wide Web URL -- use \verb+\~{ }+. The only letterhead 
%    fields you need to
%    adjust will normally be those given above. It's easy to set
%    any field to be empty, (e.g. \verb+\www{}+ ensures that the
%    World Wide Web URL and the label \textsf{WWW:} normally
%    preceding it are \emph{both} not printed). Note, that if
%    you wish your \cn{closing} signature to look different to
%    \cn{name} then you should set that here as well.
%
%    Now the letter itself \dots\ start the document and open
%    the \env{letter} environment
%    \begin{quote}\slshape
%      \verb+\begin{document}+\\
%      \verb+\begin{letter}{Prof Brian K. Read,\\+\\
%      \verb+               Dept of Elec Eng,\\+\\
%      \verb+               Stanford.}+
%    \end{quote}
%    Notice the \env{letter} environment expects the (to) address
%    as an argument. Beginning the \env{letter} environment sets
%    the letterhead as a side-effect.
%
%    Next is the opening, body of the letter and the closing.
%    \begin{quote}\slshape
%      \verb+\opening{Dear Prof Read,}+\\
%      \verb+BODY TEXT OF LETTER+\\
%      \verb+\closing{Yours Faithfully,}+
%    \end{quote}
%    We set \cn{name} in the preamble but not \cn{signature},
%    so \cn{name} is set in the closing.
%
%    For annotations, we can use \cn{ps}, since the \cn{ps} macro
%    does \emph{not} actually print the ``P.S.''.
%    \begin{quote}\slshape
%      \verb+\ps{ref: GG:1}+
%    \end{quote}
%
%   Now follow the \cn{cc} (for the list of people getting copies of
%   the letter), \cn{encl} (for a list of enclosures -- things
%   accompanying the letter) and a \emph{genuine} ``P.S.'' (Note,
%   that \latex/ doesn't type the ``P.S.'' for you.)
%    \begin{quote}\slshape
%      \verb+\cc{GG}+\\
%      \verb+\encl{C.v.}+\\
%      \verb+\ps{P.S. If you like ...+
%    \end{quote}
%
%   Lastly, we close the \env{letter} environment and the document
%   itself.
%    \begin{quote}\slshape
%      \verb+\end{letter}+\\
%      \verb+\end{document}+
%    \end{quote}
% \section{An example of the use the \opt{consgroup} option}
%    The \opt{consgroup} option provides a variation on the standard
%    letter provided by the class \cls{uwalet}. Consider the example
%    given above. To specify the \opt{consgroup} option the 
%    \cn{documentclass} declaration should read something like:
%    \begin{quote}\slshape
%      \verb+\documentclass[12pt,consgroup]{uwalet}+
%    \end{quote}
%    Also, within the preamble, one should specify the \cn{groupname}
%    and the \cn{director}. The \cn{director} field may be left blank, 
%    e.g.\ by omitting it. Mostly users of this option will probably
%    leave \cn{name} blank (i.e.\ by completely omitting it). On the
%    other hand \cn{signature} (which is set in the closing) will need
%    need to be set. Here are examples of the settings of \cn{groupname},
%    \cn{director} and \cn{signature}.
%    \begin{quote}\slshape
%      \verb+\groupname{UWA Statistical Consulting Group}+\\
%      \verb+\director{Professor Adrian Baddeley}+\\
%      \verb+\signature{Professor A J Baddeley\\+\\
%      \verb+           Director}+
%    \end{quote}
%    
% \section{An example of the use the \opt{manager} option}
%    The \opt{manager} option provides a variation on the standard
%    letter provided by the class \cls{uwalet}. Consider the standard
%    letter example, given above. To specify the \opt{manager} option the 
%    \cn{documentclass} declaration should read something like:
%    \begin{quote}\slshape
%      \verb+\documentclass[12pt,manager]{uwalet}+
%    \end{quote}
%    The \cn{name} is set below the logo in italics, instead of to the 
%    right of it, in roman type.
%    Also, within the preamble, one may specify the \cn{role} of the
%    sender (specified by \cn{name}); if not blank \cn{role} appears
%    below the sender in italics. Here is an example of the settings 
%    of \cn{role}:
%    \begin{quote}\slshape
%      \verb+\role{Head of Department}+
%    \end{quote}
%    
% \section{An example of the use of the \opt{resreport} option}
%    Here is an example showing how to use the \opt{resreport} option.
%    First we must specify the class and fontsize and declare we are using
%    the \opt{resreport} option:
%    \begin{quote}\slshape
%      \verb+\documentclass[12pt,resreport]{uwalet}+
%    \end{quote}
%    Next comes the preamble information. This is a good place to specify
%    the authors of the research report with their respective addresses
%    and other details relevant to the report
%    (\verb+\pagestyle{headings}+ is recommended but not essential).
%    Note the use of the \cn{asabove} macro where the address of
%    an author is the same as that of the immediately previous author.
%    Also one should provide the AMS subject classification \cn{subjclass}
%    (refer to: \verb+http://www.ams.org/msc/+).
%    \begin{quote}\slshape
%      \verb+\pagestyle{headings}+\\
%      \verb+\title{A Recognition Algorithm for Classical Groups}+\\
%      \verb+\author[Niemeyer, A.C.]{Alice C. Niemeyer}+\\
%      \verb+\Address{Department of Mathematics\\+\\
%      \verb+         University of Western Australia\\+\\
%      \verb+         Nedlands, WA 6907}+\\
%      \verb+\author[Praeger, C.E.]{Cheryl E. Praeger}+\\
%      \verb+\Address{\asabove}+\\
%      \verb+\author[Nerk, F.]{Fred Nerk}+\\
%      \verb+\Address{Fictional Department}+\\
%      \verb+         Uni of Woop Woop}+\\
%      \verb+         Never Never}+\\
%      \verb+\reportnumber{1996/41}+\\
%      \verb+\reportmonth{Dec}+\\
%      \verb+\subjclass{20G04}+
%    \end{quote}
%    The defaults for \cn{name}, \cn{address}, etc.\ which are set in the
%    accompanying letter to the Australian Mathematical Society Gazette
%    usually don't need to be adjusted. If however, you prefer the date
%    to be set in the Australian style, rather than the default American
%    style, then you need to include:
%    \begin{quote}\slshape
%      \verb+\date{\oztoday}+
%    \end{quote}
%
%    Now we start the document and issue a \cn{maketitle} which generates
%    the titlepage for the the Research Report.
%    \begin{quote}\slshape
%      \verb+\begin{document}+\\
%      \verb+\maketitle+
%    \end{quote}
%
%    Now follows the letter to the Australian Mathematical Society Gazette.
%    The macros have been set up so that the following will be correct,
%    verbatim, unless the editor or his address changes.
%    \begin{quote}\slshape
%      \verb+\begin{letter}{Professor Mills\\+\\
%      \verb+	       Editor of the Australian Mathematical Society Gazette\\+\\
%      \verb+	       Department of Mathematics\\+\\
%      \verb+	       La Trobe University\\+\\
%      \verb+	       PO Box 199\\Bendigo, Vic 3550}+\\
%      \verb+\opening{Dear Professor Mills,} +\\
%      \verb++\\
%      \verb+The following preprint has appeared in the Research Report Series+\\
%      \verb+of The University of Western Australia.+\\
%      \verb++\\
%      \verb+\begin{quote}+\\
%      \verb+ \Report+\\
%      \verb+\end{quote}+\\
%      \verb++\\
%      \verb+We would be very grateful if they could be included in the +\\
%      \verb+Notices of Preprints in the next issue of the Gazette.+\\
%      \verb++\\
%      \verb+\closing{With kind regards,}+\\
%      \verb+\end{letter}+
%    \end{quote}
%    Finally, we must of course finish with
%    \begin{quote}\slshape
%      \verb+\end{document}+
%    \end{quote}
% \CheckSum{583}
% \Finale