\documentclass{article}
% $Id:$
\setcounter{errorcontextlines}{999}
\usepackage{relsize,url}
\urldef\rfemail\url{rf@cl.cam.ac.uk}
\newcommand\acro[1]{\textsmaller{#1}\@}
\newcommand\PCTeX{\acro{PC}\TeX}
%
\makeatletter
% a robust definition of a command spec
% syntax: \cmd\control-seq<arg-specs>
% arg specs may be {arg} or [opt-arg] (argument typeset in italic) or
% \{arg\} or \[opt-arg\] (argument typeset in tt)
\DeclareRobustCommand{\cmd}[1]{%
  \expandafter\texttt\expandafter{\string#1}%
  \cmd@i
}
%
\def\cmd@i{\futurelet\@let@token\cmd@ii}
\def\cmd@ii{%
  \let\@tempa\relax
  \ifx\@let@token\bgroup
    \def\@tempa##1{\texttt{\char`\{}\textit{##1}\texttt{\char`\}}\cmd@i}%
  \fi
  \ifx\@let@token\{%\}
    \def\@tempa\{##1\}{\texttt{\char`\{##1\char`\}}}%
  \fi
  \ifx\@let@token[%]
    \def\@tempa[##1]{\texttt{[}\textit{##1}\texttt{]}\cmd@i}%
  \fi
  \ifx\@let@token\[%\]
    \def\@tempa\[##1\]{\texttt{[##1]}}%
  \fi
  \@tempa
}
\makeatother
%
\begin{document}
\title{The Canadian Journal of Physics Macros\\
  \textsmaller{Preliminary version (pre version 1.0 of macros)}}
\author{Robin Fairbairns\thanks{Present address: University of
    Cambridge Computer Laboratory, Pembroke Street, Cambridge,
    \acro{CB}2 3\acro{QG}, UK; \rfemail}}
\date{10\textsuperscript{th} March 1997}
\maketitle
%
\section{Introduction}
This note describes use of the macros supplied to the Canadian
National Research Council, for typesetting papers for the Canadian
Journal of Physics.

The macros are designed (as far as is possible) to operate in a
`standard' \LaTeXe{} environment (it assumes \LaTeXe{} of December
1995, at the latest).  Certain operations are coded in an `odd' way to
provide for the exotic environment provided by the \PCTeX{} employed
by the Council; however, as far as is possible, versions of operations
that operate in a `normal' \TeX{} environment are supplied, so that
ordinary mortals (for example, the present author; in the future,
also, authors of papers for submission to the journal) can use the
macros for proofing and testing purposes.

\section{The \cmd\documentclass\ command and class options}

Papers should start with a \cmd\documentclass\ command, as normal,
requesting options as required, and specifying such options are
required:
\begin{center}
  \cmd\documentclass[options]\{can-jp\}
\end{center}
The macros are defined so that the ordinary user will not need to use
any options if the complete set of fonts required by the class (for
production work) are available.

\subsection{Font class options}
\begin{description}
\item[\normalfont\textsf{type1fonts}] Select PostScript type~1 fonts
  as required in ordinary production work.  This requires that the
  Adobe Times and (extended) Helvetica families are available: the
  extensions required of Helvetica are Helvetica Light and Helvetica
  Black, which are commercial fonts not ordinarily available in
  PostScript printers.

  \textsf{type1fonts} is the default option
\item[\normalfont\textsf{type1rest}] As \textsf{type1fonts}, but
  substitutes the commonly-available Helvetica Bold for Helvetica
  Black, and Helvetica Normal for Helvetica Light.
\item[\normalfont\textsf{cmfonts}] Uses Knuth's Freely-available
  Computer Modern Fonts in place of the production Times and
  Helvetica.  If your \TeX{} implementation uses bitmap fonts, you may
  find that some of the sizes employed are `unusual' and require new
  bitmaps to be generated: this is not ordinarily a problem with a
  modern \TeX{} implementation, since the generation occurs entirely
  automatically when the fonts are requested by the previewer or
  printer application.
\end{description}
\end{document}
