\begin{filecontents}{nrcdoc.sty}
% converted to a 2e package, rf 1998/04/05
% also added \Status and provision for dealing with pdf output

%% 12 MAR 98: put the macros to typeset the documentation produced
%%            for the NRC's _Canadian Journal of Physics_ (= CanJPhys
%%            or CJP) into their own file: nrcdoc.sty (Ch.)
%% 31 MAR 98: made some changes to incorporate even more format
%%            elements into this style file, removing them from the
%%            various documents (Ch.)
%% 
%%

%
% usage:
%        <processor> "\def\Status{<value>} \input <file>"
%
% for example:
%        pdflatex "\def\Status{1} \input user_guide"
%
% (that's un*x syntax, but the intent is (i hope) plain
\providecommand{\Status}{0}
\ifcase\Status
  % default case (0): using ordinary latex
  \PackageInfo{nrcdoc}{Regular LaTeX run}
  \def\href#1#2{#2}
\or
  % case 1: using pdflatex to generate a copy of the file
  \PackageInfo{nrcdoc}{Generating hypertext pdf output}
  \RequirePackage[pdftex]{hyperref}
\fi

\RequirePackage{url}
\newcommand{\email}{\begingroup \urlstyle{tt}\Url}
%
\def\EmailURL#1{\href{mailto:#1}{\email{#1}}}
\def\ctanaddr#1{\href{ftp://ctan.tug.org/tex-archive/#1}{\path{#1}}}


\def\ps@myheadings{\let\@mkboth\@gobbletwo
                   \def\@oddhead{{\sl\rightmark}\hfil \rm\thepage}%
                   \def\@oddfoot{March 1998\hfill}%
                   \def\@evenhead{\rm \thepage\hfil\sl\leftmark}%
                   \def\@evenfoot{March 1998\hfill}%
                   \def\sectionmark##1{}\def\subsectionmark##1{}}

\pagestyle{myheadings}

\markboth{Canadian Journal of Physics}
         {Canadian Journal of Physics}


%% Dimensions:

\setlength{\textwidth}{19cm}
\setlength{\textheight}{23cm}
\setlength{\oddsidemargin}{-3.5pc}
\setlength{\evensidemargin}{-3.5pc}
\setlength{\topmargin}{-3pc}
\setlength{\columnsep}{1.5pc}


%% Fonts:

\font\bfsl=cmssi17
\font\sectiontt=cmtt12 scaled\magstep1
\font\stt=cmtt10 scaled 850


%% Macros:

\newcommand{\CJPtitle}{{\bfsl Canadian Journal of Physics}}


\newcommand{\CJP}{{\small\sl CJP}}
\newcommand{\blash}{{\stt\char'134}}

\newcommand{\creditline}{{\footnotesize 
                           Carleton Production Centre (3/98)}}

%% def'n for \LaTeXe taken from TUGboat's tugboat.cmn file:
\newcount\TestCount     \newbox\TestBox
\def\La{\TestCount=\the\fam \leavevmode L%
        \setbox\TestBox=\hbox{$\fam\TestCount\scriptstyle A$}%
        \kern-.5\wd\TestBox\raise.42ex\box\TestBox}
\def\LaTeX{\La\kern-.15em\TeX}
\def\LaTeXe{\LaTeX{}\kern.05em2$_{\textstyle\varepsilon}$}


%% \let-statements:

\let\en=\enspace
\let\nl=\newline

\end{filecontents}

\documentclass{article}
\usepackage{nrcdoc}
\begin{document}

\twocolumn[
\begin{center}
       \CJPtitle \\
       \vspace{.5pc}
       \Large\bf User Guide to \tt cjp.cls
\end{center}

\vspace{1pc}

]


\section{Basic coding}

All \LaTeX\ documents must include these three commands:

\begin{verbatim}
   \documentclass{...}
    ...
   \begin{document}
    ...
    ...
   \end{document}
\end{verbatim}

\begin{enumerate} \itemsep=0pt
   \item The \verb|documentclass| must be specified, either with a
         generic package, such as \verb|article| or a specific
         package, such as \verb|cjp|).

   \item Between the first two lines comes the material often called
         the ``preamble'', which includes additional packages (and
         their options), as well as any file-specific macros.

   \item Between the second and third lines comes the actual contents
         of the article --- call it the ``body'' of the file.
\end{enumerate}

\noindent Typesetting commands are usually of the following types:

\begin{enumerate} \itemsep=0pt
   \item {\tt control sequences} begin with a backslash ( \blash\ ). 

   \item {\bf environments} use matching \verb|\begin{...}|\break
         \verb|\end{...}| statements (e.g., \verb|\begin{document}|).

   \item {\bf optional} arguments are within square brackets \verb|[...]|
\end{enumerate}


\section{The Preamble\label{template}}

The following represents the main packages and options for \CJP. Note
that most articles will {\bf not} require all of them. However, this
does represent the usual order of the packages and
options.\footnote{Note that the option {\tt [pctex32]} is for in-house
production.}

\begin{verbatim}
   \documentclass[usecmfonts   OR   type1rest,%
                  french,%
                  breakaddress,%
                  trimmarks]{cjp}

   \usepackage[pctex32]{graphicx,color}
   \usepackage[figuresright]{rotating}

   \usepackage[french]{babel}

   \usepackage{cite}
   \usepackage{bm}
\end{verbatim}

\noindent The next section will discuss each line in the preamble.

\newpage

\subsection{Packages and options}

\begin{description}
   \item [{\tt \blash documentclass[...]\{cjp\}}] \mbox{}

         Insert at the very top of the file. Options are inserted into
         the square brackets.

         The \verb|usecmfonts| option selects Knuth's Computer\break
         Modern fonts in place of the Times and Helvetica fonts
         ordinarily selected by \verb|cjp.cls|. Note that spacing for
         most text will change as Computer Modern fonts are wider than
         Times; mathematics is still set using the {\small CM} math
         fonts, so there will be no similar change in these areas.

         The \verb|type1rest| option selects a restricted set of Adobe
         fonts in place of the set ordinarily selected by
         \verb|cjp.cls|. This has the advantage of using fonts that
         are available on any PostScript printer, and typesetting
         running text as it will appear in the published result.

         The \verb|french| option configures the \verb|cjp|
         documentclass to ensure all the automated textual elements
         (in the author IDbox, for figures, tables, biblio\-graphies,
         etc.)\ are printed in French as per \CJP\ speci\-fi\-cations.
         It must be used in concert with
         \verb|\usepackage[french]{babel}|.

         The \verb|breakaddress| option affects the author IDbox at
         the bottom of the titlepage. It inserts a linebreak between
         the author name and address; the default setting has them
         print on the same line.

         The \verb|trimmarks| option is for in-house production
         purposes only. 

   \item [{\tt \blash usepackage[pctex32]\{graphicx,color\}}] \mbox{} 

         This syntax demonstrates loading two packages with the same
         option (the driver, in this case). 

         The \verb|graphicx| package is needed for inserting graphics
         into papers.

         The \verb|color| package is used for in-house production of
         reversed out text (white on black).

         The \verb|pctex32| option (for in-house {\small NRC}
         production) is needed whenever \verb|graphicx|, \verb|color|,
         or \verb|graphicx,color| are specified.

   \item [{\tt \blash usepackage[figuresright]\{rotating\}}] \mbox{}

         The \verb|rotating| package\footnote{For the NRC's production
         use, the standard distribution version of this file is
         currently under revision. Authors can proceed with the public
         version of {\tt rotating.sty}.} is only needed when tables or
         figures must be placed in landscape (``sideways'')
         position. It must be preceded by the \verb|graphicx| package.

         The \verb|figuresright| option ensures that rotated elements
         are oriented with the caption at the left margin of the
         regular page, in accord with \CJP\ style requirements. 

   \item [{\tt \blash usepackage[french]\{babel\}}] \mbox{}

         The \verb|{babel}| package with the \verb|french| option is
         required for French-language articles.\footnote{It is not
         necessary to use {\tt babel} with an {\tt english} option ---
         that is the \CJP\ default.} This invokes\break French
         hyphenation patterns (note that accented words will not
         hyphenate --- use \verb|\-| to signal soft hyphenation
         points) as well as some of the (European) French typesetting
         conventions (e.g., ``french spacing''). Where these conflict
         with \CJP\ requirements, \verb|cjp.cls| makes provision to
         deal with the conflict.

   \item [{\tt \blash usepackage\{cite\}}] \mbox{}

         All articles will use this package, which enhances the
         default options available in \LaTeX\ (e.g., \verb|\citen|
         prints cross-references without brackets). See
         \verb|cite.sty| documentation for additional features.

   \item [{\tt \blash usepackage\{bm\}}] \mbox{}

         This additional package helps deal with font changes in math
         mode. See \verb|bm.sty| documentation for details.

   \item [{\tt \blash usepackage\{amsfonts\}}] \mbox{}

         The {\small AMS} fonts provide additional special characters
         frequently used by the mathematics and scientific
         communities. This package provides access to the following
         font sets: Euler (Fraktur, Roman, Script, extensions);
         Computer Modern (math bold italic, symbol, extensions, in the
         smaller sizes); Cyrillic (lightfact, bold, italic,
         smallcaps); and the {\tt msam} and {\tt msbm} fonts, familiar
         to Rev\TeX\ users.

         There are a number of other packages associated with the
         {\small AMS}. The revised version of chap. 8 of {\sl The
         \LaTeX\ Companion} provides a great deal of information on
         these packages; a copy is included in the documentation
         binder.\footnote{Or pick up a copy from CTAN: go to {\tt
         ftp://ctan.tug.org}, change to the {\tt
         /tex-archive/info/companion-rev} subdirectory and fetch the
         file {\tt ch8.ps}. For other CTAN sites, connect to {\tt
         www.tug.org} and look for `archives'.}

\end{description}

\noindent Authors should avoid creating too many personal macros,
which may conflict with \verb|cjp.cls| and slow in-house processing of
their files. In particular, \verb|\let|-statements for abbreviations,
while useful for keyboarding purposes, should be replaced by the full
control sequence before submission. 

\newpage


\section{The Body}

All articles have the following elements:

\begin{enumerate} \itemsep=0pt
   \item titleblock and author information 

   \item abstract or resum\'e

   \item headings and subheadings

   \item text (!)

   \item bibliography
\end{enumerate}

\noindent Most articles also include some or all of the following
elements: 

\begin{enumerate} \itemsep=0pt
   \item offset quoted passages

   \item enumerated lists

   \item tables and figures

   \item display mathematics 

   \item illustrations (e.g., {\sc PostScript})

   \item footnotes

   \item acknowledgements
\end{enumerate}


\subsection{Titleblock and author information}

All elements of the titleblock are taken care of via macros, some of
which have optional arguments, to allow for variant forms and for
`labelling' of bits of text (for cross-referencing).

\begin{description}
   \item [{\tt \blash title\{...\}}] \mbox{}

         Lines will be broken automatically; line breaks can be forced
         by using \verb|\\|. 

   \item [{\tt \blash author[...]\{author1\}}] \mbox{}

         {\sl Author1\/}'s name as it will appear in the titleblock
         and the right running head. The optional argument allows a
         different form of the author's name to appear in the IDbox at
         page-bottom (e.g., full first name in titleblock, but
         initials only in IDbox).

         Each author is specified separately. The document class will
         automatically insert ``and'' (or ``et'', if in French)
         between the last and second-last names, both in the
         titleblock and in the IDbox area. 

         If authors' names make the running head too long, use
         \verb|\shortauthor{...}| to provide a short list. This macro
         should appear below all the author-address information.

   \item [{\tt \blash address[label1]\{addr1\}}] \mbox{}

         Address for {\sl author1\/}; this should be immediately below
         the \verb|\author| entry. Each author's address is specified
         separately. If no address is specified before the next author
         entry, the immediately preceding address is used (an address
         for the first author {\bf must} therefore be specified).

         The optional \verb|[label1]| argument (any sequence of
         letters can be used) does not print anything; it makes it
         possible to relate one address to several authors (this is
         similar to \LaTeX's \verb|\label| and \verb|\ref| commands).
\end{description}


   Below is an example of using the author-address cross-referencing
   macros: 
         
   \begin{description}
      \item \verb|\author{auth1}|\quad defines first author

      \item \verb|\address[label1]{addr1}|\quad defines an address for
            {\sl author1\/} and tag it as \verb|[label1]|

      \item \verb|\author{auth2}|\quad this author doesn't have an
            address, so the IDbox will use the immediately preceeding
            author's address

      \item \verb|\author{auth3}|\quad defines a third author

      \item \verb|\address{addr3}|\quad third author is at an address
            of their own

      \item \verb|\author{auth4}|\quad defines a fourth author

      \item \verb|\address[label1]|\quad fourth author uses the address
            associated with \verb|[label1]|, above

        The net result (assuming the \verb|breakaddress| option has
        been used) is the following:

        {\bf Author1, Author2, and Author4.} \\ 
        Address1.

        {\bf Author3.} \\ 
        Address3.

   \item [{\sl IDbox address notes}] \mbox{}
 
         Author addresses can be augmented with additional information
         via numbered notes, which appear below all the authors' names
         and main addresses. Note that only one of these supplementary
         notes can appear for each \verb|author|.

   \begin{description}
      \item [{\tt \blash correspond\{...\}}] \mbox{}

            Usually one author is selected from all co-authors to deal
            with correspondence. 

            If the argument is left empty (that is, if only
            \verb|\correspond| appears below a given author entry, the
            following text will appear: ``Author to whom all
            correspondence should be addressed.''

            If the argument contains information about phone, fax,
            e-mail, it will be introduced by: ``Corresponding
            author:''

            \verb|\phone{...}|\qquad 
            \verb|\fax{...}|\qquad 
            \verb|\email{...}|

            These three macros (phone et al.)\ can be used anywhere
            inside the author IDbox area.

      \item [{\tt \blash present\{...\}}] \mbox{}

            Authors may wish to indicate a temporary or current
            address, different from the main one provided via
            \verb|\address|. This note will begin with the text:
            ``Present address:''. 

      \item [{\tt \blash AddressNote\{...\}}] \mbox{}

            Allows the user to input any information they wish, with
            no automatic text being added. 
   \end{description}

   \item [{\tt \blash dedication\{...\}}] \mbox{}

         Will print a dedicatory text in the IDbox area, between the
         ``Received/Accepted'' and the author/address sections.

   \item [{\tt \blash maketitle}] \mbox{}

         This command activates the titleblock commands; it must
         appear after all the above commands.
\end{description}


\subsection{Abstracts/R\'esum\'es}

The syntax is the normal one expected for environments: a matched set
of either \verb|abstract| or \verb|resume|: 

\begin{description}
   \item [{\tt \blash begin\{abstract\} ... \blash end\{abstract\}}] 

   \item [{\tt \blash begin\{resume\} ... \blash end\{resume\}}] 
\end{description}


\subsection{Headings and subheadings}

Four levels, numbered automatically. Line breaks can be forced by
using \verb|\\|. To suppress numbering (e.g., for
``Acknowledgements''), use an asterisk before the opening curly brace:
\verb|\section*{}|. All four levels can also be referred to by the
indicated alias.

\begin{description}
   \item [{\tt \blash section\{...\}}] Level-1 heading (alias \verb|\Asection|)

   \item [{\tt \blash subsection\{...\}}]  Level-2 heading (alias \verb|\Bsection|)

   \item [{\tt \blash subsubsection\{...\}}]  Level-3 heading (alias \verb|\Csection|)

   \item [{\tt \blash paragraph\{...\}}]  Level-4 heading (alias \verb|\Dsection|)
\end{description}


\subsection{Text}

Same as the default \LaTeX\ commands.

\begin{description}
   \item [{\tt \blash begin\{quote\} ... \blash end\{quote\}}] 

   \item [{\tt \blash begin\{enumerate\} ... \blash end\{enumerate\}}] 

   \item [{\tt \blash begin\{itemize\} ... \blash end\{itemize\}}] 

   \item [{\tt \blash begin\{description\} ... \blash end\{description\}}] 

   \item [{\tt \blash footnote\{...\}}] 
\end{description}



\subsection{Maths}

Same as the default \LaTeX\ commands. See also \verb|bm.sty| for
enhanced font handling inside math mode.

\begin{description}
   \item [{\tt \blash begin\{equation\} ... \blash end\{equation\}}] \mbox{}

   \item [{\tt \blash numberby\{...\}}] \mbox{}

         For articles where equation numbers must include section
         numbers (e.g., equation 3.2 is the second equation in
         section~3), input the following in the preamble area, after
         all \verb|\usepackage| commands:\footnote{This is the same as
         using the command {\tt \blash numberwithin}, but that
         requires loading the {\tt amsmath} package.}

         \begin{verbatim} 
   \numberby{equation}{section}
         \end{verbatim} 
\end{description}


\subsection{Tables and Figures}

Same as default \LaTeX\ commands.

\begin{description}
   \item [{\tt \blash begin\{table\} ... \blash end\{table\}}] 

   \item [{\tt \blash begin\{sidewaystable\} ... \blash
         end\{sidewaystable\}}] for rotating a table sideways.  To
         ensure rotation is in correct direction, remember to add the
         \verb|figuresright| option to \verb|rotating| (see Preamble
         section).

   \item [{\tt \blash begin\{tabular\} ... \blash end\{tabular\}}] 

   \item [{\tt \blash hline*}] \quad for the thicker lines at top/bottom
         of tables. Regular 1pt rules accessed via default
         \verb|\hline| command.

   \item [{\tt \blash begin\{figure\} ... \blash end\{figure\}}] 

   \item [{\tt \blash topcaption\{...\}}] syntax same as for
         \LaTeX\ default \verb|\caption|

         To custom-fit captions to table widths, print tables, measure
         their width, specify required caption dimension via
         \verb|\captionwidth|, like this:

         \begin{verbatim}
\setlength\captionwidth{ ... }
\topcaption{ ... }
         \end{verbatim}
        
\end{description}


\subsection{References} 

Same as the default \LaTeX\ commands. See also \verb|cite.sty| for
additional options.

\begin{description}
   \item [{\tt \blash begin\{thebibliography\}\{99\}...
               \blash end\{thebibliography\}}] 

   \item [{\tt \blash bibitem\{...\}}] 

   \item [{\tt \blash cite\{...\}}] produces cross-referencing digit or
         digits inside square brackets. 

   \item [{\tt \blash citen}] produces digit with {\bf no} brackets.
         Loaded via \verb|cite| package. 
\end{description}

\newpage


\section{Summary of commands}

Keep in mind that the following is a summary of mainly \CJP-related
commands; consult your favourite \LaTeX\ documentation for additional
assistance and information. 


\subsection{Preamble}

Only use the packages necessary.

\begin{verbatim} 
   \documentclass[usecmfonts   OR   type1rest,%
                  breakaddress,%
                  trimmarks]{cjp}

   \usepackage[pctex32]{graphicx,color}
   \usepackage[figuresright]{rotating}

   \usepackage[french]{babel}

   \usepackage{cite}
   \usepackage{bm}
\end{verbatim}


\subsection{In-house additions to preamble}

\begin{verbatim} 
   \setcounter{page}{...}
   \volyear{...}[...]{...}
   \received{...}
   \accepted{...}
\end{verbatim}


\subsection{Body}

\subsubsection{Titleblock and author information}

%% 23 MAR 98: some additions in here:
\begin{verbatim}
   \begin{document}
   \title{...}
   \author[author1 short name]{full name}
      \address[label1]{address of author1}

   \author{full name of author2}
      \address{address of author2}

(choose one:)
   \correspond     or     \correspond{...}
   \present{...}
   \AddressNote{...}

      \phone{...}    
      \fax{...}
      \email{...}

   \author[author2 short name]{full name}
      \address[...]

   \shortauthor{...}

   \maketitle
\end{verbatim}

\newpage


\subsubsection{Abstract/Resume}

\begin{verbatim}
   \begin{abstract}
      ...
   \end{abstract}

   \begin{resume}
      ...
   \end{resume}
\end{verbatim}


\subsubsection{Headings and subheadings}

\begin{verbatim}
   \section{...}         or    \Asection{...}

   \subsection{...}      or    \Bsection{...}

   \subsubsection{...}   or    \Csection{...}

   \paragraph{...}       or    \Dsection{...}

   \section*{Acknowledgments}

\end{verbatim}


\subsubsection{Miscellaneous}

%% 23 MAR 98: some additions in here:
\begin{verbatim}
   \footnote{...}

   \begin{quote} ... \end{quote}

   \begin{itemize} ... \end{itemize}

   \begin{enumerate} ... \end{enumerate}

   \begin{description} ... \end{description}

   \begin{equation} ... \end{equation}

   \begin{eqnarray} ... \end{eqnarray}

   \begin{array} ... \end{array}
\end{verbatim}


\subsubsection{Tables and Figures}

\begin{verbatim}
   \begin{table}   or   \begin{sidewaystable}
      \setlength{captionwidth}{...}
      \topcaption
      \begin{tabular}{...}
         \hline*
          ...
         \hline
          ...
          ...
         \hline*
      \end{tabular}
   \end{table}     or   \end{sidewaystable}

   \begin{figure}
      \topcaption{...}
      ...
   \end{figure}
\end{verbatim}


\subsubsection{References}

\begin{verbatim}
   \cite{...}    \cite{...,...}    \citen{...}

   \begin{thebibliography}{99}

   \bibitem{...}

   \end{thebibliography}

   \end{document}
\end{verbatim}


%% Documentation:

\section{Resources}

The following documentation, newsgroups, and web pages are useful
source to consult for help, news, and updates. Keep in mind, however,
that conflicts may arise when 


\subsection{Books and articles}

\begin{description} \raggedright \frenchspacing
   \item [{\sl The \LaTeX\ Companion:}] by Michel Goossens, Frank
         Mittelbach, and Alexander Samarin (Addison-Wesley, 1994).

         Contains many details to assist users. Caveats:

         Chapter~8 is no longer valid --- a revised version is
         available in both {\tt .ps} and {\tt .pdf} formats from
         {\small CTAN}.\footnote{CTAN = Comprehensive \TeX\ Network
         Archive; a listing of addresses can be found on the {\small
         TUG} home page {\tt www.tug.org}. Follow the links to {\tt
         /tex-archive/info/companion-rev}.}

         As well, the sections on graphics and colour have been
         superceded by material in {\sl The \LaTeX\ Graphics
         Companion\/}.

   \item [{\sl The \LaTeX\ Graphics Companion:}]{\sl Illustrating
         Documents\break with \TeX\ and PostScript\/}, by Michel
         Goossens, Sebastian Rahtz, and Frank Mittelbach
         (Addison-Wesley, 1997).

   \item [{\sl Math into \LaTeX:}] {\sl An Introduction to \LaTeX{} and
         AMS\LaTeX{}}, by George Gr\"atzer (Birkh\"auser, 1996).

   \item [{\sl The \TeX book:}] by Donald E.~Knuth (Addison-Wesley,
         1986). 

   \item [{\sl \LaTeX:}] {\sl A Document Preparation System ---
         User's Guide and Reference Manual\/}, by Leslie
         Lamport (Addison-Wesley, 1994, 2nd ed). 

   \item [{\sl A Guide to \LaTeXe:}] by Helmut Kopka and Patrick
         W.~Daly (Addison-Wesley, 1995, 2nd ed).

   \item [{\rm Michael Downes:}] ``Breaking equations,'' {\sl TUGboat}
         18,3 (Sept 1997): 182--194.

   \item [{\rm Keith Reckdahl:}] ``Using EPS graphics in \LaTeXe\
         documents,'' {\sl TUGboat} 17,1 (March 1996): 43--53.

   \item [{\rm Keith Reckdahl:}] ``Using EPS graphics in \LaTeXe\ documents,
         Part 2: Floating figures, boxed figures, captions, and math
         in figures,'' {\sl TUGboat} 17,3 (Sept.\ 1996): 288--310.
\end{description}


\subsection{Electronic resources}

\begin{description}
   \item [\href{http://www.tug.org/}{www.tug.org}:] the most complete
         stepping-stone to the
         world-wide \TeX\ community, including the {\small CTAN}
         archives, user groups, news, and so on.

   \item [comp.text.tex] a general all-purpose newgroup for \TeX\
         users. Send queries to \EmailURL{info-tex@shsu.edu}. Consult
         sections~6 and 7 of the document ``Processing
         Author-generated {\tt .tex} Files'' for details.

   \item [FAQ:] put together by the UK \TeX\ Users Group; available
         via the {\small TUG} web page\ifnum\Status=1
         \ (or direct from
      \href{http://www.cogs.susx.ac.uk/cgi-bin/texfaq2html?introduction=yes}%
           {its source})%
         \fi. 

   \item [Listserv lists:] there are a great number of specialised
         Listserv lists. 
\end{description}

\clearpage


%%  In-house coding:

\section{In-house Coding}

\subsection{File activity log}

At the very top of each file are entries noting activities specific to
the file. Comment structure may vary but could cover such activities
as editing, typesetting, screen-proofing, checking tables and figures,
inputting author corrections, and so on. Entries may be dated or not,
depending on journal. Comments should be on one line each, beginning
with \verb|%%| signs:

\begin{verbatim}
   %% Typeset by:
   %% Edited by:
   %% Tables and Figures:
\end{verbatim}

\noindent Specific day-to-day details could also be added:

\begin{verbatim}
   %% 17 NOV 97: ran file to test author code 
   %% 25 NOV 97: input c/e; screen-proofed output
   %%  9 DEC 97: proofs printed, mailed to author
\end{verbatim}

\noindent If several people work on the same file, initials could be
added after each log entry.


\subsection{In the preamble area}

Recall that two options to \verb|cjp.cls| are most often used for
in-house production rather than by authors: \verb|breakaddress| and
\verb|trimmarks|. See section~\ref{template}. 

Over time, it may become apparent that some small modifications or
shorthands are used in almost all papers. Until such changes are
incorporated into the \verb|cjp.cls| documentclass, these should not
be inserted into each article file but rather stored in a separate
file (call it \verb|physmods.sty|), which would be loaded via a
\verb|\usagepackage| command inserted below \verb|cjp.cls|. 

The following information is input by \CJP's in-house production team,
and not by the author. It appears after all packages have been loaded,
and before the \verb|\begin{document}| statement:

\begin{verbatim}
   \setcounter{page}{<digit>}
   \volyear{<vol no.>}[<copyright year>]{<year>}

   \received{<complete date>}
   \accepted{<complete date>}
\end{verbatim}

\begin{description}
   \item [{\tt \blash setcounter\{page\}\{...\}}] \mbox{}

         Insert starting page number for article. The information will
         be printed on the titlepage (bottom left) and in the running
         head; the complete page range will be calculated and inserted
         automatically when run a second time.

   \item [{\tt \blash volyear\{...\}[...]\{...\}}] \mbox{}

         First argument is for the volume number. The second
         (optional) argument specifies the copyright year; if the
         argument is not present, the copyright year is assumed to be
         the same as the publication year. The third argument
         specifies the publication year. This information is used in
         the titlepage footer and in the left running head.

   \item [{\tt \blash received\{...\}}] \mbox{}

         Insert date as per \CJP\ style --- e.g., June 6, 1996 --- but
         without a final period (it is automatically inserted).  This
         information appears in the author IDbox area.
         
   \item [{\tt \blash accepted\{...\}}] \mbox{}

         Insert date as per \CJP\ style --- e.g., June 6, 1996 --- but
         without a final period (it is automatically inserted).  This
         information appears in the author IDbox area.
\end{description}


\subsection{Translations of abstracts/resum\'es}

The following lines are inserted at the end of each abstract or
resum\'e, before the \verb|\end{...}| statement:

\begin{description}
   \item [{\tt \blash translation}] generates the text: ``[Journal
         translation]''.

   \item [{\tt \blash traduit}] generates the text: ``[Traduit par la
         r\'edaction]''.

   \item [{\tt \blash Traduit}] generates the text: ``[Traduit par la
         R\'edaction]''.
\end{description}


\subsection{Special titleblocks}

For elements in \CJP\ which are not articles (editorials,
communications, erratum, reviews, etc.), the titleblock is a solid
black stripe with reversed-out white lettering. Since these require
the `color' black to be printed, the following line must appear in the
preamble:
%
\begin{verbatim}
   \usepackage[pctex32]{color}
\end{verbatim}
%
There are two versions of the special title command:

\begin{description}
   \item [{\tt \blash specialtitle}] \mbox{}

         This allows the regular titleblock (\verb|\title|, etc.) to
         be included with the special title; for example, a review
         article with its own title.
%
\begin{verbatim} 
\begin{document}
\specialtitle{REVIEW/SYNTH\`ESE}
\title{Regular article title}
\author{Someone's name here}
\address{Someplace nice and warm}
   \correspond
\shortauthor{Review/Synth\`ese}
\maketitle
\end{verbatim}

   \item [{\tt \blash specialtitle*}]\mbox{}

         The regular titleblock material cannot be used with this
         variant; for example, an editorial.
%
\begin{verbatim} 
\begin{document}
\specialtitle*{EDITORIAL/\'EDITORIAL}
\shortauthor{Editorial/\'Editorial}
\maketitle
\end{verbatim}
\end{description}
          

\subsection{Two-column bilingual texts}

The first step is to load the appropriate package and options. These
are added after the \verb|\documentclass| line:

\begin{enumerate}
   \item if main (left column) language is English:

         \verb|\usepackage[french,english]{babel}|

   \item if main (left column) language is French, there is an
         additional option to add to the document class line:

         \verb|\documentclass[french]{cjp}|

         \verb|\usepackage[english,french]{babel}|
\end{enumerate}
         
\noindent Notice that this seems counter-intuitive.

The next step is to code the English and French texts so that the tops
of matching paragraphs align horizontally. 

When the left-column language is English, French is the additional
``option'', so it appears in square brackets (line 1). The entire
two-column section is set inside a \verb|par-text| environment (lines
1 and 13).

\begin{verbatim}
1.  \begin{par-text}[french][<dimen.>][<dimen.>]
2.      \begin{par-para}
3.         ... <English paragraph> ... 
4.      \othercol
5.         ... <French paragraph> ... 
6.      \end{par-para}
7.
8.      \begin{par-para}
9.         ... <English paragraph> ... 
10.     \othercol
11.        ... <French paragraph> ... 
12.     \end{par-para}
13. \end{par-text}
\end{verbatim}

\noindent Within this bilingual two-column environment, matching
English/French paragraphs are set inside a \verb|par-para| environment
(lines 2/6 and 8/12). To signal the end of the English paragraph (in
the left column) and the start of its matching French paragraph (right
column), use \verb|\othercol| (lines 4, 10). For make it easier to
read the source file, separate each set of \verb|{par-para}| with a
blank line (line 7) or a {\tt \%} sign. 


\subsubsection{Modifying parameters}

\begin{enumerate}
   \item On line 1, it is possible to change the default widths of the
         two columns. The default widths are 15pc for English, 17pc
         for French, with a 2pc intercolumn space; these are
         automatically assigned to the appropriate column, depending
         on the initial language setup. Therefore there is no need to
         fill in the last two square braces of line 1.

         To change the column widths from their default settings, the
         optional language argument must be specified (French, in the
         above example; or English, if column order is reverse),
         followed by the last two square braces with the revised
         column widths.

   \item The default vertical space between lines is set at 1pc (= one
         blank line). To change this at specific points, explicit
         \verb|\vspace{...}| commands can be inserted between sets of
         \verb|{par-para}|. To change this for the entire file, insert
         \verb|\parallelparsep{<some dimen.>}| before
         \verb|{par-text}|.
\end{enumerate}


\subsection{Miscellaneous}

\begin{enumerate}
   \item For {\bf roman numerals}, with only page numbers in the
         footers, insert the following lines at the end of the
         preamble, just above the \verb|\begin{document}| line:
%
\begin{verbatim}
   \pagestyle{cjpplain}
   \pagenumbering{roman}
\end{verbatim}

   \item To add parentheses (or any other design element) to (roman)
         page numbers, insert the following `override' command in the
         preamble, after all packages have been loaded:
%
\begin{verbatim}
   \renewcommand\thepage{(\roman{page})}
\end{verbatim}
\end{enumerate}

\end{document}

%% END OF FILE
