summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/nrc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:44:40 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:44:40 +0000
commitb4fc5f639874db951177ec539299d20908adb654 (patch)
tree52f08823ca58fffe3db6a9b075635038c567626c /Master/texmf-dist/doc/latex/nrc
parentdec3d98ebe442d7ea93efbaa8dd2e2be8149a467 (diff)
doc 4
git-svn-id: svn://tug.org/texlive/trunk@80 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/nrc')
-rw-r--r--Master/texmf-dist/doc/latex/nrc/README36
-rw-r--r--Master/texmf-dist/doc/latex/nrc/authors.txt109
-rw-r--r--Master/texmf-dist/doc/latex/nrc/userguide.pdfbin0 -> 205720 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nrc/userguide.tex2399
4 files changed, 2544 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/nrc/README b/Master/texmf-dist/doc/latex/nrc/README
new file mode 100644
index 00000000000..95871d238a5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nrc/README
@@ -0,0 +1,36 @@
+ Macros for NRC press journals
+
+This directory contains macros, and some documentation, for
+typesetting papers for submission to journals published by the
+National Research Council of Canada.
+
+Files in this directory are:
+
+ nrc.dtx source of the macros
+ nrc.ins TeX installation script for the NRC classes
+ userguide.tex LaTeX documentation file
+ userguide.ps.gz Resolution-independent postscript of documentation
+ userguide.pdf Hypertext acrobat documentation
+ README This file
+ authors.txt upgrading instructions for authors
+
+To create the NRC class files for use with (current) LaTeX:
+
+ - download the files nrc.dtx and nrc.ins
+ - process nrc.ins with LaTeX
+ - (optionally) move the resulting files nrc1.cls, nrc2.cls (and the
+ corresponding .sty files) to a directory on your LaTeX input path
+ (recommended TDS location, for modern freeware installations of
+ LaTeX, is <local texmf tree>/tex/latex/nrc/)
+
+User-level documentation is available (in three forms) as userguide.*
+in this directory. If you wish to process userguide.tex, please
+delete any old copy of nrcdoc.sty that is to be found on your system
+(the file will generate a new copy of nrcdoc.sty in the course of
+being processed).
+
+More TeXnical documentation may be had by processing nrc.dtx with
+LaTeX, in the usual way.
+
+Robin Fairbairns
+For the NRC, 18th October 2002
diff --git a/Master/texmf-dist/doc/latex/nrc/authors.txt b/Master/texmf-dist/doc/latex/nrc/authors.txt
new file mode 100644
index 00000000000..7a75b8ed66d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nrc/authors.txt
@@ -0,0 +1,109 @@
+The National Research Council (NRC) Research Press provides the
+following class files for the benefit of its authors:
+
+ nrc1.cls is for single-column layouts
+ nrc2.cls is for double-column journal layouts
+
+These are generated via the nrc.ins + nrc.dtx files. See the README
+file for details. The userguide is also available and should be
+downloaded in an appropriate format.
+
+
+ AUTHORS ARE STRONGLY ADVISED TO REPLACE THEIR FORMER
+ VERSIONS OF THE CLASS FILES WITH THESE NEW ONES.
+
+ THE NEW USERGUIDE SHOULD ALSO BE DOWNLOADED AND PRINTED.
+
+
+The latest versions of all files have a great number of improvements
+and enhancements over the previous versions.
+
+Old version of nrc.dtx: 2000/07/26 v1.3j.7c
+New version of nrc.dtx: 2002/11/19 v2.0
+
+Old version of nrc.ins: 2000/10/02
+New version of nrc.ins: 2002/11/19
+
+Old version of userguide: 21 NOV 2000
+New version of userguide: 18 NOV 2002
+
+======================================================================
+
+ This note (AUTHORS.txt) focusses on author-specific elements
+ in the userguide, and avoid common pitfalls.
+
+
+1. UPDATING AND GENERATING NEW CLASS FILES
+
+ Use the README file to generate the necessary class files and
+ instructions on where they should be stored on your machine.
+
+ Check CTAN periodically for updates in the directory:
+
+ tex-archive/macros/latex/contrib/supported/nrc
+
+
+2. DOCUMENTATION
+
+ The Userguide has two main components: information on creating and
+ coding a file (sections 1 through 5), and additional information
+ for in-house staff (from section 6 to the end).
+
+
+3. CLASS OPTIONS
+
+ There are no new options. However, there is a simplification of
+ options for authors.
+
+ The publicly available class files automatically activate
+ author-specific codes, and de-activate in-house codes (the log file
+ will provide information/warnings if the latter are accessed). It
+ is no longer necessary to explicitly insert author-specific codes
+ such as
+
+ genTeX usecmfonts type1rest
+
+ See section 2.1 for details.
+
+
+4. ADDITIONAL PACKAGES
+
+ Experience has shown that the following packages (all available
+ from CTAN) are consistently used and provide the additional
+ functionality authors (and the NRC Research Press) most often
+ require:
+
+ graphicx rotating
+ amsmath amssymb bm
+ cite babel
+
+ As well, tables benefit from the additional options available in
+ the array package.
+
+
+ Any other packages which authors find helpful MUST accompany their
+ submissions. This is particularly important where submissions are
+ using old versions of packages --- production staff only have
+ access to new versions on CTAN; should they have to acquire the
+ additional (and latest) packages themselves, these may not always
+ work in the same way as an older version. Of course, authors are
+ encouraged to use current versions of all additional packages.
+
+
+ Additional author-specific macros should be gathered together in
+ the preamble area, after all other packages have been loaded. See
+ section 3.2 for details.
+
+
+5. MACROS
+
+ a. New macros:
+ - \IDnote (Section 4.1)
+ - \PACS and \PACS* (for Physics) (Section 4.2)
+
+ b. Revised macros:
+ - \correspond (Section 4.1)
+ - headings now to 5 levels (Section 4.3)
+
+ c. Retired macros:
+ - \AddressNote (Section 4.1)
diff --git a/Master/texmf-dist/doc/latex/nrc/userguide.pdf b/Master/texmf-dist/doc/latex/nrc/userguide.pdf
new file mode 100644
index 00000000000..d40e37e9053
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nrc/userguide.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/nrc/userguide.tex b/Master/texmf-dist/doc/latex/nrc/userguide.tex
new file mode 100644
index 00000000000..55d4196e2a0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nrc/userguide.tex
@@ -0,0 +1,2399 @@
+\begin{filecontents}{nrcdoc.sty}
+
+\ProvidesPackage{nrcdoc}[2002/03/14 v2.3 collection of commands for
+ NRC documentation]
+%
+\newcommand\checkNRCDOCdate[1]{\@ifl@ter{sty}{nrcdoc}{#1}%
+ {}%
+ {\ClassWarningNoLine{nrcdoc}{An old version of nrcdoc.sty has been detected%
+ \MessageBreak %
+ Please *delete* nrcdoc.sty, to allow LaTeX to
+ \MessageBreak generate a new version}}%
+}
+
+% converted to a 2e package, rf 1998/04/05
+% also added \Status and provision for dealing with pdf output
+%
+% 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{Nov. 2002\hfill}%
+ \def\@evenhead{\rm \thepage\hfil\sl\leftmark}%
+ \def\@evenfoot{Oct. 2002\hfill}%
+ \def\sectionmark##1{}\def\subsectionmark##1{}}
+
+\pagestyle{myheadings}
+
+\markboth{{\rm NRC:} \LaTeX{} User Guide for Journals}
+ {{\rm NRC:} \LaTeX{} User Guide for Journals}
+
+
+%% Dimensions:
+
+%% CT> to get holes at left without touching text, changed
+%% a. margins from -3.5pc to -2pc
+%% b. textheight from 23cm to 24cm
+%% CT> 28 SEP 00: makes no sense to use these margins for the version
+%% to be posted on CTAN. Dimens now revert to original
+%% value of -3.5pc for left/rightmargins. The
+%% textheight, however, will remain at 24cm.
+%%
+\setlength{\textwidth}{19cm}
+\setlength{\textheight}{24cm}
+\setlength{\oddsidemargin}{-3.5pc}
+\setlength{\evensidemargin}{-3.5pc}
+\setlength{\headsep}{12pt}
+\setlength{\topmargin}{-3.5pc}
+\setlength{\columnsep}{1.5pc}
+
+
+%% Something Robin doesn't like but it's handy for tables:
+
+%% Spacing commands for {tabular} (from TTN 2,3:10 -- Claudio
+%% Beccari):
+
+\newcommand\T{\rule{0pt}{2.6ex}} % = `top' strut
+\newcommand\B{\rule[-1.2ex]{0pt}{0pt}} % = `bottom' strut
+
+
+%% Fonts:
+
+\font\bfsl=cmssi17
+\font\sectiontt=cmtt12 scaled\magstep1
+\font\stt=cmtt10 scaled 850
+
+
+%% Macros:
+
+\newcommand{\NRC}{{\small NRC}}
+\newcommand{\blash}{{\stt\char'134}}
+
+\newcommand{\creditline}{{\footnotesize
+ Carleton Production Centre (9/00)}}
+
+%% 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}
+
+% check we're running against a copy of nrcdoc.sty generated from this
+% copy of userguide.tex. first we check that we're running against
+% something that's modern enough to have the command for checking
+%
+\expandafter\ifx\csname checkNRCDOCdate\endcsname\relax
+ \typeout{*** An old version of nrcdoc.sty has been detected}
+ \typeout{*** Please *delete* nrcdoc.sty to allow LaTeX to generate a
+ new version}
+\else
+%
+% we are using a recent enough version: use the checking command to
+% compare with the date in the \ProvidePackage command in the package;
+% the date here *must* be updated, in the standard latex format, in
+% parallel with the date in the package.
+%
+ \checkNRCDOCdate{2001/11/15}
+\fi
+
+\begin{document}
+
+%% Titleblock:
+\twocolumn[
+\begin{center}
+ \bfsl National Research Council \\
+ \vspace{.75pc}
+ Research Press \\
+ \vspace{.5pc}
+ \Large\bf \LaTeX{} User Guide for Journals\footnotemark
+\end{center}
+
+\vspace{1pc}
+
+]
+
+\footnotetext{This document is available from your local CTAN site in
+ \texttt{macros/latex/contrib/supported/nrc/} in both \texttt{.ps}
+ and \texttt{.pdf} formats.}
+
+
+%% Section 1:
+\section{Basic coding}
+
+All \LaTeX{} documents must include these three commands:
+
+\begin{verbatim}
+ \documentclass{...}
+ ... <-- `preamble'
+ \begin{document}
+ ... <-- `body'
+ ...
+ \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|nrc1|).
+
+ \item Between the first two commands comes the material known as
+ the `preamble', which includes additional packages (and their
+ options), as well as any file-specific macros.
+
+ \item Between the 2nd and 3rd commands comes the actual contents of
+ the article --- known as the `body' of the file.
+\end{enumerate}
+
+\noindent Commands are usually of the following types:
+
+\begin{enumerate} \itemsep=0pt
+ \item {\bf control sequences} begin with a backslash ( \blash\ ).
+
+ \item {\bf environments} use matching \verb|\begin{...}| and\break
+ \verb|\end{...}| commands (i.e., \verb|\begin{document}| must
+ eventually be matched with \verb|\end{document}|).
+
+ \item {\bf optional} arguments are within square brackets \verb|[...]|
+\end{enumerate}
+
+
+%% Section 2:
+\section{Document classes and options}
+
+\NRC{} journals are set either in full-width, using the \texttt{nrc1}
+class, or in 2-column format, using the \texttt{nrc2} document class.
+
+The following represent the options for both document classes. Note
+that most articles will {\bf not} require all of them; as well, some
+options are only for \texttt{nrc2}.
+
+\begin{verbatim}
+ \documentclass[<options here>]{<class here>}
+ author nrc1
+ PLUS usecmfonts OR nrc2
+ OR type1rest
+ french
+ nonumbib
+ nrc1 only: leqno
+ nrc2 only: reqno
+
+\end{verbatim}
+
+\newpage
+
+\noindent To combine options, insert a comma between each option:
+
+\begin{verbatim}
+ \documentclass[type1rest,genTeX,nonumbib]{nrc2}
+\end{verbatim}
+
+The following sections describe the options available to both classes,
+and then those options which are specific to \texttt{nrc1} or
+\texttt{nrc2} only. Options specific to in-house production work are
+described separately; see section~\ref{inhouse}.
+
+
+%% Section 2.1:
+\subsection{Options for both classes}
+
+{\bf Note:} Do not load options or packages which are never accessed;
+their presence implies they are required and may cause unnecessary
+searches for coded material which is not, in fact, present.
+
+For the convenience of authors, the publicly available class files for
+authors have a number of options already automated:
+%
+ \begin{verbatim}
+ author,genTeX,type1rest,usecmfonts
+ \end{verbatim}
+%
+Additionally, a number of in-house diagnostic messages are turned off,
+so as not to interfere with processing. Where a default selection is
+not appropriate, the following provides information on these options.
+
+
+\begin{description} \itemsep=0pt
+ \item [\texttt{author}]
+ This option selects a configuration appropriate for author use
+ of the class; it is enabled by default when a
+ publicly distributed copy of the class is loaded.
+
+ The \texttt{author} option automatically invokes the
+ \texttt{genTeX} option, as well as one of the two font
+ options: \texttt{type1rest} or \texttt{usecmfonts}. See below
+ for details.
+
+
+ \item [{\tt genTeX}]
+
+ By use of this option, you declare that you are using a
+ generic/public domain version of \TeX{}; it {\bf must} be
+ used in conjunction with one of \texttt{usecmfonts} and
+ \texttt{type1rest} (see below).
+
+ The \texttt{author} option automatically selects the
+ \texttt{genTeX} option.
+
+
+ \item [{\tt type1rest}]
+
+ By use of this option, you declare that you have access to a
+ PostScript printer or other interpreter, and may use ``basic''
+ PostScript fonts to make a rough approximation to those that
+ will be used in the published paper. Do not use this option in
+ combination with the \texttt{usecmfonts} option.
+
+ If the \texttt{author} option has been selected, the class
+ will automatically decide whether to use \texttt{usecmfonts}
+ or \texttt{type1rest} by default. The automatic selection may
+ be incorrect, but you may over-ride it by specifying the
+ \texttt{type1rest} option.
+
+
+ \item [{\tt usecmfonts}]
+
+ By use of this option, you declare that you do not have the
+ ``basic'' PostScript fonts to make a rough approximation to
+ those that will be used in the published paper: the \verb|cm|
+ (\emph{Computer Modern}) fonts that this option selects are
+ available in any generic/public domain \TeX{} distribution, so
+ this option will always be available. Do not use this option
+ in combination with the \texttt{type1rest} option.
+
+ If the \texttt{author} option has been selected, the class
+ will automatically decide whether to use \texttt{usecmfonts}
+ or \texttt{type1rest} by default. The automatic selection may
+ be incorrect, but you may over-ride it by specifying the
+ \texttt{usecmfonts} option.
+
+
+ \item [{\tt french}]
+
+ For French-language articles.\label{frenchclassoption} It
+ configures the \NRC{} document classes to print all the
+ auto\-mated textual ele\-ments (in the author IDbox, for
+ figures, tables, biblio\-graphies, etc.)\ in French as per
+ \NRC{} speci\-fi\-cations. To be used in concert with:
+
+\begin{verbatim}
+ \usepackage[english,french]{babel}
+\end{verbatim}
+
+ See section~\ref{babelinfo} for details on using the
+ \textsf{babel} package in all articles, regardless of
+ language. For two-column bilingual texts, see
+ section~\ref{bilingpream}.
+
+
+ \item [{\tt nonumbib}]
+
+ This option removes numbers (i.e., `labels') from
+ \verb|\bibitem| entries; material is set with a hanging
+ indent. The default is to have numbered bibliographic
+ entries.
+\end{description}
+
+
+%% Section 2.2:
+\subsection{Options specific to only one class}
+
+\begin{description} \itemsep=0pt
+ \item [{\tt leqno}] \hfill for \texttt{nrc1} only
+
+ This option puts equation numbers to the left margin;
+ default is to have them on the right.
+
+ \item [{\tt reqno}] \hfill for \texttt{nrc2} only
+
+ This option puts equation numbers to the right margin;
+ default is to have them on the left.
+\end{description}
+
+\noindent One other difference between the packages relates to the
+position of the \verb|\maketitle| command. See
+page~\pageref{maketitle} for details.
+
+
+%% Section 3:
+\section{The preamble}
+
+The preamble area of the file should specify all packages and macros
+definitions (if any) used; macros in particular should not be defined
+within the body of the file.
+
+
+%% Section 3.1:
+\subsection{Useful packages}
+
+The following packages and their options are often necessary (but note
+that \textsf{babel} is necessary at all times). Note that package
+order can be significant, on occasion. In particular, it is
+recommended that graphics packages be loaded immediately after the
+document class.
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash usepackage\char`\{graphicx\char`\}}]
+
+ Graphics (figures, illustrations,\break and so on) should be
+ included using the standard \LaTeX{} \texttt{graphicx}
+ package: use of this package permits portability across
+ different implementations of \TeX{} (which itself has no
+ graphics primitive commands).
+
+ Your \TeX/\LaTeX{} system may offer documentation; otherwise
+ see \textsl{The \LaTeX{} Graphics Companion\/} (see
+ section~\ref{documentation}).
+
+ Remember to specify the printer driver as a package option,
+ if necessary (e.g., \verb|dvips|, \verb|dvipsone|, etc.).
+
+ \item [{\tt \blash usepackage[figuresright]\char`\{rotating\char`\}}]
+
+ \quad The \verb|rotating|\break 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 \texttt{rotating.sty}.} is only
+ required when tables or figures need to 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 \NRC{} style requirements.
+
+ \item [{\tt \blash usepackage\char`\{amsmath\char`\}}]
+
+ A great deal of additional functionality is provided with
+ this package, and the \NRC{} document classes have been
+ designed to work smoothly with it. Using \texttt{amsmath}
+ automatically loads the following packages: \texttt{amstext},
+ \texttt{amsgen}, and \texttt{amsbsy}. The \texttt{amsmath}
+ package is described in great detail in three documents:
+
+ \begin{enumerate} \itemsep=0pt
+ \item The revised version of chap.~8 of {\sl The \LaTeX{}
+ Companion} is a good guide (see section~\ref{documentation}
+ for details). As printed in the book, chap.~8 is out of
+ date and should not be referenced.
+
+ \item A useful set of documentation is available via the {\small
+ AMS}'s web site. {\small URL}
+ % \texttt text broken so it doesn't run into the margin and
+ % disappear; would be better to use the url package, but...
+ \texttt{http://www.ams.org/tex/ amslatex.html} offers a
+ ``Short Math Guide'', a set of frequently asked questions
+ (with answers), as well as various ``Readme'' files.
+
+ \item Current \LaTeX{} installations have a file
+ \texttt{amsldoc}; it is also available via the {\small
+ AMS} web site (see above). The material is essentially the
+ same as the revised chap.~8 mentioned above, but the
+ differences in presentation are sometimes useful to
+ consider.
+\end{enumerate}
+
+ \item [{\tt \blash usepackage\char`\{amssymb\char`\}}]
+
+ This package automatically loads the
+ \texttt{amsfonts} package. Together, they provide
+ special characters and symbols frequently used by the
+ mathematics and scientific communities.
+
+ The \texttt{amsfonts} package provides access to the
+ following font sets: Euler (Fraktur, Roman, Script,
+ extensions); Computer Modern (math bold ital\-ic, symbol,
+ extensions, in the smaller sizes); Cyrillic (lightfact, bold,
+ italic, smallcaps); and the \texttt{msam} and \texttt{msbm}
+ fonts, familiar to Rev\TeX{} users.
+
+
+ \item [{\tt \blash usepackage\char`\{bm\char`\}}]
+
+ This package simplifies the use of bold symbols and other
+ objects in math mode. It defines a single command,
+ \verb|\bm{...}|, which is used in math mode, and causes its
+ argument to be typeset in the appropriate math bold font.
+ See \verb|bm.sty| documentation for details.\label{bm}
+
+ {\bf Note:} If a warning message about too many math
+ alphabets arises, insert the following code {\bf above} the
+ \verb|\usepackage{bm}| line:
+
+\begin{verbatim}
+ \newcommand\hmmax{0} % default 3
+ \usepackage{bm}
+\end{verbatim}
+%
+ See \verb|bm.sty| documentation for details.
+
+
+ \item [{\tt \blash usepackage\char`\{cite\char`\}}]
+
+ Authors should 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[...,...]\char`\{babel\char`\}}]
+
+ The \textsf{babel}\label{babelinfo} package is used to manage
+ the typesetting requirements of multilingual documents.
+ Different cultures have different typesetting conventions,
+ and \textsf{babel} enables the \LaTeX{} user to apply the
+ appropriate conventions to the different parts of a
+ multilingual document. Since \NRC{} publications are
+ typically multilingual, \textsf{babel} has an important
+ r\^ole to play in their preparation.
+
+ \begin{itemize} \itemsep=0pt
+ \item English-language articles have a French-language
+ `Resum\'e', which requires French hyphenation and
+ punctuation. Insert the following line --- and notice the
+ order of the language options:
+
+\begin{verbatim}
+ \usepackage[french,english]{babel}
+\end{verbatim}
+
+ \item French-language articles have an English-language
+ `Abstract', which requires English hyphenation and
+ punctuation. Insert the following line and again notice
+ the order of the language
+ options:\footnote{\textsf{Babel}, like so many computer
+ programs, believes that the last should be first, and
+ therefore proceeds backwards through its options, thus
+ making the last one typed the one selected first.}
+
+\begin{verbatim}
+ \usepackage[english,french]{babel}
+\end{verbatim}
+
+ \textbf{In addition to} the \textsf{babel} package,
+ French-language articles must \textbf{also} include the
+ \verb|french| option to the document class, as mentioned
+ earlier in section~\ref{frenchclassoption}.
+
+ The \textsf{babel} package invokes French hyphenation
+ patterns\footnote{Use \texttt{\blash-} to signal additional
+ potential hyphenation points.} as well as some of the
+ (European) French typesetting conventions (e.g., space before
+ some punctuation).
+ \end{itemize}
+\end{description}
+
+\noindent These packages and others can be found either on your
+machine or can be acquired from {\small CTAN}, the Comprehensive
+\TeX{} Archive Network; use the search facilities at
+\url{www.ctan.org/search}. The \NRC{} document classes and this
+documentation can be found on {\small CTAN} in
+\url{macros/latex/contrib/supported/nrc/}.
+
+
+%% Section 3.2:
+\subsection{Additional macros}
+
+\begin{enumerate} \itemsep=0pt
+ \item Avoid creating too many personal macros, which may conflict
+ with the \NRC{} document classes (and possibly with other
+ packages) and thereby slow in-house processing of files.
+ Where these are used, macros not actively invoked in the
+ file should be pruned out.
+
+ \item Whenever possible, define your macros using the \LaTeX{}
+ \verb|\newcommand| mechanism, rather than the \TeX{} primitive
+ \verb|\def|; this way, \LaTeX{} itself will detect any name
+ clashes you may innocently introduce.
+
+ \item Move all non-\NRC{} preamble material, including author
+ macros, to the end of the file (after \verb|\end{document}|),
+ rather than deleting it. Reintroduce only what is needed.
+
+ \item Where author macros are needed, they should all be gathered
+ at the top of the file in the preamble area, after all
+ packages have been loaded, and clearly marked as being author
+ macros:\label{authmacros}
+
+\begin{verbatim}
+%%%%%%%% Author macros begin:
+...
+...
+%%%%%%%% Author macros end
+\end{verbatim}
+
+ \item Similarly, move all \verb|\let| statements to the preamble
+ area, where they are immediately visible to the editor.
+\end{enumerate}
+
+
+%% Section 4:
+\section{The body}
+
+All articles have the following elements:
+
+\begin{enumerate} \itemsep=0pt
+ \item titleblock and author information
+
+ \item abstract and 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 in-line and display mathematics
+
+ \item enumerated lists
+
+ \item tables
+
+ \item figures and illustrations (e.g., PostScript)
+
+ \item footnotes
+
+ \item offset quoted passages
+
+ \item acknowledgements
+\end{enumerate}
+
+
+%% Section 4.1:
+\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} \itemsep=0pt
+ \item [{\tt \blash title\char`\{...\char`\}}] \mbox{}
+
+ Lines will be broken automatically; line breaks can be forced
+ by using \verb|\\|.
+
+ For sub- and superscripts, use \verb|\textsubscript| and
+ \verb|\textsuperscript|, respectively.
+
+ Notes on the title may be inserted using the standard \LaTeX{}
+ command \verb|\thanks|. The text will print in the IDbox, and
+ numbering will be synchronised with that of the IDbox notes.
+
+ \item [{\tt \blash author[...]\char`\{Author1\char`\}}] \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' (Fr.\ `et') between the last and
+ second-last names, both in the titleblock and in the IDbox
+ area.
+
+ \item [{\tt \blash address[label1]\char`\{addr1\char`\}}] \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. Notice that \verb|\address| always refers to the immediately
+preceding \verb|\author|.
+
+\begin{description} \itemsep=0pt
+ \item \verb|\author{Author1}|\quad defines first author
+
+ \item \verb|\address[label1]{Address1}|\quad defines an address for
+ {\sl Author1\/} and tags it as \verb|[label1]|
+
+ \item \verb|\author{Author2}|\quad this author doesn't have an
+ address, so the IDbox will use the immediately preceeding
+ author's address (i.e., {\sl Address1}
+
+ \item \verb|\author{Author3}|\quad defines a third author
+
+ \item \verb|\address{Address3}|\quad third author is at an address
+ of their own
+
+ \item \verb|\author{Author4}|\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.
+
+ \begin{description}
+ \item [{\tt \blash correspond\char`\{...\char`\}}] \mbox{}
+
+ Usually one author is selected from all co-authors to deal
+ with correspondence. Insert the author's e-mail address
+ into the argument. The following text will be prepended:
+ `Corresponding author (email: ).' and in French,
+ `Auteur correspondant (courriel\,: )'.
+
+
+ \item [{\tt \blash present\char`\{...\char`\}}] \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:' (Fr.\ `Adresse actuelle\,:').
+
+
+ \item [\mbox{}{\tt \blash AddressNote\char`\{...\char`\}}]
+ Obsolete. See \verb|\IDnote|, below.
+
+
+ \item [{\tt \blash IDnote\char`\{...\char`\}}] \mbox{}
+
+ Allows the user to input any information they wish, with
+ no automatic text being added (formerly called
+ \verb|\AddressNote|, which implied a more restricted
+ use). Both macros are available but \verb|\IDnote| gives
+ the user a more generic macro name to remember and use for
+ any type of note within the IDbox.
+ \end{description}
+
+ \item [{\tt \blash dedication\char`\{...\char`\}}] \mbox{}
+
+ Will print a dedicatory text (in italics) in the IDbox area,
+ between the `Received/Accepted' and the author/address
+ sections.
+
+ \item [{\tt \blash abbreviations\char`\{...\char`\}}] \mbox{}
+
+ Automatic printing of the word `\textit{Abbrevia\-tions: \/}'
+ (Fr. `\textit{Abbr\'eviations\,: \/}'), followed by text
+ input inside the argument (the curly braces). Forced line
+ breaks (via \verb|\\|) can be used to separate entries.
+
+ \item [{\tt \blash shortauthor\char`\{author list\char`\}}]
+ \mbox{}
+
+ Shortened list of author names for use in the right running
+ header. This macro must be present (its absence generates an
+ error message), and should appear below all the
+ author-address information
+
+\newpage
+
+ \item [{\tt \blash maketitle}] \mbox{}\label{maketitle}
+
+ This command activates the titleblock commands.
+
+ The \verb|nrc1| class requires this command to appear
+ \textbf{before} the abstract/resum\'e block of text.
+
+ The \verb|nrc2| class requires this command to appear
+ \textbf{after} the abstract/resum\'e block of text.
+
+ \item [{\tt \blash maketitle*}] \hfill [an \NRC\ macro]\mbox{}
+
+ With the \verb|nrc2| class only, when Abstracts/Resumes spill
+ over to a second page, a horizontal rule may be needed before
+ the regular article text begins. To generate this rule use
+ \verb|\maketitle*| instead of \verb|\maketitle|.
+\end{description}
+
+
+%% Section 4.2:
+\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} \itemsep=0pt
+ \item [{\tt \blash begin\char`\{abstract\char`\}\ ... \blash
+ end\char`\{abstract\char`\}}] \hfill English
+
+ \item [{\tt \blash begin\char`\{resume\char`\}\ ... \blash
+ end\char`\{resume\char`\}}] \hfill French
+\end{description}
+
+\noindent Some journals may require the following, which should appear
+\textbf{inside} the abstract environments:
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash keywords\char`\{...\char`\}}] \hfill [an \NRC\
+ macro]\mbox{}
+
+ Automatically prints `\textit{Keywords:}', followed by
+ whatever text is input inside the argument (the curly
+ braces).
+
+ \item [{\tt \blash motscles\char`\{...\char`\}}] \hfill [an \NRC\
+ macro]\mbox{}
+
+ Automatically prints `\textit{Mots cl\'es\,:}', followed by
+ whatever text is input inside the argument (the curly
+ braces).
+
+ \item [{\tt \blash PACS\char`\{...\char`\}}] \hfill [an \NRC\
+ macro]\mbox{}
+
+ Automatically prints `PACS Nos.:' (Fr. `PACS
+ N\textsuperscript{os}\,:'), followed by whatever material is
+ input inside the argument.
+
+ \item [{\tt \blash PACS*\char`\{...\char`\}}] \hfill [an \NRC\
+ macro]\mbox{}
+
+ Automatically prints `PACS No.:' (Fr. `PACS
+ N\textsuperscript{o}\,:'), followed by whatever material is
+ input inside the argument.
+\end{description}
+
+
+%% Section 4.3:
+\subsection{Headings and subheadings}
+
+Five levels, numbered automatically.\footnote{An alternate set of
+headings commands also exists: \texttt{\blash Asection},
+\texttt{\blash Bsection}, \texttt{\blash Csection}, \texttt{\blash
+Dsection}, and \texttt{\blash Esection}, for levels 1 through 5,
+respectively.} 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*{Acknowledgements}|.
+
+For sub- and superscripts in section titles, use the macros
+\verb|\textsubscript| and \verb|\textsuperscript|, respectively.
+
+\begin{enumerate} \itemsep=0pt
+ \item {\tt \blash section\char`\{...\char`\}} Level-1 heading
+
+ \item {\tt \blash subsection\char`\{...\char`\}} Level-2 heading
+
+ \item {\tt \blash subsubsection\char`\{...\char`\}} Level-3
+ heading
+
+ \item {\tt \blash subsubsubsection\char`\{...\char`\}} Level-4
+ heading \hfill [\NRC]
+
+ \item {\tt \blash paragraph\char`\{...\char`\}} Level-5 heading
+\end{enumerate}
+
+
+%% Section 4.4:
+\subsection{Text}
+
+Same as the default \LaTeX{} commands:
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash begin\char`\{quote\char`\}\ ... \blash
+ end\char`\{quote\char`\}}]
+
+ \item [{\tt \blash begin\char`\{enumerate\char`\}\ ... \blash
+ end\char`\{enumerate\char`\}}]
+
+ \item [{\tt \blash begin\char`\{itemize\char`\}\ ... \blash
+ end\char`\{itemize\char`\}}]
+
+ \item [{\tt \blash begin\char`\{description\char`\}\ ... \blash
+ end\char`\{description\char`\}}]
+
+ \item [{\tt \blash footnote\char`\{...\char`\}}]
+\end{description}
+
+\noindent Where lists must be flushed to the left margin, there are
+two \NRC-specific environments to use:
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash begin\char`\{flenumerate\char`\}\ ... \blash
+ end\char`\{flenumerate\char`\}}]\hfill [\NRC] \mbox{}
+
+ Generates a numbered list (first level only) with labels
+ flushed to the left margin. No nesting possible.
+
+ \item [{\tt \blash begin\char`\{flitemize\char`\}\ ... \blash
+ end\char`\{flitemize\char`\}}]\hfill [\NRC] \mbox{}
+
+ Generates a bulletted list (first level only) with labels
+ flushed to the left margin. No nesting possible.
+\end{description}
+
+
+%% Section 4.4.1:
+\subsubsection{Column switching in \texttt{nrc2}}
+
+On occasion, material for 2-column journals is best set full-width,
+interrupting the two text columns. For equations, the following
+customized code will achieve this effect:
+
+\begin{verbatim}
+ \begin{FullWidth}[0.5]
+ \LeftColumnBar
+ <equation to span both columns>
+ \RightColumnBar
+ \end{FullWidth}
+\end{verbatim}
+
+The following description provides details of each step:
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash begin\char`\{FullWidth\char`\}\ ... \blash
+ end\char`\{FullWidth\char`\}}]
+
+ This environment encloses the material which is to span the
+ two columns. The text for the two columns immediately above
+ this environment will be balanced. Text immediately below
+ the environment will resume the 2-column layout.
+
+ The optional \texttt{[0.5]} argument (`one half' in this
+ example) is an adjustment factor, affecting the split between
+ left and right columns. Default is `1.0', the units are
+ nominal line depths in the default font size; increasing the
+ factor tends to increase the number of lines in the left
+ column.
+
+ \item [{\tt \blash LeftColumnBar}] \mbox{}
+
+ This draws a rule below the left column of the 2-column text
+ which is above the full-width material.
+
+ \item [{\tt \blash RightColumnBar}] \mbox{}
+
+ This draws a rule above the right column of 2-column text
+ which is below the full-width material.
+
+ \item [{\tt \blash BalanceColumns[0.5]}] \mbox{}
+
+ This command is used at the end of a file, in order to
+ balance the final page.
+
+ The optional argument serves the same purpose and is used
+ in the same way as that for \verb|\begin{FullWidth}|.
+\end{description}
+
+Where both equations and text must span two columns, the text portions
+must \textit{additionally} be enclosed in the following environment:
+
+\begin{verbatim}
+ ...
+ \begin{WideText}
+ <text material>
+ \end{WideText}
+ ...
+\end{verbatim}
+%
+The text will then be flush left, and indented 3em from the right
+margin, as per \NRC{} requirements, while the equation numbers will be
+flushed to the right (where that is the style). The two combined will
+look like this:
+
+\begin{verbatim}
+ \begin{FullWidth}[0]
+ \LeftColumnBar
+ \begin{equation}
+ <equation material here>
+ \end{equation}
+
+ \begin{WideText}
+ <text material>
+ \end{WideText}
+
+ \begin{equation}
+ <equation material here>
+ \end{equation}
+ \RightColumnBar
+ \end{FullWidth}
+\end{verbatim}
+
+
+%% Section 4.5:
+\subsection{Mathematics}
+
+In addition to default \LaTeX{} commands, the \texttt{amsmath} package
+provides a number of useful enhancements. Consult both the revised
+chap.~8 of \textsl{The \LaTeX{} Companion} and the AMS\LaTeX{}
+documentation for details (see section~\ref{documentation}). See also
+\verb|bm.sty| for enhanced font handling inside math mode
+(section~\ref{bm}).
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash begin\char`\{equation\char`\}\ ... \blash
+ end\char`\{equation\char`\}}] \mbox{}
+
+ \item [{\tt \blash begin\char`\{array\char`\}\ ... \blash
+ end\char`\{array\char`\}}] \mbox{}
+
+ \item [{\tt \blash begin\char`\{subequation\char`\}\ ... \blash
+ end\char`\{subequation\char`\}}] \mbox{}
+
+ This is an \verb|amsmath| environment {\bf within which}
+ other environments are used, to achieve lettered sub-equation
+ numbers: e.g., 1.2a, 1.2b, etc. There is a file
+ \texttt{subeqn.tex} on most \TeX{} installations with
+ additional details.
+\end{description}
+
+\noindent In addition to the usual environments, two \NRC\ macros
+allow further customisation of the form of the equation number:
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash
+ numberby\char`\{...\char`\}\char`\{...\char`\}}] \hfill [an
+ \NRC\ macro]\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 avoids having
+ to load the {\tt amsmath} package in order to access the {\tt
+ \blash numberwithin} command, which does the same thing.}
+
+\begin{verbatim}
+ \numberby{equation}{section}
+\end{verbatim}
+
+ The first argument contains what element is being numbered;
+ the second indicates that section numbers should be included
+ in that numbering.
+
+ \item [{\tt \blash eqnoformat}] \hfill [an \NRC\ macro]\mbox{}
+
+ The \verb|nrc2| class default format is for square brackets
+ around equation numbers. Other options (i.e., parenthe\-ses)
+ can be achieved via the following definition (placed in the
+ preamble, after all packages have been loaded):
+
+\begin{verbatim}
+ \renewcommand{\eqnoformat}[1]{(#1)}
+\end{verbatim}
+\end{description}
+
+
+%% Section 4.6:
+\subsection{Tables, Figures, Captions}
+
+The following float parameters are useful to include in the preamble
+area:
+
+\begin{description} \itemsep=0pt
+ \item [nrc1]
+\begin{verbatim}
+ \renewcommand{\topfraction}{.95}
+ \renewcommand{\textfraction}{.05}
+ \renewcommand{\floatpagefraction}{.95}
+\end{verbatim}
+
+ \item [nrc2]
+\begin{verbatim}
+ \renewcommand{\topfraction}{.95}
+ \renewcommand{\floatpagefraction}{.95}
+ \renewcommand{\dbltopfraction}{.95}
+ \renewcommand{\textfraction}{.05}
+ \renewcommand{\dblfloatpagefraction}{.95}
+\end{verbatim}
+\end{description}
+
+
+%% Section 4.6.1:
+\subsubsection{Tables}
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash begin\char`\{table\char`\}\ ... \blash
+ end\char`\{table\char`\}}] \mbox{}
+
+ For regular tables, up to same width as text (page-wide or
+ column-wide).
+
+ \item [{\tt \blash begin\char`\{table*\char`\}\ ... \blash
+ end\char`\{table*\char`\}}] \mbox{}
+
+ For tables spanning two columns.
+
+ \item [{\tt \blash begin\char`\{sidewaystable\char`\}\ ... \blash
+ end\char`\{sidewaystable\char`\}}] \mbox{}
+
+ For rotating a table sideways. To ensure rotation is in
+ correct direction, remember to add the \verb|figuresright|
+ option to the \verb|rotating| package in the Preamble.
+
+ \item [{\tt \blash begin\char`\{sidewaystable*\char`\}\ ... \blash
+ end\char`\{sidewaystable*\char`\}}] \mbox{}
+
+ For rotating a table sideways across a 2-column page. As for
+ above, make sure the \verb|figuresright| option has been
+ added to the \verb|rotating| package, loaded in the Preamble.
+
+ \item [{\tt \blash begin\char`\{tabular\char`\}\ ... \blash
+ end\char`\{tabular\char`\}}] \mbox{}
+
+ {\bf Note:} use \verb|\tabcolsep| to slightly reduce/increase
+ intercolumn space.
+
+
+ \item [{\tt \blash hline*}]\hfill [an \NRC\ macro] \mbox{}
+
+ For the thicker lines at top/bottom of tables. Regular 1pt
+ rules accessed via default \verb|\hline| command.
+\end{description}
+
+
+%% Section 4.6.2:
+\subsubsection{Figures}
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash begin\char`\{figure\char`\}\ ... \blash
+ end\char`\{figure\char`\}}] \mbox{}
+
+ For regular figures, up to same width as text (page-wide or
+ column-wide).
+
+ \item [{\tt \blash begin\char`\{figure*\char`\}\ ... \blash
+ end\char`\{figure*\char`\}}] \mbox{}
+
+ For figures spanning two columns.
+\end{description}
+
+
+%% Section 4.6.3:
+\subsubsection{Captions}
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash topcaption\char`\{...\char`\}}] \hfill [an
+ \NRC\ macro]\mbox{}
+
+ \NRC\ style has all captions at the top of their table or
+ figure. Syntax is the same as for \LaTeX{} default
+ \verb|\caption|.
+
+ Captions will be automatically sized to the width of their
+ table, provided the file is processed at least twice. Should
+ a caption require a different width, the following code, used
+ inside the float environment, will work:
+
+\begin{verbatim}
+ \setlength{\captionwidth}{ ... }
+ \topcaption{ ... }
+\end{verbatim}
+
+ \item [{\tt \blash sepcaption\char`\{...\char`\}}] \hfill [an \NRC\
+ macro]\mbox{}
+
+ For captions separated from their full-column or full-page
+ tables and figures. Caption will appear at top of next column
+ or next page. Usage is \textbf{different} from regular
+ caption commands in that it must appear in its own separate
+ \texttt{table} environment:
+%
+\begin{verbatim}
+ \begin{table}
+ \sepcaption{.....}
+ \end{table}
+
+ \begin{table}
+ <contents of table>
+ \end{table}
+\end{verbatim}
+\end{description}
+
+
+%% Section 4.6.4:
+\subsubsection{Centering}
+
+To centre any of these elements inside a float, the \verb|\centering|
+command is preferred to the \verb|{center}| environment, which adds
+its own vertical space and hence interferes with \NRC{} spacing
+requirements.
+
+
+%% Section 4.7:
+\subsection{Cross-Referencing}
+
+As with all cross-referencing codes, process file 2 or even 3 times,
+to ensure that all citations and labels have been resolved, until the
+following message no longer appears:\footnote{Note, however, that if
+cross-referencing codes are incomplete, \textbf{[?]} will remain. In
+such cases, the warning message reads: \texttt{LaTeX Warning: There
+were undefined references}.}
+
+\begin{verbatim}
+ LaTeX Warning: Label(s) may have changed.
+ Rerun to get cross-references right.
+\end{verbatim}
+
+\noindent Components of an article affected by cross-referencing ---
+and thus requiring several processing runs, include the following:
+
+\begin{itemize} \itemsep=0pt
+ \item cross-refs to tables and figures, and to equations, etc. \\
+ (via \verb|\ref|, \verb|\pageref|, and \verb|\label|)
+
+ \item automatic sizing of caption widths for floats \\
+ (via \verb|\topcaption|)
+
+ \item bibliographies \\
+ (via \verb|\cite| et al., and \verb|\bibitem|)
+\end{itemize}
+
+To ensure that cross-referencing via the \verb|\label| and \verb|\ref|
+commands is correctly associated with the matching tables and figures,
+it is recommended that the \verb|\label| command appear
+\textbf{inside} the closing parentheses of caption commands.
+
+
+%% Section 4.8:
+\subsection{Bibliography}
+
+The default macros \verb|\cite| and \verb|\bibitem| are usually
+adequate for citations and bibliography entries. Additional
+flexibility can be had by using the \verb|cite| package; for more
+complicated requirements, authors may choose to use the \verb|natbib|
+package. Authors using the latter must remember to submit their
+\verb|.bib| file, and are reminded to use the referencing style and
+order of elements appropriate to the journal to which they are
+submitting.\footnote{As yet, there is no \texttt{nrc.bst} file for the
+NRC.}
+
+The main \verb|cite| commands are:
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash cite\char`\{...\char`\}}] \mbox{}
+
+ To produce cross-referencing digit or digits inside square
+ brackets.
+
+ \item [{\tt \blash citen\char`\{...\char`\}}] \mbox{}
+
+ To produce cross-referencing digit with {\bf no} brackets.
+\end{description}
+
+\noindent Further options are described in the \verb|cite|
+documentation. However, one in particular will be noted here, as some
+\NRC{} journals require in-line citations to appear within
+parentheses, rather than square brackets. If this is the case, the
+following code should be added to the preamble (after all packages,
+including \verb|cite|, have been loaded):
+
+\begin{verbatim}
+ \renewcommand{\citeleft}{(}
+ \renewcommand{\citeright}{)}
+\end{verbatim}
+
+The references/bibliography section at the end of the paper uses the
+default \LaTeX{} commands:
+
+\begin{verbatim}
+ \begin{thebibliography}{99}
+ \bibitem[...]{...}
+
+ \bibitem[...]{...}
+
+ \end{thebibliography}
+\end{verbatim}
+
+
+%% Section 4.9:
+\subsection{Appendices}
+
+Where only the word `Appendix' is needed, use the command
+\verb|\section*{Appendix}| (note that the asterisk suppresses any
+section numbering, either by digit or letter). If equations within the
+Appendix are to restart at `1', insert
+
+\begin{verbatim}
+ \setcounter{equation}{0}
+\end{verbatim}
+
+If more than the word `Appendix' is to appear, then the
+\verb|\section| command must be augmented by either \verb|\appendix|
+or \verb|\appendix*|.
+
+The \verb|\appendix| command (unmodified) behaves as in the standard
+\LaTeX{} classes; so, for `A. Title of First Appendix', the following
+code is used:
+%
+\begin{verbatim}
+ \appendix
+ \section{Title of First Appendix}
+\end{verbatim}
+
+For `Appendix A:' + a heading (and then `Appendix B:' + its heading,
+etc.), the following code will do the job (notice that the word
+`Appendix' is \textbf{not} input):
+
+\begin{verbatim}
+ \appendix*
+ \section{A subheading}
+ ...
+ \section{Next subheading}
+\end{verbatim}
+
+Both \verb|\appendix| and \verb|\appendix*| preserve \verb|\numberby|
+commands, as one might expect: equations in appendix~A are numbered
+`A.1', `A.2', etc. To ensure numbering is correctly applied throughout
+all appendices, insert \verb|\numberby| {\bf before} the
+\verb|\section| command.
+
+
+%% Section 5:
+\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
+
+
+%% Section 5.1
+\subsection{Books and articles\label{documentation}}
+
+\begin{description} \itemsep=0pt \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{} Archive
+ Network; a list of site 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
+ superseded 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, Boston
+ and Springer Verlag, New York, 1996).
+
+ \item [{\sl First Steps in \LaTeX:}] by George Gr\"atzer
+ (Birkh\"auser, Boston, 1999).
+
+ \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, 1998, 3rd 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.
+
+ The latest version of the Reckdahl material can be found on
+ {\small CTAN} in \texttt{info/epslatex} in both \texttt{.ps}
+ and \texttt{.pdf} formats.
+\end{description}
+
+
+%% Section 5.2
+\subsection{Electronic resources}
+
+\begin{description} \itemsep=0pt
+ \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. Consult your local technical support group to see
+ if newsgroup access if available via your browser.
+
+ \item [FAQ:] put together by the UK \TeX{} Users Group; available
+ via the {\small TUG} web page.
+
+ \item [Listserv lists:] there are a great number of specialised
+ lists. Consult the {\small TUG} web pages for details.
+
+ \item [http://groups.google.com/] holds an archive of usenet
+ discussions, and may be used to review current topics of
+ concern, or to search for answers to specific questions.
+ Unfortunately, the service does {\bf not} offer facilities
+ for posting to usenet, at present.
+\end{description}
+
+\newpage
+
+
+%% Section 6:
+\section{In-house Coding for Articles\label{inhouse}}
+
+A template file with all the main preamble lines of code already
+input, is available (see Appendix~B). At the top of the new file,
+insert the contents of:
+%
+\begin{verbatim}
+ nrc-opening.tex
+\end{verbatim}
+%
+and begin to {\bf un}comment those lines which are pertinent for the
+file. There are brief notes in the template, indicating the purpose of
+each macro line, along with cross-references to pages in these
+guidelines. Delete or leave commented those lines which are not
+relevant to the file.
+
+{\bf Note:} Only invoke those packages and/or macros which are present
+in the file; for example, it is misleading to load a graphics package
+if there are no figures in the file.
+
+
+
+%% Section 6.1
+\subsection{Changing class option choices}
+
+Included in the main class options are some which are intended for
+authors only; remove any of the following options before processing
+author files in-house:
+
+\begin{verbatim}
+ author genTeX type1rest usecmfonts
+\end{verbatim}
+
+\noindent On the other hand, there are a number of class options
+related to various stages of in-house production and thus intended
+only for \NRC{} editorial staff. Below is a list of these options,
+followed by a brief description of their purpose:
+
+\begin{verbatim}
+ \documentclass[<options here>]{<class here>}
+ breakaddress nrc1
+ for nrc2 only: twocolid OR nrc2
+ for nrc2 only: twocolid*
+ preprint
+ proof
+ pagnf
+ trimmarks
+ finalverso
+\end{verbatim}
+
+\begin{description} \itemsep=0pt
+ \item [{\tt breakaddress}]
+%
+ This 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.
+
+ \item [{\tt twocolid}]
+%
+ For \texttt{nrc2} only. This option affects author
+ information (the IDbox at page bottom): the text spans both
+ columns.\footnote{The default is to set all IDbox material
+ into the bottom of the left column.}
+
+ \item [{\tt twocolid*}]
+%
+ For \texttt{nrc2} only. This variation for the IDbox also
+ spans both columns, but the material inside is itself set up
+ in two columns.
+
+ \item [{\tt preprint}]
+%
+ This affects headers and footers, omitting such items as
+ dates, page numbers, and so on. For any additional text in
+ running heads (e.g., `Rapid Communication'), use
+ \verb|\shortauthor|.
+
+ \item [{\tt proof}]
+%
+ Prints a centred footer on every page with the following
+ text: `Proof/\'Epreuve'.\label{proof-pagnf}
+
+ {\bf Note:} Comment out when {\small DOI} line must appear at
+ bottom centre of opening page. See section~\ref{filenumber}.
+
+
+ \item [{\tt pagnf}]
+%
+ Prints a centred footer on every page with the following
+ text: `Pagination not final/Pagination non
+ finale'.
+
+ {\bf Note:} Comment out when {\small DOI} line must appear at
+ bottom centre of opening page. See section~\ref{filenumber}.
+
+
+ \item [{\tt trimmarks}]
+%
+ Prints cropmarks at all four corners. Note that trimmarks for
+ \texttt{nrc2} are off the regular $8.5 \times 11$-inch paper,
+ but will be visible if oversized paper is used.
+
+
+ \item [{\tt finalverso}]
+%
+ Specifies that the paper should end on a recto page (creating
+ a blank, unnumbered page if the text doesn't for itself; the
+ blank page does {\bf not} appear in the paper's page count.
+
+\end{description}
+
+
+%% Section 6.2
+\subsection{Additional packages}
+
+A number of additional packages are included in the template file {\tt
+nrc-opening.tex}. Uncomment those packages which will be needed for
+each specific article.
+
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash usepackage\char`\{color\char`\}}]
+
+ The \verb|color| package is used for in-house production of
+ reversed out text (white on black). Ensure that no driver
+ option is specified here, as it would over-ride the in-house
+ printer set-up. See section \ref{specialtitles} for details.
+
+ \item [{\tt \blash usepackage\char`\{dcolumn\char`\}}]
+
+ At present, this remains commented out as the \NRC's need for
+ left-justified decimal alignment is not possible via
+ \texttt{dcolumn}. Left-justified alignment at present is
+ achieved by using the \verb|\llap|, \verb|\rlap|, and
+ \verb|\phantom| commands.
+
+ \item [{\tt \blash usepackage\char`\{url\char`\}}]
+
+ Inserts line breaks into e-mail and website addresses. The
+ package \textbf{and} its additional line of code must be
+ uncommented.
+
+ \item [{\tt \blash usepackage\char`\{array\char`\}}]
+
+ Allows for raggedright columns in tables. The package
+ \textbf{and} its additional line of code must be uncommented.
+
+ \item [{\tt \blash usepackage\char`\{cases\char`\}}]
+
+ Makes it possible for a left curly brace to span several
+ lines of equations. The package \textbf{and} its additional
+ line of code must be uncommented.
+
+ \item [personal macros]
+
+ 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 document
+ classes, these should not be inserted into each article file
+ but rather stored in a separate file, loaded via the
+ \verb|\usepackage| command and inserted after all other
+ packages.
+\end{description}
+
+\newpage
+
+
+%% Section 6.3
+\subsection{Package to remove}
+
+If the user has specified
+%
+\begin{verbatim}
+ \usepackage[T1]{fontenc}
+\end{verbatim}
+%
+so as to enable French-language hyphenation to work when using {\small
+CM} or restricted Type~1 fonts, the package invocation should be
+deleted (the \NRC{} classes supply their own \verb|fontenc|
+invocation).
+
+
+%% Section 6.4
+\subsection{Additional macros}
+
+Following the loading of all packages and their options, files may
+contain additional macros from the author (see
+page~\pageref{authmacros} for instructions provided to authors). These
+should be clearly marked off with, for example, a row of
+\verb|%%|~signs both above and below. Keep in mind the potential for
+author definitions to interfere or over-ride journal macros and
+specifications; for example, authors may have commands to specify page
+dimensions, or fonts for sections, or numbering schemes. Where these
+do not collide with journal requirements, they can probably be safely
+retained. However, where there is interference, journal definitions
+take precedence. Ideally, authors will increasingly switch to using
+the \NRC's document classes and reduce the chances of such problems.
+
+
+%% Section 6.5
+\subsection{Other additions in the preamble area}
+
+Some if not all of the following macros are used by the \NRC's
+in-house production team, and not by the author. They are input in the
+file after all packages have been loaded, and before the
+\verb|\begin{document}| statement:
+
+\begin{verbatim}
+ \setcounter{page}{<number>}
+ \journal{<abbrev.>}
+ \journalcode{<acro>}
+ \volyear{<vol no.>}[<copyright year>]{<year>}
+ \filenumber{<file no.>}
+
+ \received{<complete date>}
+ \revreceived{<complete date>}
+ \accepted{<complete date>}
+ \revaccepted{<complete date>}
+ \IDdate or \IDdates{<Addit'nal text + date info>}
+ \webpub{<complete date>}
+ \commdate{<complete date>}
+
+ \assoced{<name of assoc. ed.>}
+ \corred{<name of correspond. ed.>}
+\end{verbatim}
+
+\begin{description} \itemsep=0pt
+ \item [{\tt \blash
+ setcounter\char`\{page\char`\}\char`\{...\char`\}}] \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 the file is run a second time.
+
+\newpage
+
+
+ \item [{\tt \blash journal\char`\{...\char`\}}] \mbox{}
+
+ Specific journal abbreviations must be entered via this macro
+ (e.g., \verb|Can. J. Civ. Eng.|).
+ The \verb|\journal| command records the web address that
+ will be used for this paper when it is published on the web;
+ note that the \verb|\journalcode| command may be used as an
+ alternative to \verb|\journal|.
+
+ See Appendix~A for complete list of journal abbreviations.
+
+
+ \item [{\tt \blash journalcode\char`\{...\char`\}}] \mbox{}
+
+ The argument is the ``journal acronym'' (see table in
+ Appendix~A for a list). This acronym identifies the journal,
+ and the \verb|\journalcode| command uses it to set the
+ journal abbreviation and the web site addresses; note that
+ the \verb|\journal| command may be used as an alternative to
+ \verb|\journalcode|.
+
+
+ \item [{\tt \blash
+ volyear\char`\{...\char`\}[...]\char`\{...\char`\}}] \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 production year. The third argument
+ specifies the publication year, which is used in the
+ titlepage footer and in the left running head.
+
+
+ \item [{\tt \blash filenumber\char`\{...\char`\}}] \mbox{}
+
+ Insert the \NRC's file number here.\label{filenumber} The
+ number will be appended to the canned text \verb|10-1139/|,
+ which appears bottom centre of the
+ opening page. If \verb|\filenumber| is missing, the following
+ will be printed: {\it Zxx-xxx\/}.
+
+ {\bf Note:} The {\small DOI} line prints in the same location
+ as text for the class options \verb|proof| and
+ \verb|pagnf|. Comment these class options out once it becomes
+ necessary to have the {\small DOI} line print at bottom
+ centre of the opening page. See section~\ref{proof-pagnf}.
+
+
+ \item [{\tt \blash filenumber*\char`\{...\char`\}}] \mbox{}
+
+ Add an asterisk to the \verb|\filenumber| macro when it is
+ necessary for the filenumber to be prefixed to the page
+ numbers, in addition to appearing in the DOI line.
+
+ All page numbers in the headers, and on the opening page at
+ the bottom left will have the filenumber prefixed to them.
+
+ {\bf Note:} The filenumber will {\bf not} be prefixed to any
+ page cross-references (via the \verb|\pageref| macro).
+
+
+ \item [{\tt \blash received\char`\{...\char`\}}] \mbox{}
+
+ Insert date as per journal style --- e.g., June 6, 2001 ---
+ but without a final period (it is automatically inserted).
+ The word `Received' (Fr.\ `Re\c cu le') will be automatically
+ generated; however, the date must be input in French (e.g., 6
+ juin 2001). This text appears in the author IDbox area.
+
+\newpage
+
+ \item [{\tt \blash revreceived\char`\{...\char`\}}] \mbox{}
+
+ Same instructions as for \texttt{\blash received}. The text
+ `Revision received' (Fr.\ `R\'evision re\c cue le') will be
+ automatically generated. This text appears in the author
+ IDbox area.
+
+
+ \item [{\tt \blash accepted\char`\{...\char`\}}] \mbox{}
+
+ Same instructions as for \texttt{\blash received}. The word
+ `Accepted' (Fr.\ `Accept\'e le') will be automatically
+ generated. This text appears in the author IDbox area.
+
+
+ \item [{\tt \blash revaccepted\char`\{...\char`\}}] \mbox{}
+
+ Same instructions as for \texttt{\blash received}. The text
+ `Revision accepted' (Fr.\ `R\'evision accept\'ee le') will be
+ automatically generated. This text appears in the author
+ IDbox area.
+
+
+ \item [{\tt \blash IDdates\char`\{...\char`\}}] \mbox{}
+
+ Unlike \verb|\received| and \verb|\accepted|, no canned text or
+ final punctuation is included, allowing the user to insert
+ customised text and/or date information, which appears in the
+ author IDbox area. An alias, \verb|\IDdate|, is also
+ available.
+
+
+ \item [{\tt \blash webpub\char`\{...\char`\}}] \mbox{}
+
+ Insert date of publication at the \NRC{} website as per
+ journal style --- e.g., June 6, 2001 --- but without a final
+ period (it is automatically inserted). The text will appear
+ in the author IDbox area.
+
+ For English-language articles, the text `Published on the
+ {\small NRC} Research Press Web site at \verb|webaddress| on
+ \verb|date|' will be automatically generated. The website
+ address is generated by using either the \verb|\journal| or
+ \verb|\journalcode| macros.
+
+ For French-language articles, the text `Publi\'{e} sur le
+ site Web des Presses scientifiques du {\small CNRC}, \`a
+ \verb|webaddress|, le \verb|date|' will be automatically
+ generated. Note that the date must be input in French (e.g.,
+ 6 juin 2001).
+
+
+ \item [{\tt \blash commdate\char`\{...\char`\}}] \mbox{}
+
+ Insert date as per journal style --- e.g., June 6, 2001 ---
+ but without a final period (it is automatically inserted).
+ The text `Written discussion of this article is welcomed and
+ will be received by the Editor until' (Fr.\ `Les commentaires
+ sur le contenu de cet article doivent \^{e}tre envoy\'{e}s au
+ directeur scientifique de la revue avant le') will be
+ automatically generated; however, the date must be input in
+ French (e.g., 6 juin 2001). This text appears in the author
+ IDbox area.
+
+
+ \item [{\tt \blash assoced\char`\{...\char`\}}] \mbox{}
+
+ Insert name of associate editor, without a final period. The
+ text `Paper handled by Associate Editor' (Fr.\ `Production de
+ l'article coordonn\'{e}e par le directeur scientifique
+ associ\'{e}') will be automatically generated. This text
+ appears in the author IDbox area.
+
+\newpage
+
+
+ \item [{\tt \blash corred\char`\{...\char`\}}] \mbox{}
+
+ Insert name of associate editor, without a final period. The
+ text `Corresponding Editor:' (Fr.\ `Directeur scientifique
+ correspondant\,:') will be automatically generated. This text
+ appears in the author IDbox~area.
+\end{description}
+
+
+%% Section 6.6
+\subsection{Special titleblocks\label{specialtitles}}
+
+Some journal material requires a special heading: a solid black stripe
+with reversed-out white lettering. The white-on-black effect requires
+the presence of a special package in the preamble area, immediately
+below the graphics package, in addition to the special title coding:
+
+\begin{verbatim}
+ \usepackage{color}
+\end{verbatim}
+
+\noindent Since both the \texttt{graphicx} package and \texttt{color}
+share the same option, it is possible to merge them into one line:
+
+\begin{verbatim}
+ \usepackage{graphicx,color}
+\end{verbatim}
+
+\noindent Having added the \texttt{color} package, the actual special
+title command will now work. There are two versions of the command:
+
+\begin{description} \itemsep=0pt
+ \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 article titleblock cannot be used with this
+ variant; for example, an editorial or other non-article
+ material.
+%
+\begin{verbatim}
+\begin{document}
+\specialtitle*{EDITORIAL/\'EDITORIAL}
+\shortauthor{Editorial/\'Editorial}
+\maketitle
+\end{verbatim}
+
+ For non-articles, the headers and footers are changed by
+ using the \verb|\pagestyle{nrcplain}| command. The page
+ numbers will appear at bottom centre, the \NRC{} Canada
+ copyright footer is suppressed, and the running heads are
+ suppressed entirely. For further adjustments to pagination,
+ see `Miscellaneous adjustments'.
+\end{description}
+
+
+%% Section 6.7
+\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} \itemsep=0pt
+ \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}
+
+\noindent Note that author files will only have one: an abstract or a
+resum\'e. It is useful to insert a suitable \verb|\vspace| to
+represent the approximate space the translation would require, so that
+page breaks will not be unduly affected by the additional text.
+
+
+%% Section 6.8
+\subsection{Miscellaneous adjustments}
+
+\begin{enumerate} \itemsep=0pt
+ \item Journals requiring more space between lines will need the
+ following command inserted into the preamble area:
+%
+\begin{verbatim}
+ \easebaselines
+\end{verbatim}
+
+ This command will also adjust the inter-row spacing within
+ tables (value of \verb|\arraystretch| increases to 1.05).
+
+
+ \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 (notice
+ that, in this example, pagination will begin with roman iii):
+%
+\begin{verbatim}
+ \pagestyle{nrcplain}
+ \pagenumbering{roman}
+ \setcounter{page}{3}
+\end{verbatim}
+
+ \item To add parentheses (or any other design element) to (roman)
+ page numbers, insert the following just before the
+ \verb|\setcounter{page}{...}| command:
+%
+\begin{verbatim}
+ \renewcommand\thepage{(\roman{page})}
+\end{verbatim}
+
+ \item For full-width text spanning two columns, the default left
+ and right margins can be altered by using the following
+ optional argument to the \verb|{WideText}| environment
+ (recall that the default values are 0em on the left, 3em on
+ the right):
+
+\begin{verbatim}
+\begin{WideText}[<l.margin>][<r.margin>]
+ <text here>
+\end{WideText}
+\end{verbatim}
+\end{enumerate}
+
+
+%% Section 6.9
+\subsection{Two-column bilingual texts}
+
+Special coding at both the top of the file and around the bilingual
+paragraphs is required.
+
+
+%% Section 6.9.1
+\subsubsection{In the preamble\label{bilingpream}}
+
+First, load the appropriate package and options. These are added after
+the \verb|\documentclass| line in the preamble.
+
+\newpage
+
+\begin{enumerate} \itemsep=0pt
+ \item if main (left column) language is English:
+
+ \verb|\usepackage[french,english]{babel}|
+
+ As English is the default, there is no need to specify it as
+ an option to the document class.
+
+ \item if main (left column) language is French, there is an
+ additional option to add to the document class line:
+
+ \verb|\documentclass[french]{nrc1}|
+
+ \verb|\usepackage[english,french]{babel}|
+
+ See sections~\ref{frenchclassoption} and \ref{babelinfo},
+ which also discuss the \textsf{babel} package.
+\end{enumerate}
+
+
+%% Section 6.9.2
+\subsubsection{In the bilingual text}
+
+The next step is to code the English and French texts so that the tops
+of matching paragraphs align horizontally. One set of codes surrounds
+the entire bilingual set of paragraphs; another set of codes is put
+around each matched set of English-French paragraphs.
+
+\begin{verbatim}
+1. \begin{par-text}[<language>]
+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}
+
+\begin{description} \itemsep=0pt
+ \item [lines 1, 13:] The entire 2-column section of matching
+ paragraphs is set inside a \verb|par-text| environment. This
+ separates the parallel text portion of a file from other
+ elements that may not require such formatting: headings or
+ other text, graphics inclusions, etc. The \verb|par-text|
+ command has one required option (language) and two width
+ options (to change from default values).
+
+ \item [line 1: \tt{[<language>]}] When the left-column language
+ is\break English, \verb|[french]| is the right-column
+ `option'.
+
+ When left-column language is French, the right-column
+ language option is \verb|[english]|. {\bf Also required} is
+ the preamble code specified in section~\ref{bilingpream},
+ item~2.
+
+ \item [line 1:] The default column widths, which do {\bf not} need
+ to be specified, are:
+
+ \hspace{1pc}\begin{tabular}{lccc}
+ & left col & inter-col & right col \\ [2pt]
+ \tt nrc1 & 15.5pc & 1.5pc & 17pc \\
+ \tt nrc2 & 20.75pc & 1.5pc & 20.75pc \\
+ \end{tabular}
+
+ To change left-column width and inter-column space (the right
+ column width is calculated, based on these other two
+ dimensions):
+
+\begin{verbatim}
+\begin{par-text}[<lang.>][<dimen1>][<dimen2>]
+\end{verbatim}
+
+ where \verb|<dimen1>| is the new left column width, and
+ \verb|<dimen2>| is the new inter-column space. If only the
+ inter-column space, \verb|<dimen2>|, is to change,
+ \verb|<dimen1>| must still be inserted, in order for the
+ program to find the 2nd set of square brackets.
+
+ \item [lines 2 and 6:] matching English/French paragraphs are set
+ inside a \verb|par-para| environment
+
+ \item [lines 3 and 5:] the matched sets of paragraphs (which can of
+ course be longer than one line!)
+
+ \item [lines 4 and 10:] to signal the end of the left-column
+ paragraph and the start of its matching right column
+ paragraph, use \verb|\othercol|
+
+ \item [line 7:] to make it easier to read the source file, separate
+ each set of \verb|{par-para}| with a blank line or a {\tt \%}
+ sign
+\end{description}
+
+\noindent {\bf Note:} The default vertical space between lines is set
+at 1pc ($\approx$ 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}|.
+
+
+%% Section 7:
+\section{Final notes}
+
+\begin{enumerate} \itemsep=0pt
+ \item There is no dotless-j available in Adobe PostScript fonts.
+ The only dotless-j appears in math mode --- $\jmath$ ---
+ which is accessed by \verb|$\jmath$|.
+
+ \item Only English and French hyphenation are currently set up;
+ English is the default, French is invoked by \textsf{babel},
+ and the class selects French or English hyphenation as
+ necessary, as it goes along (provided the appropriate
+ hyphenation patterns have been installed).
+\end{enumerate}
+
+\clearpage
+
+
+\section*{Appendix A}
+
+\subsection*{Journal reference grid}
+
+{\footnotesize
+\begin{tabular}{@{}lllll@{}}
+\hline \hline
+Journal name
+ & Journal abbreviation
+ & Journal
+ & English website
+ & French website \T \\
+ & & acronym & & \B \\
+\hline
+Biochemistry and Cell Biology\T
+ & Biochem. Cell Biol.
+ & bcb
+ & http://bcb.nrc.ca
+ & http://bbc.cnrc.ca \\ [2pt]
+%
+Canadian Geotechnical Journal
+ & Can. Geotech. J.
+ & cgj
+ & http://cgj.nrc.ca
+ & http://rcg.cnrc.ca \\ [2pt]
+%
+Canadian Journal of Botany
+ & Can. J. Bot.
+ & cjb
+ & http://canjbot.nrc.ca
+ & http://revcanbot.cnrc.ca \\ [2pt]
+%
+Canadian Journal of Chemistry
+ & Can. J. Chem.
+ & cjc
+ & http://canjchem.nrc.ca
+ & http://revcanchim.cnrc.ca \\ [2pt]
+%
+Canadian Journal of Civil Engineering
+ & Can. J. Civ. Eng.
+ & cjce
+ & http://cjce.nrc.ca
+ & http://rcgc.cnrc.ca \\ [2pt]
+%
+Canadian Journal of Earth Sciences
+ & Can. J. Earth Sci.
+ & cjes
+ & http://cjes.nrc.ca
+ & http://rcst.cnrc.ca \\ [2pt]
+%
+Canadian Journal of Fisheries
+ & Can. J. Fish. Aquat. Sci.
+ & cjfas
+ & http://cjfas.nrc.ca
+ & http://jcsha.cnrc.ca \\
+\quad and Aquatic Sciences \\ [2pt]
+%
+Canadian Journal of Forest Research
+ & Can. J. For. Res.
+ & cjfr
+ & http://cjfr.nrc.ca
+ & http://rcrf.cnrc.ca \\ [2pt]
+%
+Canadian Journal of Microbiology
+ & Can. J. Microbiol.
+ & cjm
+ & http://cjm.nrc.ca
+ & http://rcm.cnrc.ca \\ [2pt]
+%
+Canadian Journal of Physics
+ & Can. J. Phys.
+ & cjp
+ & http://cjp.nrc.ca
+ & http://rcp.cnrc.ca \\ [2pt]
+%
+Canadian Journal of Physiology
+ & Can. J. Physiol.
+ & cjpp
+ & http://cjpp.nrc.ca
+ & http://rcpp.cnrc.ca \\
+\quad and Pharmacology \\ [2pt]
+%
+Canadian Journal of Zoology
+ & Can. J. Zool.
+ & cjz
+ & http://cjz.nrc.ca
+ & http://rcz.cnrc.ca \\ [2pt]
+%
+Environmental Reviews
+ & Environ. Rev.
+ & er
+ & http://er.nrc.ca
+ & http://de.cnrc.ca \\ [2pt]
+%
+Genome
+ & Genome
+ & gen
+ & http://genome.nrc.ca
+ & http://genome.cnrc.ca \\ [2pt]
+%
+Journal of Environmental
+ & J. Environ. Eng. Sci.
+ & jees
+ & http://jees.nrc.ca
+ & http://rgse.cnrc.ca \\
+\quad Engineering and Science \B \\
+\hline \hline
+\end{tabular}
+}
+
+\clearpage
+
+\onecolumn
+
+\section*{Appendix B}
+
+\subsection*{Canned Preamble: \texttt{nrc-opening.tex}}
+
+\begin{verbatim}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%
+%% Typeset by , Research Press, NRC
+%% Date:
+%% NRC, <name of journal>
+%%
+%%%%%%%%%%%%%%
+%%
+%% 1. See original preamble material (at bottom of file) for
+%% details on source of current .tex file: conversion
+%% from word-processing program or author-generated TeX
+%% code.
+%%
+%% 2. This template includes most options and packages used by
+%% all the NRC journals. UNcomment those packages and options
+%% which are REQUIRED.
+%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+%% 1. Class file (nrc1 or nrc2) + options (see userguide, pp.1-2; p.9):
+\documentclass[%% french, %% use with \usepackage[french]{babel}
+ %% leqno, %% only for nrc1 (default is right eqno)
+ %% reqno, %% only for nrc2 (default is left eqno)
+ %% nonumbib, %% biblio entries without nos.
+%
+ %% breakaddress, %% linebreak btwn author(s) + address(es)
+ %% twocolid, %% IDbox spans 2 cols
+ %% twocolid*, %% 2-col IDbox
+ %% preprint, %% removes identifying nos. from headers/footers
+ %% proof, %% `Proof/Epreuve' in footer
+ %% pagnf, %% `Pagination not final/Pagination non finale'
+ %% trimmarks, %% add trimmarks
+ %% finalverso, %% final blank verso NOT included in pagerange
+]{nrc2} %% choose one: nrc1 or nrc2
+
+%% NOTE: authors may use the following options, which should be
+%% DELETED once the file comes in-house:
+%%
+%% usecmfonts type1rest genTeX
+
+
+%% 2. Frequently used packages -- see pp.2-3 of userguide:
+%% a. graphics-related:
+%% \usepackage{graphicx} %% color not usually needed
+%% \usepackage[figuresright]{rotating} %% for landscape tables
+
+%% b. math-related:
+%% \usepackage{amsmath} %% math macros in wide use
+%% \usepackage{amssymb} %% additional math symbols
+%% \usepackage{dcolumn} %% decimal alignment for tables
+%% \usepackage{bm} %% `bold math' via \bm command
+
+%% c. for website addresses:
+%% \usepackage{url} %% inserts linebreaks automatically
+%% \NRCurl{url}
+
+%% d. biblio-related:
+%% \usepackage{cite} %% enhances options for \cite commands
+
+%% e. for English-language papers:
+%% \usepackage[french,english]{babel}
+
+%% f. for French-language papers:
+%% \usepackage[english,french]{babel} %% remember to add french as a
+ %% CLASS option, above
+%% g. for ragged-right tables:
+%% \usepackage{array}
+%% \newcommand{\PreserveBackslash}[1]{\let\temp=\\#1\let\\=\temp}
+%% \let\PBS=\PreserveBackslash
+
+%% h. for left curly brace to span several lines of equations:
+%% \usepackage{cases}
+%% \expandafter\let\csname numc@left\expandafter\endcsname\csname
+%% z@\endcsname
+
+
+%% 3. Resetting float parameters:
+%% a. in nrc1:
+%% \renewcommand{\topfraction}{.95}
+%% \renewcommand{\textfraction}{.05}
+%% \renewcommand{\floatpagefraction}{.95}
+
+%% b. in nrc2:
+%% \renewcommand{\topfraction}{.95}
+%% \renewcommand{\floatpagefraction}{.95}
+%% \renewcommand{\dbltopfraction}{.95}
+%% \renewcommand{\textfraction}{.05}
+%% \renewcommand{\dblfloatpagefraction}{.95}
+
+
+%% 4. Resetting journal-specific parameters:
+%% a. eqn nos. with section nos.:
+%% \numberby {equation}{section}
+%% \setcounter{equation}{0}
+
+%% b. in-line citations to use ( ) instead of default [ ]:
+%% \renewcommand{\citeleft}{(}
+%% \renewcommand{\citeright}{)}
+
+%% c. for JEES (to expand inter-line spacing; see p.12 of guide):
+%% \easebaselines
+
+
+%% 5. Miscellaneous macros to always have available:
+%% a. shorthands:
+\let\p=\phantom
+\let\mc=\multicolumn
+
+%% b. struts for vertical spacing above/below rules in tables:
+%%%%%%%%%%%%%%%%%% beginning of Claudio Beccari's code:
+%% Spacing commands for {tabular} (from TTN 2,3:10 -- Claudio
+%% Beccari):
+%% Usage: a. use \T to put space below a line
+%% (e.g., at top of a `cell' of text)
+%% b. use \B to put space above a line
+%% (e.g., at bottom of a `cell' of text)
+\newcommand\T{\rule{0pt}{2.6ex}} % = `top' strut
+\newcommand\B{\rule[-1.2ex]{0pt}{0pt}} % = `bottom' strut
+%%%%%%%%%%%%%%%%%% end of Claudio's code
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% end of class and package
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% options, additional macros
+
+
+%% Journal-specific information for opening page -- pp.9-11 of guide:
+%% a. numbers:
+\setcounter{page}{1} %% replace 1 with starting page no.
+\volyear{XX}{2001} %% volume, year of journal
+\journal{} %% jrnl. abbrev. (see App.A of guide)
+\journalcode{} %% jrnl. acro (see App.A of guide)
+\filenumber{} %% NRC file number
+%% \filenumber*{} %% prefixes \filenumber to all page nos.
+ %% NOTE: COMMENT OUT class options
+ %% pagnf
+ %% proof
+ %% once no longer needed
+
+
+%% b. dates:
+\received{} %% insert date, no period
+\revreceived{} %% <same>
+\accepted{} %% <same>
+\revaccepted{} %% <same>
+%% \IDdates{} %% <same>. Use for `Revised ...' etc.
+%% \webpub{} %% insert date
+%% \commdate{} %% <same>
+
+
+%% c. miscellaneous:
+%% \assoced{} %% insert name of Associate ed.
+%% \corred{} %% insert name of Corresponding ed.
+%% \dedication{} %% insert text as neede
+%% \abbreviations{} %% insert as needed
+
+
+\begin{document}
+
+%% Reversed titlebar -- see p.11 of userguide:
+%% \specialtitle{} %% for black stripe + text + regular title
+%% \specialtitle*{} %% black stripe + text only
+
+
+
+
+%% Title, Author(s), Address(es) -- see p.4 of userguide for
+%% various options to save time and keyboarding, esp. where
+%% authors share same address(s).
+
+\title{}
+
+%% Author 1:
+\author[J.L. Humar]{John Larry Humar} %% opt. arg. ONLY if IDbox
+ %% name is diff. from
+ %% titleblock name
+\address{} %% address of 1st author
+
+
+%% Author 2:
+\author{M.A. Rahgozar}
+\address{}
+
+%% Author 3:
+\author{Fred Murray}
+\address{}
+
+
+\shortauthor{Humar, Rahgozar, and Murray} %% for headers
+
+%%%%%%%%
+%% This line goes here in nrc1.
+%% \maketitle
+%%%%%%%%
+
+
+%% Abstract/Resume area -- see pp.5,12 of userguide:
+\begin{abstract}
+ Abstract text
+%% \keywords{}
+%% \translation
+\end{abstract}
+
+\begin{resume}
+ Texte du resume
+%% \motscles{}
+%% \Traduit %% or \traduit
+\end{resume}
+
+%%%%%%%%
+%% This line goes here in nrc2.
+%% \maketitle
+%%%%%%%%
+
+%%%%%%%%%%%%%%%%%%%%%% END OF TEMPLATE %%%%%%%%%%%%%%%%%%%%%%
+
+%% Ch. -- 11 NOV 02
+
+\end{verbatim}
+
+\end{document}
+
+
+%% END OF FILE