summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/combine
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/combine
Initial commit
Diffstat (limited to 'macros/latex/contrib/combine')
-rw-r--r--macros/latex/contrib/combine/README138
-rw-r--r--macros/latex/contrib/combine/combine.dtx4177
-rw-r--r--macros/latex/contrib/combine/combine.ins84
-rw-r--r--macros/latex/contrib/combine/combine.pdfbin0 -> 465111 bytes
4 files changed, 4399 insertions, 0 deletions
diff --git a/macros/latex/contrib/combine/README b/macros/latex/contrib/combine/README
new file mode 100644
index 0000000000..96dda72d6a
--- /dev/null
+++ b/macros/latex/contrib/combine/README
@@ -0,0 +1,138 @@
+_________________
+The COMBINE class
+
+ The combine class lets you bundle individual documents into
+a single document, such as when preparing a conference proceedings.
+
+ The auxiliary combinet package puts the titles and authors from
+\maketitle commands into the main document's table of contents and the
+combnat package enables the combine class and the natbib package
+to be used harmoniously together. The auxiliary combcite package
+provides a version of the cite package for use with the combine class.
+
+______________
+Change History
+
+Version 0.7a (2010/07/10)
+- Previous version had a major typo, preventing the class from loading!
+
+Version 0.7 (2010/03/22)
+
+- Consolidate fileversion and filedate for all derived files
+ I.e., combine.cls, combinet.sty, combcite.sty, combnat.sty are all now v0.7
+ This is simply to make book-keeping easier
+
+- Bug fix for combnat thanks to Nicola Talbot
+
+Changes in version 0.64b of combine.dtx (2009/09/02)
+- New maintainer (Will Robertson)
+
+Minor change in the manual's abstract (2004/05/07)
+
+Changes in version 0.2a of combinet.sty (2004/03/06)
+- Minor internal change to ease hyperref pain
+
+Changes in version 1.0 of combcite.sty (2003/11/09)
+- First public release
+
+Changes in version 0.52 of combine.cls (2003/11/09)
+- Added `memoir' to the class options
+
+Changes in version 0.51 of combine.cls (2003/07/17)
+- Added macro to fix stack overflow for the combination:
+ pdflatex + combine + graphicx + caption2
+
+Changes in version 0.21 of combnat.sty (2003/05/22)
+- Removed extraneous space from year citation.
+
+Changes in version 0.5 of combine.cls
+ and version 0.2 of combnat.sty (2002/08/24)
+- Added options for individual bibliographies, a global bibliography,
+ or both local bibliographies and a global combined bibliography.
+
+Changes in version 0.45 of combine.cls
+ and version 0.2 of combinet.sty (2001/09/05)
+- Fixed ToC alignment problem
+
+Changes in version 0.44 of combine.cls (2001/08/25)
+- Imported documents can now use a class that \LoadClass another class.
+
+Changes in version 0.43 of combine.cls (2001/07/09)
+- Removed the feature that the \appendix command changed the
+ numbering scheme in all subsequent imported documents
+- ToC additions are now in predefined order instead of
+ input order
+
+Changes in version 0.1 of combnat.sty (2001/07/03)
+- First public release
+
+Changes in version 0.42 of combine.cls (2001/04/04)
+- Fixed incompatibility with the fancyhdr package
+- Reduced, and hopefully eliminated, a pagebreak problem in the ToC
+
+Changes in version 0.41 of combine.cls (2000/06/18)
+- Cooperates with the abstract and titling packages
+
+Changes in version 0.4 of combine.cls (2000/05/27)
+- Added book option
+- Extra options for ToC contents and more flexible ToC formatting
+- Counters are now reset for each imported document
+- Reduced the save stack size required for latexing combine.dtx
+
+Changes in version 0.3 of combine.cls: (2000/05/20)
+- \newtheorem is now catered for
+- Control over the \maketitle formatting
+- Improved documentation
+
+Changes in version 0.2 of combine.cls: (2000/05/07)
+- Renamed as combine class instead of collection class
+- Improved documentation
+
+Changes in version 0.1 of combinet.sty: (2000/05/07)
+- First public release
+
+-----------------------------------------------------------------
+ Author: Peter Wilson, Herries Press
+ Maintainer: Will Robertson (will dot robertson at latex-project dot org)
+ Copyright 2001, 2002, 2003, 2004 Peter R. Wilson
+
+ This work may be distributed and/or modified under the
+ conditions of the LaTeX Project Public License, either
+ version 1.3c of this license or (at your option) any
+ later version: <http://www.latex-project.org/lppl.txt>
+
+ This work has the LPPL maintenance status "maintained".
+ The Current Maintainer of this work is Will Robertson.
+
+ This work consists of the following files:
+README (this file)
+combine.dtx
+combine.ins
+combine.pdf
+ and the derived files:
+combine.cls
+combinet.sty
+combnat.sty
+
+-----------------------------------------------------------------
+
+ The distribution consists of the following files:
+README (this file)
+combine.dtx
+combine.ins
+combine.pdf (user manual)
+
+ To install the distribution:
+- run: latex combine.ins (which will generate combine.cls,
+ combinet.sty and combnat.sty)
+- run: latex combine.dtx
+- For an index, run: makeindex -s gind.ist combine
+- run: latex combine.dtx
+- Print combine.dvi for a hardcopy of the user manual
+- Move combine.cls, combinet.sty and combnat.sty to locations
+ where LaTeX will find them (The FAQ on CTAN in /help/uktug-FAQ
+ gives more information about this magic place).
+
+
+2004/05/07
+Peter Wilson
diff --git a/macros/latex/contrib/combine/combine.dtx b/macros/latex/contrib/combine/combine.dtx
new file mode 100644
index 0000000000..0f637b59c5
--- /dev/null
+++ b/macros/latex/contrib/combine/combine.dtx
@@ -0,0 +1,4177 @@
+% \iffalse meta-comment
+%
+% combine.dtx
+% Author: Peter Wilson, Herries Press
+% Maintainer: Will Robertson (will dot robertson at latex-project dot org)
+% Copyright 2000, 2001, 2002, 2003, 2004 Peter R. Wilson
+% Copyright 2010 Will Robertson
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either
+% version 1.3c of this license or (at your option) any
+% later version: <http://www.latex-project.org/lppl.txt>
+%
+% This work has the LPPL maintenance status "maintained".
+% The Current Maintainer of this work is Will Robertson.
+%
+% This work consists of the files listed in the README file.
+%
+%<*driver>
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesFile{combine.dtx}
+%</driver>
+%<usc>\ProvidesClass{combine}
+%<pck>\ProvidesPackage{combinet}
+%<natpack>\ProvidesPackage{combnat}
+%<citepack>\ProvidesPackage{combcite}
+%<*usc|pck|natpack|citepack>
+ [2010/07/10 v0.7a
+%</usc|pck|natpack|citepack>
+%<usc> collection of documents
+%<pck> document titles in ToC
+%<natpack> combine version of natbib package
+%<citepack> combine version of cite package
+%<*usc|pck|natpack|citepack>
+ ]
+%</usc|pck|natpack|citepack>
+%
+%<*driver>
+\documentclass[twoside]{ltxdoc}
+\makeatletter \@mparswitchfalse \makeatother
+\EnableCrossrefs
+\CodelineIndex
+%%\OnlyDescription
+\renewcommand{\MakeUppercase}[1]{#1}
+\pagestyle{headings}
+\setcounter{StandardModuleDepth}{1}
+\begin{document}
+ \DocInput{combine.dtx}
+\end{document}
+%</driver>
+%
+% \fi
+%
+% \CheckSum{3858}
+%
+% \DoNotIndex{\',\.,\@M,\@@input,\@addtoreset,\@arabic,\@badmath}
+% \DoNotIndex{\@centercr,\@cite}
+% \DoNotIndex{\@dotsep,\@empty,\@float,\@gobble,\@gobbletwo,\@ignoretrue}
+% \DoNotIndex{\@input,\@ixpt,\@m}
+% \DoNotIndex{\@minus,\@mkboth,\@ne,\@nil,\@nomath,\@plus,\@set@topoint}
+% \DoNotIndex{\@tempboxa,\@tempcnta,\@tempdima,\@tempdimb}
+% \DoNotIndex{\@tempswafalse,\@tempswatrue,\@viipt,\@viiipt,\@vipt}
+% \DoNotIndex{\@vpt,\@warning,\@xiipt,\@xipt,\@xivpt,\@xpt,\@xviipt}
+% \DoNotIndex{\@xxpt,\@xxvpt,\\,\ ,\addpenalty,\addtolength,\addvspace}
+% \DoNotIndex{\advance,\Alph,\alph}
+% \DoNotIndex{\arabic,\ast,\begin,\begingroup,\bfseries,\bgroup,\box}
+% \DoNotIndex{\bullet}
+% \DoNotIndex{\cdot,\cite,\CodelineIndex,\cr,\day,\DeclareOption}
+% \DoNotIndex{\def,\DisableCrossrefs,\divide,\DocInput,\documentclass}
+% \DoNotIndex{\DoNotIndex,\egroup,\ifdim,\else,\fi,\em,\endtrivlist}
+% \DoNotIndex{\EnableCrossrefs,\end,\end@dblfloat,\end@float,\endgroup}
+% \DoNotIndex{\endlist,\everycr,\everypar,\ExecuteOptions,\expandafter}
+% \DoNotIndex{\fbox}
+% \DoNotIndex{\filedate,\filename,\fileversion,\fontsize,\framebox,\gdef}
+% \DoNotIndex{\global,\halign,\hangindent,\hbox,\hfil,\hfill,\hrule}
+% \DoNotIndex{\hsize,\hskip,\hspace,\hss,\if@tempswa,\ifcase,\or,\fi,\fi}
+% \DoNotIndex{\ifhmode,\ifvmode,\ifnum,\iftrue,\ifx,\fi,\fi,\fi,\fi,\fi}
+% \DoNotIndex{\input}
+% \DoNotIndex{\jobname,\kern,\leavevmode,\let,\leftmark}
+% \DoNotIndex{\list,\llap,\long,\m@ne,\m@th,\mark,\markboth,\markright}
+% \DoNotIndex{\month,\newcommand,\newcounter,\newenvironment}
+% \DoNotIndex{\NeedsTeXFormat,\newdimen}
+% \DoNotIndex{\newlength,\newpage,\nobreak,\noindent,\null,\number}
+% \DoNotIndex{\numberline,\OldMakeindex,\OnlyDescription,\p@}
+% \DoNotIndex{\pagestyle,\par,\paragraph,\paragraphmark,\parfillskip}
+% \DoNotIndex{\penalty,\PrintChanges,\PrintIndex,\ProcessOptions}
+% \DoNotIndex{\protect,\ProvidesClass,\raggedbottom,\raggedright}
+% \DoNotIndex{\refstepcounter,\relax,\renewcommand,\reset@font}
+% \DoNotIndex{\rightmargin,\rightmark,\rightskip,\rlap,\rmfamily,\roman}
+% \DoNotIndex{\roman,\secdef,\selectfont,\setbox,\setcounter,\setlength}
+% \DoNotIndex{\settowidth,\sfcode,\skip,\sloppy,\slshape,\space}
+% \DoNotIndex{\symbol,\the,\trivlist,\typeout,\tw@,\undefined,\uppercase}
+% \DoNotIndex{\usecounter,\usefont,\usepackage,\vfil,\vfill,\viiipt}
+% \DoNotIndex{\viipt,\vipt,\vskip,\vspace}
+% \DoNotIndex{\wd,\xiipt,\year,\z@}
+%
+% \changes{v0.1}{2000/04/29}{First public release as `collection' class}
+% \changes{v0.2}{2000/05/07}{First public release with class changed to `combine'}
+% \changes{v0.3}{2000/05/20}{Fix newtheorem and letter class}
+% \changes{v0.3}{2000/05/20}{Add title formatting}
+% \changes{v0.4}{2000/05/27}{Reset counters, ToC formatting}
+% \changes{v0.41}{2000/06/18}{Added and used \cs{appendiargdef}}
+% \changes{v0.42}{2001/04/04}{Fixed(?) problem with fancyhdr package}
+% \changes{v0.5}{2001/07/03}{Added the combnat package}
+% \changes{v0.51}{2001/07/09}{Fixed problem with \cs{appendix} in imports}
+% \changes{v0.51}{2001/07/09}{Fixed problem with ordering of
+% \cs{coltocauthor} and \cs{coltoctitle}}
+% \changes{v0.52}{2001/08/25}{Fixed problem with `wrapped class' imports}
+% \changes{v0.53}{2001/09/05}{Fixed problem with spaces in ToC entries}
+% \changes{v0.54}{2001/12/19}{Added text about exam class}
+% \changes{v0.6}{2002/08/24}{Added option for single bibliography}
+% \changes{v0.61}{2003/05/22}{Minimal tweak to combnat}
+% \changes{v0.62}{2003/07/19}{Minimal addition to combine}
+% \changes{v0.63}{2003/11/09}{Memoir option added to combine}
+% \changes{v0.63}{2003/11/09}{Added the combcite package}
+% \changes{v0.64}{2004/03/06}{Minor change to combinet package}
+% \changes{v0.64a}{2004/05/07}{Minor change to the abstract}
+% \changes{v0.64b}{2009/09/02}{New maintainer (Will Robertson)}
+% \changes{v0.7}{2010/03/22}{Bug fix and new (simpler) file versioning scheme}
+%
+% \GetFileInfo{combine.dtx}
+%
+% \newcommand*{\Lpack}[1]{\textsf {#1}} ^^A typeset a package
+% \newcommand*{\Lopt}[1]{\textsf {#1}} ^^A typeset an option
+% \newcommand*{\file}[1]{\texttt {#1}} ^^A typeset a file
+% \newcommand*{\Lcount}[1]{\textsl {\small#1}} ^^A typeset a counter
+% \newcommand*{\pstyle}[1]{\textsl {#1}} ^^A typeset a pagestyle
+% \newcommand*{\Lenv}[1]{\texttt {#1}} ^^A typeset an environment
+%
+% \title{The \Lpack{combine} class and the packages\\ \Lpack{combinet},
+% \Lpack{combnat} and \Lpack{combcite}\thanks{This file (\texttt{combine.dtx})
+% has version number \fileversion, last revised \filedate.}}
+%
+% \author{%
+% Peter Wilson, Herries Press^^A
+% \thanks{Dick Nickalls (\texttt{dicknickalls@compuserve.com})
+% provided several requirements and suggestions.
+% He also very helpfully tested earlier experimental versions.}\\
+% \\~
+% Maintainer: Will Robertson\\
+% \texttt{will dot robertson at latex-project dot org}%
+% }
+% \date{\filedate}
+% \maketitle
+% \begin{abstract}
+% The \Lpack{combine} class can be used to assemble a group
+% of individual \LaTeX{} documents into a single document,
+% such as required for a conference proceedings. Typically the documents
+% are all of the same class, but with some limitations on ordering
+% may be of different classes (e.g., several \Lpack{article}s with
+% one \Lpack{letter}).
+% The class requires the \Lpack{keyval} package.
+%
+% The accompanying \Lpack{combinet} and \Lpack{combnat} packages
+% respectively let
+% the titles of imported documents be added to the main ToC, and
+% enable the \Lpack{combine} class and the \Lpack{natbib} package
+% to cooperate. The \Lpack{combcite} package enables the \Lpack{cite}
+% package to cooperate.
+% \end{abstract}
+% \tableofcontents
+%
+%
+%
+% \section{Introduction}
+%
+% Questions about making a collection of different articles into a single
+% document
+% seem to pop up fairly regularly on the
+% \texttt{comp.text.tex} newsgroup.
+% The \Lpack{combine} class provides a solution for this problem.
+%
+% This manual is typeset according to the conventions of the
+% \LaTeX{} \textsc{docstrip} utility which enables the automatic
+% extraction of the \LaTeX{} macro source files~\cite{GOOSSENS94}.
+%
+% Section~\ref{sec:usc} describes the usage of the \Lpack{combine} class and
+% Sections~\ref{pack} and~\ref{natpack} describe the \Lpack{combinet}
+% and \Lpack{combnat} packages. Section~\ref{citepack} describes
+% the \Lpack{combcite} package.
+% Commented source code for the class is in Section~\ref{sec:code}.
+% The class requires the \Lpack{keyval} package to be available.
+% Commented source code for the \Lpack{combinet} package is in
+% Section~\ref{packcode}, for \Lpack{combnat} is in
+% Section~\ref{natpackcode} and for \Lpack{combcite} is in
+% Section~\ref{citepackcode}.
+%
+% Note that the version number and date given for this file does not
+% necessarily match version numbers or dates for the class and packages.
+%
+% \section{The \Lpack{combine} class} \label{sec:usc}
+%
+% The \Lpack{combine} class enables a group of individual
+% \LaTeX{} documents to be imported and assembled into a single document. All
+% the individual documents should be of the same class (e.g., all
+% \Lpack{article} or all \Lpack{report}).
+%
+% Sectioning, cross-referencing, bibliographies, etc., are local within
+% each imported document. Various means are provided for controlling local
+% Table of Contents, the format of |\maketitle|, and so on, without having
+% to make any changes to the original of an imported document.
+%
+% Here is a simple example file which might be the skeleton for a
+% conference proceedings.
+% \begin{verbatim}
+% \documentclass[11pt]{combine}
+%
+% \title{Proceedings of the ...}
+% \author{A. N. Editor\thanks{Support ...}}
+% \date{29 February, 2000}
+%
+% \begin{document}
+% \pagestyle{combine} % use the combine page style
+% \maketitle % main title
+% \tableofcontents % main ToC
+% \clearpage
+%
+% \section{Editor's introduction} \label{intro} % into main ToC (section 1)
+%
+% In the article by A.~N.~Author on page~\pageref{art1} ...
+%
+% \begin{papers} % start of individual articles/papers
+% \coltoctitle{An article} % first article title into main ToC
+% \coltocauthor{A.~N.~Author} % first authors into main ToC
+% \label{art1}
+% \import{art1} % first article, may have own ToC,
+% % bibliography, etc.
+% \coltoctitle{Another article}
+% \coltocauthor{A.~N.~Other}
+% \label{art2}
+% \import{art2}
+% \end{papers} % end of individual articles/papers
+%
+% \clearpage
+% \section{Acknowledgements} % into main ToC (section 2)
+%
+% Among the many ...
+%
+% \end{document}
+% \end{verbatim}
+%
+% \subsection{Class options}
+%
+% As well as providing all the class options appropriate for
+% the class of the individual documents, the \Lpack{combine}
+% class provides the following additional options:
+% \begin{itemize}
+% \item \Lopt{memoir}, \Lopt{book}, \Lopt{report}, and \Lopt{letter}.
+% By default the \Lpack{article}
+% class is assumed for both the main and the imported documents.
+% These options change the class to \Lpack{memoir}, \Lpack{book}, \Lpack{report} or
+% \Lpack{letter}, respectively.
+% \item \Lopt{colclass=\meta{class}}. This option changes
+% the `classes' to \meta{class}. For example, specifying
+% |colclass=phdthesis| will use the \Lpack{phdthesis}
+% class\footnote{Whatever that is.} definitions
+% throughout the entire document.
+%
+% Note that if you use this option there are likely to be \LaTeX{}
+% warnings about \texttt{Unused global option(s): [colclass=\ldots]}.
+%
+% \item \Lopt{classes}. This option enables the imported documents
+% to be of different classes. For example, embedding a letter
+% into a compendium of articles. Using this option may
+% induce a plethora of \LaTeX{} errors and the printed results
+% may be unpredictable. If this happens, try hitting `q' to
+% put \LaTeX{} into
+% its `quiet batch' processing mode and then examine the typeset result
+% for usability.
+%
+% Different classes of imported documents should not be mixed
+% within a single |papers| environment. Also, imported documents
+% whose class is the same but which differs from the main class
+% should be within a single |papers| environment. For example,
+% if several letters are to be imported into a collection
+% of articles, the letters must not be scattered between different
+% |papers| environments, although the imported articles can be
+% scattered.
+%
+% \item \Lopt{packages}. By default all |\usepackage| commands in
+% imported documents are ignored. If this is not desired,
+% then the \Lopt{packages} option will enable the imported
+% |\usepackage| commands(s). If this option is used, then only
+% the first occurrence of a package is actually used and is not
+% available to any later imported documents.
+%
+% Generally speaking, it is advisable to put all |\usepackage|
+% commands into the preamble of the main document.
+%
+% \item \Lopt{layouts}. By default, a single setting of the
+% page layout is used throughout the document. The \Lopt{layouts}
+% option takes account of any changes to the |\textwidth|,
+% |\textheight|, etc., in the imported documents.
+%
+% \item \Lopt{folios}. The page numbers are sequential throughout
+% the document. When the |plain| page style is used, the
+% \Lopt{folios} option will display the
+% local page numbers of imported documents as well as the
+% the main page number. This may have unfortunate consequences
+% on the page numbers in ToC, etc., entries as they may well
+% refer to local rather than global page numbers.
+%
+% \item \Lopt{notoc}. Disables the inclusion of a Table of Contents
+% in any imported document.
+% \item \Lopt{nolof}. Disables the inclusion of a List of Figures
+% in any imported document.
+% \item \Lopt{nolot}. Disables the inclusion of a List of Tables
+% in any imported document.
+% \item \Lopt{maintoc}. Adds all imported documents ToC, LoF, LoT, etc.,
+% entries to the main document ToC, LoF, \ldots
+% \item \Lopt{notitle}. Disables title printing by any |\maketitle|
+% in any imported document.
+% \item \Lopt{noauthor}. Disables author printing by any |\maketitle|
+% in any imported document.
+% \item \Lopt{date}. By default, date printing by any |\maketitle|
+% in any imported document is disabled. This option causes
+% the date(s) to be printed.
+% \item \Lopt{nomaketitle}. Disables all printing by any |\maketitle|
+% in any imported document.
+% \item \Lopt{nopubindoc}. Disables the printing of the |\published|
+% information within an imported document.
+% \item \Lopt{nopubintoc}. Disables the printing of the |\published|
+% information within the main ToC.
+% \item \Lopt{onebib}. Disables imported bibliographies and puts all
+% citations in the main document's bibliography.
+% \item \Lopt{combinedbib}. Individual imported bibliographies and
+% also all citations put into the main document's bibliography.
+% \end{itemize}
+%
+% The \Lpack{combine}
+% class may be able to incorporate any class of imported documents by
+% setting an appropriate value for the \Lopt{colclass} option and perhaps
+% doing some additional work.
+%
+% For example, if you want to have a collection of examination papers
+% which were each is originally produced using the \Lpack{exam} class,
+% then start off with: \\
+% |\documentclass[...,colclass=exam]{combine} | \\
+% The \Lpack{exam} class, though, does a couple of things that prevent
+% \Lpack{combine} and \Lpack{exam} from working well together:
+% \begin{itemize}
+% \item \Lpack{exam} has its own version of |\section| which is totally at
+% odds with the normal \Lpack{article} definition, and |\section*| is
+% used by the |\tableofcontents| command.
+% \item \Lpack{exam} does wonderful things at the end of a document. This
+% is alright for imported documents in a |papers| environment but is an
+% abject failure at the final end of the main document.
+% \end{itemize}
+%
+% To get round these problems, put the following in the preamble to
+% the main document:
+% \begin{verbatim}
+% \makeatletter
+% \let\oldsection\section % keep exam's definition of \section
+% \renewcommand{\section}{% % article's definition of \section
+% \@startsection{section}{1]{\z@}%
+% {-3.5ex \@plus -1ex \@minus -.2ex}%
+% {2.3ex \@plus .2ex}%
+% {\normalfont\Large\bfseries}}
+% \makeatletter
+% \end{verbatim}
+% and in the document put: \\
+% |\let\section\oldsection| \\
+% immediately before the first |papers| environment.
+%
+% For the end document problem, put:
+% \begin{verbatim}
+% \makeatletter
+% \let\@enddocumenthook\@oldenddocumenthook
+% \makeatother
+% \end{verbatim}
+% immediately before the main document's |\end{document}|.
+%
+%
+% \subsection{Class commands and environments}
+%
+% Within a \Lpack{combine} class document you can use any commands
+% that are supported by the selected class.
+% The following additional commands and environments are also
+% provided.
+%
+% \DescribeEnv{papers}
+% The environment |\begin{papers}[|\meta{text/code}|]...\end{papers}|
+% provides a wrapper around imported file(s). Effectively, it modifies
+% any |\documentclass| command or |document| environment within an
+% imported file so that \LaTeX{} does not stop with an error at meeting
+% these, or preamble-only commands like |\usepackage|, in the middle
+% of a document.
+%
+% The optional argument is executed immediately at the start of
+% the environment and its default value is |\cleardoublepage|.
+% To avoid any forced page breaking you can call the environment with
+% an empty optional argument (e.g., |\begin{papers}[]|).
+%
+%
+% \DescribeMacro{\import}
+% The command |\import{|\meta{texfile}|}| is a cross between the |\input|
+% and |\include| commands, and should only be used within a |papers|
+% environment. \meta{texfile} is the name of a \LaTeX{} file \emph{without}
+% the |.tex| extension. For example, |\import{fred}| will attempt to
+% read in a file called |fred.tex|. The \meta{texfile} should be a
+% complete \LaTeX{} document file, from |\documentclass...| to
+% |\end{document}|. The contents of \meta{texfile} will be typeset in
+% the document at the point where it is imported, including any document
+% title (via a |\maketitle|), Table of Contents, \ldots, Bibliography, etc.
+%
+% \DescribeMacro{\maketitle}
+% The \Lpack{combine} class provides a |\maketitle| command, together with
+% |\title|, |\author| and |\date| commands like those in the
+% \Lpack{book/report/article} classes. A \Lopt{titlepage} option is only
+% supported if the main class has a \Lopt{titlepage} option. For example,
+% if the main class is \Lpack{article} then both |\maketitle| and the
+% \Lopt{titlepage} option are supported, but if the main class is
+% \Lpack{letter} then only the |\maketitle| command is provided.
+%
+% \DescribeMacro{\maintitlefont}
+% \DescribeMacro{\postmaintitle}
+% \DescribeMacro{\mainauthorfont}
+% \DescribeMacro{\postmainauthor}
+% \DescribeMacro{\maindatefont}
+% \DescribeMacro{\postmaindate}
+% These commands control the typesetting of the main document's |\maketitle|
+% command. The |\title| is processed between the |\maintitlefont| and
+% |\postmaintitle| commands; that is, like: \\
+% |{\maintitlefont \title \postmaintitle}| \\
+% and similarly for the |\author| and |\date| commands. The |\...main...|
+% commands are initialised to mimic the normal result of |\maketitle|
+% typesetting in the \Lpack{article/report} classes.
+% For example, the default definitions of the |\...maintitle...|
+% and |\...mainauthor...| commands are:\par
+% \begin{small}
+% \begin{verbatim}
+% \newcommand{\maintitlefont}{\begin{center}\LARGE}
+% \newcommand{\postmaintitle}{\par\end{center}\vskip 0.5em}
+% \newcommand{\mainauthorfont}{\begin{center}
+% \large \lineskip 0.5em%
+% \begin{tabular}[t]{c}}
+% \newcommand{\postmainauthor}{\end{tabular}\par\end{center}}
+% \end{verbatim}
+% \end{small}\par
+% They can be renewed to obtain different effects, for instance removing
+% the |center| environment from |\...title...| will result in the title
+% being typeset as a normal paragraph.
+%
+% \DescribeMacro{\importtitlefont}
+% \DescribeMacro{\postimporttitle}
+% \DescribeMacro{\importauthorfont}
+% \DescribeMacro{\postimportauthor}
+% \DescribeMacro{\importdatefont}
+% \DescribeMacro{\postimportdate}
+% Without any options, the |\title| and |\author| commands
+% are typeset by |\maketitle| commands in imported documents.
+% Like the main document's |\maketitle|, the typesetting is controlled
+% by these |\...import...| commands. The default definition for
+% the title and author differ a little from the main document style,
+% and are:\par
+% \begin{small}
+% \begin{verbatim}
+% \newcommand{\importtitlefont}{\begin{center}\LARGE\bfseries}
+% \newcommand{\postimporttitle}{\par\end{center}}
+% \newcommand{\importauthorfont}{\begin{center}
+% \large\itshape \lineskip 0.5em%
+% \begin{tabular}[t]{c}}
+% \newcommand{\postimportauthor}{\end{tabular}\par\end{center}}
+% \end{verbatim}
+% \end{small}\par
+% The commands can be renewed to obtain different formatting.
+%
+% Note that if the \Lpack{titling} package is used with the \Lpack{combine}
+% class, the \Lpack{titling} maketitle typesetting commands are unavailable,
+% being replaced by the corresponding \Lpack{combine} commands above. Other
+% aspects of \Lpack{titling}, like the |\thetitle| command, are still
+% available for use.
+%
+% \DescribeMacro{\bodytitle}
+% The |\bodytitle[|\meta{short title}|]{|\meta{long title}|}| command
+% is similar
+% to a |\chapter| or |\section| command, depending on the \meta{class}
+% of document. It may be used for adding a numbered title heading into
+% the main
+% document and ToC for the following |\import{|\meta{texfile}|}|. There
+% is also a starred version of the command, which produces an unnumbered
+% title heading and makes no entry in the ToC. The numbering used for
+% |\bodytitle| is independent from any other numbering sequence.
+%
+% \DescribeMacro{\coltoctitle}
+% \DescribeMacro{\coltocauthor}
+% The two commands |\coltoctitle{|\meta{title}|}| and
+% |\coltocauthor{|\meta{author}|}| are for adding \meta{title} and
+% \meta{author} to the main ToC, where \meta{title} is the compiler's
+% choice for the title of the following |\import{|\meta{texfile}|}|
+% and \meta{author} is for the names of the authors.
+%
+% \DescribeMacro{\published}
+% The command |\published[|\meta{short}|]{|\meta{long}|}| can be used
+% for putting the \meta{long} text into the body of the main document.
+% If the optional argument is not used, then \meta{long} is also added
+% to the main ToC. If the optional argument is used, then \meta{short}
+% instead of \meta{long} is added to the ToC. The expectation is that this
+% will be used for noting the original publication information for an
+% imported document.
+%
+% \DescribeMacro{\pubfont}
+% In the document body the text of the |\published| command is typeset
+% using |\pubfont|. By default this is defined as |{\normalfont\centering}| to
+% give centered text in the normal font. If, for example, you wanted
+% it to be typeset ragged right in an italic font you would do: \\
+% |\renewcommand{\pubfont}{\itshape\raggedright}|
+%
+% \DescribeMacro{\toctitleindent}
+% \DescribeMacro{\tocauthorindent}
+% \DescribeMacro{\tocpubindent}
+% \DescribeMacro{\toctocindent}
+% These are all lengths, and their values can be changed using
+% |\setlength|. They control the extra indentation of an imported
+% document's title, authors, publication information and section
+% headings within the main ToC. The default value of |\toctitleindent|
+% is 0em and the default for the other four is 1.5em. If any values
+% are changed, this must be
+% done before the |\tableofcontents| command in the main document.
+% For example, the title texts are aligned at the left margin;
+% to align them with the default position of authors do: \\
+% |\setlength{\toctitleindent}{1.5em}|
+%
+% \DescribeMacro{\toctitlefont}
+% \DescribeMacro{\tocauthorfont}
+% \DescribeMacro{\tocpubfont}
+% These macros specify the fonts to be used for typesetting the
+% imported titles, authors and publishing information within the main ToC.
+% Their default definitions are: \\
+% |\newcommand{\toctitlefont}{\bfseries}| % bold titles \\
+% |\newcommand{\tocauthorfont}{\itshape}| % italic authors \\
+% |\newcommand{\tocpubfont}{\normalfont}| % normal font for published
+%
+% The class tries to keep any group of title/author/published entries
+% in the ToC on one page, but sometimes TeX will insert a pagebreak anyway.
+% The way of combating this is to make sure that the ToC page is broken
+% \emph{before} the group. You can do this like: \\
+% |\addtocontents{toc}{\protect\pagebreak}| \\
+% |\coltoctitle{...} \coltocauthor{...}| etc.
+%
+% \DescribeMacro{\erasetitling}
+% This macro `undefines' any previous |\coltoctitle|, |\coltocauthor|
+% and/or |\published| commands; it is principally provided for use with the
+% \Lpack{combinet} package.
+%
+%
+% \DescribeMacro{combine}
+% A new |combine| pagestyle is provided. This is like the |plain|
+% pagestyle except that page numbers are put at the bottom outside corner
+% of the page. This is the default pagestyle for the \Lpack{combine}
+% class.
+%
+% Provided a |plain| (or |combine|) page style is used the pages
+% are numbered in sequence throughout the document. If an imported document
+% has any |empty| page style pages these will not be numbered.
+%
+% Unless the \Lopt{folios} option is used, all references to page
+% numbers will be to the global page number. With the \Lopt{folios}
+% options some references will be to global page numbers and some to
+% local page numbers.
+%
+% You can, of course, define your own heading styles; I recommend
+% the \Lpack{fancyhdr} package~\cite{FANCYHDR} if you do this. For example,
+% if you had a collection of papers and you wanted to have the
+% headers on the lefthand pages to have the title of the collection
+% and the righthand pages to have the name of the current author(s), you
+% can do this along the following lines.
+% \begin{verbatim}
+% \documentclass[report,twoside]{combine}
+% \usepackage{fancyhdr}
+% \title{The collection}
+% \author{A. N. Editor}
+% \pagestyle{fancy}
+% \fancyhead[RO]{A. N. Editor}
+% \fancyhead[LE]{The collection}
+% \fancyfoot{}
+% \fancyfoot[LE,RO]{\thepage}
+% \newcommand{\authortochead}[1]{%
+% \coltocauthor{#1}
+% \fancyhead[RO]{#1}
+% }
+% ...
+% \begin{document}
+% \maketitle
+% %% Editors introduction, ToC, etc
+% \begin{papers}
+% \coltoctitle{Paper 1}
+% \authortochead{A. N. Author}
+% \import{paper1}
+% \cleardoublepage
+% \coltoctitle{Paper 2}
+% \authortochead{A. N. Other}
+% \import{paper2}
+% ...
+% \end{verbatim}
+%
+%
+% In order to ensure that all the material in an imported document
+% is typeset, there is an inbuilt |\clearpage| command within the
+% imported document's |\end{document}|. Thus, any material after an
+% |\import| command will start on a new page.
+%
+% Here is another example file which might be the skeleton for a
+% thesis that includes a copy of a published paper.
+% \begin{verbatim}
+% %%\documentclass{thesis} % replace this by
+% \documentclass[colclass=thesis,classes,layouts]{combine}
+% ... packages etc.,
+%
+% \title{Observations on the ...}
+% \author{A. Candidate}
+% \date{1 April, 2000}
+% \addtolength{\toctitleindent}{2.3em} % extra main ToC indentation
+% \addtolength{\tocauthorindent}{2.3em}
+% \addtolength{\tocpubindent}{2.3em}
+%
+% \begin{document}
+% \pagestyle{combine} % use the combine page style
+% \maketitle % main title
+% \tableofcontents % main ToC
+% \clearpage
+% ...
+% lots of remarkable research results
+% ...
+% \appendix
+% ...
+% \section{Publication}
+% \begin{papers}[]
+% \coltoctitle{...}
+% \published{Originally published in the
+% \textit{Journal of Irreproducible Results}, 1987}
+% \import{mypaper}
+% \end{papers}
+% ...
+%
+% \bibliography{refs} % main bibliography
+% \end{document}
+% \end{verbatim}
+%
+% Each imported file generates its own \file{.aux}, \file{.toc}, etc.,
+% files. If a BibTeX database is used for the literature references
+% in an imported document, then BibTeX must be run against the imported
+% document, \emph{not} the main document, to resolve the citations.
+% Citations are local to each imported document. There can, of course,
+% also be a bibliography for citations made in the main document, as shown
+% in the example file above.
+%
+% \DescribeMacro{\provideenvironment}
+% This macro is like the |\providecommand| macro except that it applies
+% to an environment instead of a command. It is required internally
+% by the \Lpack{combine} class.
+%
+% \DescribeMacro{\providelength}
+% \DescribeMacro{\providecounter}
+% These macros are used internally. They are |\provide...|
+% versions of the |\newlength| and |\newcounter| commands.
+%
+% \DescribeMacro{\zeroextracounters}
+% The class attempts to initialise the counters used by each imported
+% document. For example, the figure, equation, etc., counters are zeroed
+% for each document. The |\zeroextracounters| command can be redefined so
+% that it includes the zeroing of any additional counters that might have
+% been introduced in a package or defined by the author. For example,
+% if two different imports both define a (new) counter called, say,
+% |mycounter|, then redefine the command like:
+% \begin{verbatim}
+% \renewcommand{\zeroextracounters}{%
+% \@ifundefined{c@mycounter}{}{\setcounter{mycounter}{0}}
+% }
+% \end{verbatim}
+%
+% \DescribeMacro{\appendiargdef}
+% The (internal) command |\appendiargdef{|\meta{macro}|}{|\meta{stuff}|}|
+% appends \meta{stuff} at the end of the current definition of \meta{macro},
+% where \meta{macro} is the name of a macro (including the backslash)
+% which takes one argument. For example the following are two equivalent
+% definitions of |\mymacro|:
+% \par\begin{small}\begin{verbatim}
+% \newcommand{\mymacro}[1]{#1 is a bagpiper}
+% \appendiargdef{\mymacro}{ and of course is tone deaf}
+% % or
+% \newcommand{\mymacro}[1]{#1 is a bagpiper and of course is tone deaf}
+% \end{verbatim}
+% \end{small}\par
+%
+% \DescribeMacro{\emptyAtBeginDocument}
+% Some combinations of circumstances cause an infinite recursion at the
+% start of an imported document; in particular the combination of
+% \texttt{combine + graphicx + caption2 + pdflatex} causes this. In this case
+% the solution was to put |\emptyAtBeginDocument| immediately after the
+% initial |\begin{document}|. It may also have worked if it had been added
+% after each |\begin{papers}| or before each |\import{}|. An error message
+% about being out of stack space may indicate recursion. Judicious use
+% of |\emptyAtBeginDocument| may resolve the problem.
+%
+% \subsection{Imports in subdirectories}
+%
+% Authors may find it convenient to put the LaTeX source files for imported
+% documents into subdirectories of the directory for the main document.
+% Perhaps the easiest way to make this work is to set an environment
+% variable so that LaTeX will look in the subdirectories of the current
+% working directory for files it can't find.
+%
+% I use a teTeX system and can only talk about that distribution.
+% The relevant environment variable, at least for document files, is
+% |TEXINPUTS|. An example setting for this is: \\
+% |TEXINPUTS=.//:${LOCALTEX}//:| \\
+% The fragment |.//| tells LaTeX to look for files in the current directory,
+% and recursively in its subdirectories. The fragment |:${LOCALTEX}//| tells
+% LaTeX to look for files in the place defined by the environment variable
+% |LOCALTEX|, and recursively in its subdirectories. The final |:| tells
+% LaTeX to look in the standard teTeX defined places.
+%
+% \section{The \Lpack{combinet} package} \label{pack}
+%
+% The \Lpack{combinet} (COMBINE Title) package,
+% which should only be used in conjunction
+% with the \Lpack{combine} class, modifies the |\maketitle| command of
+% all imported documents so that the imported document's title and/or
+% author, if
+% defined, are automatically added to the main document's ToC.
+%
+% This is presented as a package rather than as part of the
+% \Lpack{combine} class as some unfortunate side effects may become
+% apparent.
+%
+% If a |\coltoctitle| or |\coltocauthor| command has been given
+% immediately prior to the import, then these will be put into the main
+% ToC instead of the |\maketitle| texts. The |\erasetitling| command can
+% be used to disable any prior |\coltoctitle|, |\coltocauthor| and
+% |\published| commands.
+%
+% The package takes the following options.
+% \begin{itemize}
+% \item \Lopt{nomtitle}. Disable the |\maketitle| title
+% from being added to the main ToC.
+% \item \Lopt{nomauthor}. Disable the |\maketitle| author
+% from being added to the main ToC.
+% \item \Lopt{nothanks}. By default, the contents of a |\thanks| command
+% will be added to the main ToC. This option prevents that, but
+% may have unfortunate side effects if any |\title| or |\author|
+% command has any embedded commands within the text.
+% \item \Lopt{pub}. Put the text of an immediately prior |\published|
+% command after the |\maketitle| typesetting, and add the text to the
+% main ToC after any title or author. Remember that the \Lpack{combine}
+% class options \Lopt{nopubindoc} and \Lopt{nopubindoc} can be used
+% to inhibit printing of |\published| information.
+% \item \Lopt{pubtop}. Put the text of an immediately prior |\published|
+% command at the top of the |\maketitle| typesetting, and add the
+% text to the
+% main ToC after any title or author.
+% \end{itemize}
+%
+% As noted above, embedded commands within a |\title| or |\author| may
+% not transform well if they appear in the main ToC. In such cases you can
+% use |\coltoctitle| or |\coltocauthor| for adding appropriate text to
+% the main ToC, not forgetting to disable these after the import via
+% |\erasetitling|.
+%
+% \section{The \Lpack{combnat} package} \label{natpack}
+%
+% The \Lpack{combine} class and Patrick Daly's \Lpack{natbib}
+% package~\cite{NATBIB}
+% both redefine some of the same basic LaTeX macros, and naturally
+% the redefinitions are incompatible\footnote{Discovered by
+% Thomas Hertweck (\texttt{Thomas.Hertweck@gpi.uni-karlsruhe.de}) in
+% June 2001.}.
+%
+% The \Lpack{combnat} (COMBine NATbib) package hopefully resolves this
+% problem. With the \Lpack{combine} class you use \Lpack{combnat} instead
+% of \Lpack{natbib}. That is, instead of: \\
+% |\usepackage[|\meta{natbib-options}|]{natbib}|, simply do \\
+% |\usepackage[|\meta{natbib-options}|]{combnat}| \\
+% in the preamble of the main document. The package automatically calls
+% the \Lpack{natbib} package with the given \meta{natbib-options} and
+% then redefines some of the \Lpack{natbib} redefinitions to ensure
+% \Lpack{combine/natbib} compatibility.
+%
+% For details on the \meta{natbib-options} and the other facilities,
+% read the \Lpack{natbib} documentation~\cite{NATBIB}.
+%
+% \section{The \Lpack{combcite} package} \label{citepack}
+%
+% The \Lpack{combine} class and Donald Aresneau's \Lpack{cite}
+% package~\cite{CITE}
+% both redefine some of the same basic LaTeX macros, and naturally
+% the redefinitions are incompatible\footnote{Discovered by
+% Marcilio Alves (\texttt{maralves@usp.br}) in
+% November 2003.}
+%
+% The \Lpack{combcite} (COMBine CITE) package hopefully resolves this
+% problem. With the \Lpack{combine} class you use \Lpack{combcite} instead
+% of \Lpack{cite}. That is, instead of: \\
+% |\usepackage[|\meta{cite-options}|]{cite}|, simply do \\
+% |\usepackage[|\meta{cite-options}|]{combcite}| \\
+% in the preamble of the main document. The package automatically calls
+% the \Lpack{cite} package with the given \meta{cite-options} and
+% then redefines some of the \Lpack{cite} redefinitions to ensure
+% \Lpack{combine/cite} compatibility.
+%
+% For details on the \meta{cite-options} and the other facilities,
+% read the \Lpack{cite} documentation~\cite{CITE}.
+%
+% The \Lpack{combcite} package requires the November 2003 version 4.01
+% of \Lpack{cite}. This version covers the functions provided by the
+% \Lpack{overcite} package. More precisely \\
+% \verb?\usepackage[...]{overcite}? is implemented as \\
+% \verb?\usepackage[superscript,...]{cite}?
+%
+%
+% \section{Caveats}
+%
+% \LaTeX{} was designed to typeset a single document, where the document
+% has one and only one |\documentclass| command and one and only one
+% |document| environment. The \Lpack{combine} class attempts to handle
+% a document that has multiple |\documentclass| commands and multiple
+% |document| environments. In order to do this certain parts of the
+% \LaTeX{} kernel code has had to be modified. Unfortunately, to make
+% the usage of \Lpack{combine} completely transparent to the user would
+% require very major surgery, with a high probability that with my skills
+% the patient would die; being able to remove a hangnail does not imply
+% the ability to perform a heart transplant.
+%
+% It is, of course, assumed that each imported document processes without
+% error as an individual document.
+%
+% Essentially, be prepared for the unexpected, usually indicated
+% by a rash of \LaTeX{} error messages about undefined commands or about
+% defining an already defined command. These are usually caused by incorrect
+% grouping.
+%
+% Commands, etc., defined in the main document are available to
+% all imported
+% documents. The |papers| environment forms a group. Commands
+% defined within a group are local to the group and are not visible outside
+% it. Another point is that \LaTeX{} will read the code for any given
+% class or package only once. These facts have some consequences.
+%
+% \begin{itemize}
+% \item The facilities provided by any package that is used by an imported
+% file are only available within the first |papers| environment
+% in which the package is called for. This is why it is recommended
+% that all packages should be called for in the main document.
+%
+% \item Similarly for a class that is not the main class. For example,
+% if the main class is \Lpack{article} and some letters are to be
+% imported, then they must all be in the same |papers| environment.
+% If they are in multiple |papers| environments, then only the first
+% of these will have access to commands like |\address| which are
+% defined by the \Lpack{letter} class (which is only read once and
+% whose facilities are then local to the first of the |papers|).
+%
+% \item An imported document does not form a group (if it did, then only
+% a single letter could be imported into an article class collection).
+% If two imports in a single |papers| seperately use |\new...|
+% commands
+% with the same \meta{name}, then these \meta{name}s will be
+% visible throughout
+% the environment. \LaTeX{} will then normally report trying to define a
+% pre-existing \meta{name}. The solution to this is either: (a) put
+% the imports into different |papers|, or (b) enclose each import
+% within a |\begingroup| \ldots |\endgroup| pair.
+%
+% \end{itemize}
+%
+% Not all problems can be solved by the above methods. For example, consider
+% the case again of importing letters into an article collection. If two
+% letters both define the same \meta{name}, then adding additional grouping
+% will only change the `defining a pre-existing \meta{name}' problem into
+% the `undefined |\address|' problem. A potential solution in this
+% particular case
+% would be to define all the \Lpack{letter} class specific \meta{name}s in the
+% main document.
+%
+% Within a |papers| environment all |\newcommand| and |\newenvironment|
+% commands are replaced by |\providecommand| and |\provideenvironment|
+% respectively. This should stop \LaTeX{} from reporting the pre-existing
+% \meta{name} error from these commands, but one and only one of the
+% definitions will be available. |\newlength| and |\newcounter| commands
+% are handled in the same manner. There is no equivalent for |\newtheorem|,
+% but instead the |\newtheorem| command has been made local instead
+% of global, so cunning use of grouping should be able to circumvent the
+% problem of two seperate authors creating identically named
+% theorems.
+%
+%
+%
+% \StopEventually{
+% \bibliographystyle{alpha}
+% \begin{thebibliography}{GMS94}
+%
+% \bibitem[Ars03]{CITE}
+% Donald Arseneau.
+% \newblock \emph{Cite: Compressed, sorted lists of on-line
+% or superscript numerical citations}.
+% \newblock November 2003.
+% \newblock (Available from CTAN in directory
+% \texttt{macros/latex/contrib/cite})
+%
+% \bibitem[Dal99]{NATBIB}
+% Patrick W. Daly.
+% \newblock \emph{Natural Sciences Citations and References}.
+% \newblock May 1999.
+% \newblock (Available from CTAN in directory
+% \texttt{macros/latex/contrib/natbib})
+%
+% \bibitem[GMS94]{GOOSSENS94}
+% Michel Goossens, Frank Mittelbach, and Alexander Samarin.
+% \newblock \emph{The LaTeX Companion}.
+% \newblock Addison-Wesley Publishing Company, 1994.
+%
+% \bibitem[Oos96]{FANCYHDR}
+% Piet van Oostrum.
+% \newblock \emph{Page layout in LaTeX}.
+% \newblock June 1996.
+% \newblock (Available from CTAN in directory
+% \texttt{macros/latex/contrib/fancyhdr})
+%
+%
+% \end{thebibliography}
+% }
+%
+%
+% \section{The \Lpack{combine} class code} \label{sec:code}
+%
+% There are various difficulties to be overcome by the
+% \Lpack{combine} code, some seemingly inherent in \TeX{} itself and
+% others by the \LaTeX{} kernel code. These include, but are not limited to:
+% \begin{itemize}
+% \item TeX{} was not designed for processing multiple documents.
+% \item There can only be one |\documentclass| command within
+% a document.
+% \item There are many \LaTeX{} commands that can only be used in
+% the preamble, and the preamble is closed by the (first) |\begin{document}|.
+% \item There is a single global page number, which may be reset to one
+% at any point in any document. If this occurs in an imported document
+% then the page numbering for the main document is similarly reset.
+% \item |\label|s are global in nature, and with multiple imported
+% documents there are likely to be labels with the same name in two
+% or more of these.
+% \item Many of the kernel (and standard classes) commands use
+% the page number; sometimes the use is buried at the end of a chain
+% of macros.
+% \end{itemize}
+%
+% A design goal for \Lpack{combine} is that virtually any kind
+% of document should be importable and should be processible without
+% have to make any changes to it. To completely satisfy this would
+% require a rewrite of much of the \LaTeX{} kernel, which is out
+% of the question. Of necessity some changes have had to be made but
+% these have been limited as far as possible. I think that a collection
+% that consists of documents that are all of the same class should
+% process without interruption.
+%
+% When there are mixed classes, \LaTeX{}
+% reads in the code for each class. An example is importing a \Lpack{letter}
+% class document into an \Lpack{article} class collection.
+% If the same command is defined
+% by |\newcommand| in two or more of these classes, then \LaTeX{}
+% complains and I see no way of getting around this without rewriting
+% all the classes and kernel to use |\def| instead of |\newcommand|.
+% In any event, if this happens, try responding to the errors by hitting
+% `q' to put \LaTeX{} into a batch mode. The typeset result may be useable.
+%
+% To try and avoid name clashes, all the internal commands include
+% the string |c@l|.
+%
+% \section{Preliminaries}
+%
+% Announce the name and version of the class, which requires
+% \LaTeXe{} and the \Lpack{keyval} package.
+% (This now happens at the top of DTX file so doesn't appear here.)
+% \changes{v0.53}{2001/09/05}{Class is now v0.45}
+% \changes{v0.6}{2002/08/24}{Class is now v0.5}
+% \changes{v0.63}{2003/11/09}{Class is now v0.52}
+% \begin{macrocode}
+%<*usc>
+\RequirePackage{keyval}
+% \end{macrocode}
+%
+% \begin{macro}{\c@lclass}
+% |\c@lclass| stores the class name, which by default is |article|.
+% \begin{macrocode}
+\newcommand{\c@lclass}{article}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@l@tempa}
+% \begin{macro}{\c@l@getoptionname}
+% The next code chunk is based on code posted to the \texttt{ctt} newsgroup
+% by Heiko Oberdiek (\texttt{oberdiek@ruf.uni-freiburg.de}) on 18~April 2000.
+% The code, by some miraculous means, sets up a keyed class option.
+% \begin{macrocode}
+\define@key{COLCLASS}{colclass}[article]%
+ {\renewcommand{\c@lclass}{#1}
+ \ClassWarningNoLine{combine}
+ {Expect warnings like:\MessageBreak
+ \space\space LaTeX Warning: Unused global option(s):\MessageBreak
+ \space\space\space\space [colclass=#1]}}
+\let\c@l@tempa\@empty
+\def\c@l@getoptionname#1=#2\@nil{#1}
+\@for\CurrentOption:=\@classoptionslist\do{%
+ \@ifundefined{%
+ KV@COLCLASS@\expandafter\c@l@getoptionname\CurrentOption=\@nil
+ }%
+ {% other options
+ }{%
+ \edef\c@l@tempa{\c@l@tempa,\CurrentOption,}%
+ }%
+}%
+\edef\c@l@tempa{%
+ \noexpand\setkeys{COLCLASS}{\c@l@tempa}%
+}
+\c@l@tempa
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% The following |\if...| commands are for implementing various options.
+% \changes{v0.4}{2000/05/27}{Unnested some macro environments to save save stack space}
+% \begin{macro}{\ifc@lclasses}
+% \begin{macrocode}
+\newif\ifc@lclasses
+ \c@lclassesfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lpackages}
+% \begin{macrocode}
+\newif\ifc@lpackages
+ \c@lpackagesfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@llayouts}
+% \begin{macrocode}
+\newif\ifc@llayouts
+ \c@llayoutsfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lfolios}
+% \begin{macrocode}
+\newif\ifc@lfolios
+ \c@lfoliosfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnotoc}
+% \begin{macrocode}
+\newif\ifc@lnotoc
+ \c@lnotocfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnolof}
+% \begin{macrocode}
+\newif\ifc@lnolof
+ \c@lnoloffalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnolot}
+% \begin{macrocode}
+\newif\ifc@lnolot
+ \c@lnolotfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lmaintoc}
+% \begin{macrocode}
+\newif\ifc@lmaintoc
+ \c@lmaintocfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnodate}
+% \begin{macrocode}
+\newif\ifc@lnodate
+ \c@lnodatetrue
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnoauthor}
+% \begin{macrocode}
+\newif\ifc@lnoauthor
+ \c@lnoauthorfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnotitle}
+% \begin{macrocode}
+\newif\ifc@lnotitle
+ \c@lnotitlefalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnomaketitle}
+% \begin{macrocode}
+\newif\ifc@lnomaketitle
+ \c@lnomaketitlefalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnopubindoc}
+% \changes{v0.4}{2000/05/27}{Added nopubindoc and nopubintoc options}
+% \begin{macrocode}
+\newif\ifc@lnopubindoc
+ \c@lnopubindocfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lnopubintoc}
+% \begin{macrocode}
+\newif\ifc@lnopubintoc
+ \c@lnopubintocfalse
+% \end{macrocode}
+% \end{macro}
+% \changes{v0.5}{2002/08/24}{Added onebib and combinedbib options}
+% \begin{macro}{\ifc@lonebib}
+% \begin{macrocode}
+\newif\ifc@lonebib
+ \c@lonebibfalse
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\ifc@lcombib}
+% \begin{macrocode}
+\newif\ifc@lcombib
+ \c@lcombibfalse
+% \end{macrocode}
+% \end{macro}
+%
+%
+% Now declare and process the options.
+% \changes{v0.4}{2000/05/27}{Added book option}
+% \changes{v0.6}{2002/08/24}{Added onebib option}
+% \changes{v0.63}{2003/11/09}{Added memoir option}
+% \begin{macrocode}
+
+\DeclareOption{book}{\def\c@lclass{book}}
+\DeclareOption{report}{\def\c@lclass{report}}
+\DeclareOption{letter}{\def\c@lclass{letter}}
+\DeclareOption{memoir}{\def\c@lclass{memoir}}
+\DeclareOption{classes}{\c@lclassestrue}
+\DeclareOption{packages}{\c@lpackagestrue}
+\DeclareOption{layouts}{\c@llayoutstrue}
+\DeclareOption{folios}{\c@lfoliostrue}
+\DeclareOption{notoc}{\c@lnotoctrue}
+\DeclareOption{nolof}{\c@lnoloftrue}
+\DeclareOption{nolot}{\c@lnolottrue}
+\DeclareOption{maintoc}{\c@lmaintoctrue}
+\DeclareOption{date}{\c@lnodatefalse}
+\DeclareOption{noauthor}{\c@lnoauthortrue}
+\DeclareOption{notitle}{\c@lnotitletrue}
+\DeclareOption{nomaketitle}{\c@lnomaketitletrue}
+\DeclareOption{nopubindoc}{\c@lnopubindoctrue}
+\DeclareOption{nopubintoc}{\c@lnopubintoctrue}
+\DeclareOption{onebib}{\c@lonebibtrue}
+\DeclareOption{combinedbib}{\c@lcombibtrue}
+\DeclareOption*{\PassOptionsToClass{\CurrentOption}{\c@lclass}}
+\ProcessOptions\relax
+\ifc@lcombib
+ \c@lonebibtrue
+\fi
+
+% \end{macrocode}
+%
+%
+% At this point, load the actual class (as specified by |\c@lclass|).
+% \begin{macrocode}
+\LoadClass{\c@lclass}
+
+% \end{macrocode}
+%
+% \begin{macro}{\ifc@lhaschapter}
+% |\ifc@lhaschapter| is TRUE if the loaded class has chapters.
+% \begin{macrocode}
+\newif\ifc@lhaschapter
+ \c@lhaschapterfalse
+\@ifundefined{chapter}{}{\c@lhaschaptertrue}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\if@titlepage}
+% The \Lpack{letter} class (and perhaps others) does not have a
+% |\maketitle| command, and therefor neither has a \Lopt{titlepage} option.
+% In this case we need a new |\if@titlepage| for later use when dealing
+% with |\maketitle|. A side effect of this implementation is that |\maketitle|
+% is available for any main document class.
+% \changes{v0.3}{2000/05/20}{Ensured \cs{if@titlepage} is defined}
+% \begin{macrocode}
+\@ifundefined{if@titlepage}{\newif\if@titlepage\@titlepagefalse}{}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ifc@ltoctitle}
+% \begin{macro}{\ifc@ltoctitle}
+% \begin{macro}{\ifc@lpub}
+% Boolean hooks for testing if |\coltoctitle|, |\coltocauthor| and
+% |\published| have been set.
+% \begin{macrocode}
+\newif\ifc@ltoctitle
+ \c@ltoctitlefalse
+\newif\ifc@ltocauthor
+ \c@ltocauthorfalse
+\newif\ifc@lpub
+ \c@lpubfalse
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{colpage}
+% \begin{macro}{c@lctr}
+% \begin{macro}{\c@section}
+% |colpage| is a counter for storing the (current) page number for the
+% main document.
+% |c@lctr| is a counter for storing the current main document sectioning
+% number. A section counter (|\c@section|) is provided when the class
+% does not have sections.
+% \begin{macrocode}
+\newcounter{colpage} \setcounter{colpage}{1}
+ \renewcommand{\thecolpage}{\arabic{colpage}}
+\newcounter{c@lctr}
+\@ifundefined{c@section}{\newcounter{section}}{}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@ltocfnum}
+% \begin{macro}{\c@lloffnum}
+% \begin{macro}{\c@llotfnum}
+% These are output stream numbers for local ToC, LoF and LoT files.
+% Allocating new streams for each imported file may cause \TeX{} to
+% run out of streams (there is a limit of 16).
+% \begin{macrocode}
+\newwrite\c@ltocfnum
+\newwrite\c@lloffnum
+\newwrite\c@llotfnum
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \section{Kernel modifications (and potential additions)}
+%
+% Much of the class code consists of new versions of \LaTeX{} kernel commands.
+% Redefinitions starting with |\c@la...| are for commands in the main
+% document. Modifications starting |\c@lb...| are for commands within
+% imported documents.
+%
+%
+% \begin{macro}{\provideenvironment}
+% \begin{macro}{\c@lprovide@environment}
+% \begin{macro}{\c@lenvironment}
+% \begin{macro}{\c@lenva}
+% \begin{macro}{\c@lenvb}
+% \begin{macro}{\c@lthrowenv}
+% To stop \LaTeX{} whining when multiple classes are read which happen
+% to define commands (via |\newcommand|) or environments
+% (via |\newenvironment|) that have the same names, we need to be able
+% to make \LaTeX{} use |\providecommand| and |\provideenvironment|
+% instead. Unfortunately the kernel does not provide a |\provideenvironment|
+% command, so here is one based on the code in the \Lpack{makecmds} package.
+% \begin{macrocode}
+\def\provideenvironment{%
+ \@star@or@long\c@lprovide@environment}
+\def\c@lprovide@environment#1{%
+ \@ifundefined{#1}{%
+ \expandafter\let\csname#1\endcsname\relax
+ \expandafter\let\csname end#1\endcsname\relax
+ \new@environment{#1}}{\c@lenvironment{#1}}
+}
+\def\c@lenvironment#1{%
+ \@testopt{\c@lenva#1}0}
+\def\c@lenva#1[#2]{%
+ \@ifnextchar [{\c@lenvb#1[#2]}{\c@lthrowenv{#1}{[#2]}}}
+\def\c@lenvb#1[#2][#3]{\c@lthrowenv{#1}{[#2][#3]}}
+\def\c@lthrowenv#1#2#3#4{}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lnamethm}
+% \begin{macro}{\@xnthm}
+% \begin{macro}{\@ynthm}
+% \begin{macro}{\@othm}
+% As pointed out by Hendri Hondrop\footnote{Email
+% from \texttt{hendri@cs.utwente.nl} on 16~May, 2000.}
+% |\newtheorem| commands in imported documents can interfere with each other.
+% My solution to this is to make the command local instead of global.
+% |\c@lnamethm| is a helper macro (removes the |\global| from the
+% |\@namedef|s in the original code), and the others are modifications
+% of the originals in \file{ltthm.dtx} (just removing any |\global| commands).
+% \changes{v0.3}{2000/05/20}{Added a local version of \cs{newtheorem}.}
+% \begin{macrocode}
+\@ifundefined{newtheorem}{}{%
+ \newcommand{\c@lnamethm}[3]{%
+ \@namedef{#1}{\@thm{#2}{#3}}%
+ \@namedef{end#1}{\@endtheorem}}
+ \def\@xnthm#1#2[#3]{%
+ \expandafter\@ifdefinable\csname #1\endcsname
+ {\@definecounter{#1}\@newctr{#1}[#3]%
+ \expandafter\xdef\csname the#1\endcsname{%
+ \expandafter\noexpand\csname the#3\endcsname \@thmcountersep
+ \@thmcounter{#1}}%
+ \c@lnamethm{#1}{#1}{#2}}}
+ \def\@ynthm#1#2{%
+ \expandafter\@ifdefinable\csname #1\endcsname
+ {\@definecounter{#1}%
+ \expandafter\xdef\csname the#1\endcsname{\@thmcounter{#1}}%
+ \c@lnamethm{#1}{#1}{#2}}}
+ \def\@othm#1[#2]#3{%
+ \@ifundefined{c@#2}{\@nocounterr{#2}}%
+ {\expandafter\@ifdefinable\csname #1\endcsname
+ {\@namedef{the#1}{\@nameuse{the#2}}
+ \c@lnamethm{#1}{#2}{#3}}}}
+}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\providelength}
+% This is a |\provide...| version of |\newlength| (from \file{ltlength.dtx}).
+% \changes{v0.4}{2000/05/27}{Added \cs{providelength} and \cs{providecounter}
+% commands}
+% \changes{v0.63}{2003/11/09}{Used \cs{providecommand} for \cs{providelength}
+% and \cs{providecounter} as they are defined in the memoir class}
+% \begin{macrocode}
+\providecommand{\providelength}[1]{%
+ \ifx #1\undefined
+ \newlength{#1}
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\providecounter}
+% This is a |\provide...| version of |\newcounter| (from \file{ltcounts.dtx}).
+% \begin{macrocode}
+\providecommand{\providecounter}[1]{%
+ \expandafter\ifx \csname c@#1\endcsname \undefined
+ {\@definecounter{#1}}%
+ \@ifnextchar[{\@newctr{#1}}{}
+ \else
+ \@ifnextchar[{\c@l@gobbleoptarg}{}
+ \fi
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@l@gobbleoptarg}
+% A macro that discards an optional argument (i.e., the tokens |[optarg]|).
+% \changes{v0.4}{2000/05/27}{Added \cs{c@l@gobbleoptarg} command}
+% \begin{macrocode}
+\def\c@l@gobbleoptarg[#1]{}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\appendiargdef}
+% The code for this is copied from the \Lpack{abstract} package, hence
+% the use of |@bs| instead of |c@l| as a distinguishing substring.
+% \changes{v0.41}{2000/06/18}{Added \cs{appendiargdef} from the abstract package}
+% \begin{macrocode}
+\providecommand{\appendiargdef}[2]{\begingroup
+ \toks@\expandafter{#1{##1}#2}%
+ \edef\@bsx{\endgroup \def\noexpand#1####1{\the\toks@}}%
+ \@bsx}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \subsection{Document commands and environments}
+%
+% \begin{macro}{\c@lbdocumentclass}
+% The |\documentclass| in imported documents has to be changed so that
+% commands including the |@| sign are legal in the preamble. By default
+% the declared options and class are discarded. When the \Lopt{classes}
+% option is used, any potential new class file must be read.
+% |\documentclass|
+% is originally defined in \file{ltclass.dtx}.
+% \begin{macrocode}
+\ifc@lclasses
+ \newcommand\c@lbdocumentclass{%
+ \makeatletter %% added
+ \let\newcommand\providecommand %% added
+ \let\newenvironment\provideenvironment %% added
+%% \let\documentclass\@twoclasseserror
+%% \if@compatability\else\let\usepackage\RequirePackage\fi
+ \@fileswithoptions\@clsextension
+ }
+\else
+ \newcommand{\c@lbdocumentclass}[2][\@empty]{%
+ \makeatletter
+ }
+\fi
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbusepackage}
+% The |\usepackage| command (from \file{ltclass.dtx})
+% in imported documents is normally disabled.
+% This is the disabled version.
+% \begin{macrocode}
+\ifc@lpackages\else
+ \newcommand{\c@lbusepackage}[2][\@empty]{}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbLoadClass}
+% This is a copy of the |\LoadClass| from \file{ltclass.dtx}. I found it was
+% needed if an imported document used a class that in its turn used
+% |\LoadClass|.\footnote{Problem reported by Hans Fredrik Nordhaug
+% \texttt{hansfn@mi.uib.no} on 2001/08/24.}
+% \changes{v0.52}{2001/08/25}{Added \cs{c@lbLoadClass}}
+% \begin{macrocode}
+\newcommand{\c@lbLoadClass}{%
+ \ifx\@currext\@pkgextension
+ \@latex@error{\noexpand\LoadClass in package file}%
+ {You may only use \noexpand\LoadClass in a class file.}%
+ \fi
+ \@fileswithoptions\@clsextension}
+
+% \end{macrocode}
+% \end{macro}
+%
+% The |\document| command (defined in \file{ltfiles.dtx}) has to be modified,
+% both for the main document (to allow later preamble commands and to
+% store the jobname of the main document), and similarly but not identically,
+% for the imported documents (output here is to the |\@partaux| file instead
+% of the |\@mainaux| file).
+%
+% \begin{macro}{\c@ltextblock}
+% |\c@ltextblock| is a macro holding some code that is common to both
+% |\c@ladocument| and |\c@lbdocument|.
+% \changes{v0.3}{2000/05/20}{Added \cs{c@ltextblock} command}
+% \begin{macrocode}
+\newcommand{\c@ltextblock}{%
+ \@colht\textheight
+ \@colroom\textheight \vsize\textheight
+ \columnwidth\textwidth
+ \@clubpenalty\clubpenalty
+ \if@twocolumn
+ \advance\columnwidth -\columnsep
+ \divide\columnwidth\tw@ \hsize\columnwidth \@firstcolumntrue
+ \fi
+ \hsize\columnwidth \linewidth\hsize
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@ladocument}
+% \begin{macro}{\c@lbdocument}
+% \begin{macrocode}
+\newcommand{\c@ladocument}{%
+ \endgroup
+ \let\mainjobname\jobname %% added
+ \def\c@lmainauxfile{\jobname.aux} %% added
+ \ifx\@unusedoptionlist\@empty\else
+ \@latex@warning@no@line{Unused global option(s):^^J%
+ \@spaces[\@unusedoptionlist]}%
+ \fi
+ \c@ltextblock %% a replacement
+ \begingroup\@floatplacement\@dblfloatplacement
+ \makeatletter\let\@writefile\@gobbletwo
+ \global \let \@multiplelabels \relax
+ \@input{\c@lmainauxfile}% %% changed
+ \endgroup
+ \if@filesw
+ \immediate\openout\@mainaux\c@lmainauxfile %% changed
+ \immediate\write\@mainaux{\relax}%
+ \fi
+ \process@table
+ \let\glb@currsize\@empty
+ \normalsize
+ \everypar{}%
+ \ifx\normalsfcodes\@empty
+ \ifnum\sfcode`\.=\@m
+ \let\normalsfcodes\frenchspacing
+ \else
+ \let\normalsfcodes\nonfrenchspacing
+ \fi
+ \fi
+ \@noskipsecfalse
+% \end{macrocode}
+% \begin{macro}{\@outputpage}
+% Imported documents may change the page number, which can then mess
+% up the numbering of later pages. The |colpage| counter is used
+% to synchronize the main document page numbering after any import.
+% To do this, it has to be incremented for each typeset page, so
+% this is added to the output routine (described in \file{ltoutput.dtx}).
+% This is done here in case any package in the main document has modified
+% |\@outputpage|, as the \Lpack{showframe} package does.
+% \changes{v0.4}{2000/05/27}{Moved the modification to \cs{@outputpage}
+% to within \cs{c@ladocument}}
+%
+% Similarly, the |\maketitle| command is made to be |\@clamaketitle| in case
+% some other package (e.g., \Lpack{titling}) has modified |\maketitle| after
+% the \Lpack{combine} class has done its thing.
+% \changes{v0.41}{2000/06/18}{Moved \cs{maketitle} letting to
+% \cs{c@lamaketitle} to inside \cs{c@ladocument}}
+% \begin{macrocode}
+ \g@addto@macro{\@outputpage}{\stepcounter{colpage}} %% added
+ \let\maketitle\c@lamaketitle %% added
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\c@lthechap}
+% \begin{macro}{\c@lthesec}
+% Store the initial forms of |\thechapter| or |\thesection| for later
+% restoration after a possible |\appendix|.
+% \changes{v0.51}{2001/07/05}{Added \cs{c@lthechap} and \cs{c@lthesec}}
+% \begin{macrocode}
+ \@ifundefined{c@chapter}% %% added
+ {\@ifundefined{c@section}{}{\let\c@lthesec\thesection}}%
+ {\let\c@lthechap\thechapter}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macrocode}
+ \let \@refundefined \relax
+ \let\AtBeginDocument\@firstofone
+ \@begindocumenthook
+ \ifdim\topskip<1sp\global\topskip 1sp\relax\fi
+ \global\@maxdepth\maxdepth
+%% \global\let\@begindocumenthook\@undefined
+ \ifx\@listfiles\@undefined
+ \global\let\@filelist\relax
+ \global\let\@addtofilelist\@gobble
+ \fi
+%% \gdef\do##1{\global\let ##1\@notprerr}%
+%% \@preamblecmds
+ \global\let \@nodocument \relax
+ \global\let\do\noexpand
+ \ignorespaces}
+
+% \end{macrocode}
+% For an imported document the \Lopt{layouts} option is implemented
+% in the |\document| command. The \Lpack{article},
+% \Lpack{report} and \Lpack{letter} classes all start of with the |plain|
+% page style, which is specified within the class file. When mixed classes
+% of imported documents are used the page style definitions can get
+% overwritten by the extra class(es). So, the revised |\document| command
+% resets the |plain| page style to the \Lpack{combine} class definition
+% and sets the initial page style to be |plain|.
+% \begin{macrocode}
+\newcommand{\c@lbdocument}{%
+%% \endgroup
+%% \ifx\@unusedoptionlist\@empty\else
+%% \@latex@warning@no@line{Unused global option(s):^^J%
+%% \@spaces[\@unusedoptionlist]}%
+%% \fi
+ \ifc@llayouts %% layouts option
+ \c@ltextblock
+ \fi
+ \begingroup\@floatplacement\@dblfloatplacement
+ \makeatletter \let\@writefile\@gobbletwo
+%% \global \let \@multiplelabels \relax
+ \@input{\c@lauxfile}%
+ \endgroup
+ \if@filesw
+ \immediate\openout\@partaux\c@lauxfile
+ \immediate\write\@partaux{\relax}%
+ \fi
+ \process@table
+ \let\glb@currsize\@empty
+ \normalsize
+ \everypar{}%
+ \@noskipsecfalse
+%% \let \@refundefined \relax
+ \let\AtBeginDocument\@firstofone
+ \@begindocumenthook
+ \ifdim\topskip<1sp\global\topskip 1sp\relax\fi
+ \global\@maxdepth\maxdepth
+%% \global\let\@begindocumenthook\@undefined
+ \ifx\@listfiles\@undefined
+ \global\let\@filelist\relax
+ \global\let\@addtofilelist\@gobble
+ \fi
+%% \gdef\do##1{\global\let ##1\@notprerr}%
+%% \@preamblecmds
+ \global\let \@nodocument \relax
+ \global\let\do\noexpand
+ \let\ps@plain\c@lbps@plain %% set pagestyle
+% \end{macrocode}
+% Setting |\pagestyle| here kills the use of any other style (e.g.,
+% a fancy style) in the imports\footnote{Problem discovered by Rumen
+% Bogdanovski (\texttt{rgb@libra.astro.bas.bg}) on 2001/04/03.}.
+% \changes{v0.41}{2001/04/04}{Eliminated page style setting for imports.}
+% \begin{macrocode}
+%% \pagestyle{plain}
+ \ifc@lfolios %% folios option initialises page number
+ \setcounter{page}{1}
+ \fi
+ \ifc@lhaschapter %% set chapter/section number
+ \setcounter{c@lctr}{\value{chapter}}
+ \setcounter{chapter}{0}
+ \else
+ \setcounter{c@lctr}{\value{section}}
+ \setcounter{section}{0}
+ \fi
+ \c@lresetcounters %% added
+ \makeatother %% added
+ \ignorespaces}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lresetcounters}
+% This sets various counters to zero, and is called at the beginning of
+% an imported document.
+% \changes{v0.4}{2000/05/27}{Added \cs{c@lresetcounters} and
+% \cs{zeroextracounters} commands}
+% \changes{v0.51}{2001/07/05}{Reset chapter/section format after possible \cs{appendix}}
+% \begin{macrocode}
+\newcommand{\c@lresetcounters}{%
+ \@ifundefined{c@figure}{}{\setcounter{figure}{0}}
+ \@ifundefined{c@table}{}{\setcounter{table}{0}}
+ \@ifundefined{c@equation}{}{\setcounter{equation}{0}}
+ \@ifundefined{c@footnote}{}{\setcounter{footnote}{0}}
+ \@ifundefined{c@chapter}%
+ {\@ifundefined{c@section}{}{\renewcommand{\thesection}{\c@lthesec}}}%
+ {\renewcommand{\thechapter}{\c@lthechap}}
+ \zeroextracounters
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\zeroextracounters}
+% This is a user-level macro that can be renewed to reset addtional
+% counters to zero at the beginning of an imported document.
+% \begin{macrocode}
+\newcommand{\zeroextracounters}{}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+%
+% The |\enddocument| command (defined in \file{ltmiscen.dtx}) has
+% to be modified for both the main and imported documents. The modifications
+% are minor, mainly concerned with handling the proper files.
+%
+% \begin{macro}{\c@lenddoca}
+% |\c@lenddoca| holds some code that is common to both |\c@laenddocument|
+% and |\c@lbenddocument|.
+% \changes{v0.3}{2000/05/20}{Added \cs{c@lenddoca} command}
+% \begin{macrocode}
+\newcommand{\c@lenddoca}{%
+ \@dofilelist
+ \ifdim \font@submax >\fontsubfuzz\relax
+ \@font@warning{Size substitutions with differences\MessageBreak
+ up to \font@submax\space have occured.\@gobbletwo}%
+ \fi
+ \@defaultsubs
+%% \@refundefined
+ \if@filesw
+ \ifx \@multiplelabels \relax
+ \if@tempswa
+ \@latex@warning@no@line{Label(s) may have changed.
+ Rerun to get cross-references right}%
+ \fi
+ \else
+ \@multiplelabels
+ \fi
+ \fi
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@laenddocument}
+% \begin{macro}{\c@lbenddocument}
+% \begin{macrocode}
+\newcommand{\c@laenddocument}{%
+ \@enddocumenthook
+ \@checkend{document}%
+ \clearpage
+ \begingroup
+ \if@filesw
+ \immediate\closeout\@mainaux
+ \immediate\closeout\@partaux
+ \let\@setckpt\@gobbletwo
+ \let\@newl@bel\@testdef
+ \@tempswafalse
+ \makeatletter \input\c@lmainauxfile %% change here
+ \fi
+ \c@lenddoca %% a replacement
+ \@refundefined
+ \endgroup
+ \deadcycles\z@\@@end}
+
+\newcommand{\c@lbenddocument}{%
+ \@enddocumenthook
+ \@checkend{document}%
+ \clearpage
+ \begingroup
+ \if@filesw
+ \immediate\closeout\@partaux %% change here
+ \let\@setckpt\@gobbletwo
+ \let\@newl@bel\@testdef
+ \@tempswafalse
+ \makeatletter \input\c@lauxfile %% change here
+ \fi
+ \c@lenddoca %% a replacement
+%% \@refundefined
+ \endgroup
+ \deadcycles\z@ %%\@@end %% \@@end will close *all* files
+ \c@lclosetocs %% close local files
+% \end{macrocode}
+% Reset sectional and page numbering. Also reset stuff to take account
+% of the possibily that |\appendix| was called.
+% \changes{v0.51}{2001/05/09}{Added reset of chapter name after appendix}
+% \begin{macrocode}
+ \ifc@lhaschapter %% reset chap/sec and page numbering
+ \setcounter{chapter}{\value{c@lctr}}
+ \gdef\thechapter{\c@lthechap}
+ \gdef\@chapapp{\chaptername}
+ \else
+ \setcounter{section}{\value{c@lctr}}
+ \gdef\thesection{\c@lthesec}
+ \fi
+ \setcounter{page}{\value{colpage}}
+ \pagestyle{\c@lastyle}
+ \erasetitling %% no \coltoc... or \published commands defined
+%% \let\@auxout\@mainaux
+ \gdef\jobname{\mainjobname} %% swap back to main document file name
+ \endinput %% ignore any text after \end{document}
+}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \subsection{Titling commands}
+%
+% Changes to |\maketitle| and friends are defined here.
+%
+% \begin{macro}{\maintitlefont}
+% \begin{macro}{\postmaintitle}
+% \begin{macro}{\mainauthorfont}
+% \begin{macro}{\postmainauthor}
+% \begin{macro}{\maindatefont}
+% \begin{macro}{\postmaindate}
+% To provide some flexibilty in the titling style of the main document,
+% user level commands are provided that can be changed to reconfigure
+% the appearance resulting from |\maketitle|. These are defined initially
+% to approximately mimic the normal \LaTeX{} style.
+% \changes{v0.3}{2000/05/20}{Added \cs{...main...} commands.}
+% \begin{macrocode}
+\newcommand{\maintitlefont}{\begin{center}\LARGE}
+\newcommand{\postmaintitle}{\par\end{center}\vskip 0.5em}
+\newcommand{\mainauthorfont}{\begin{center}
+ \large \lineskip .5em%
+ \begin{tabular}[t]{c}}
+\newcommand{\postmainauthor}{\end{tabular}\par\end{center}}
+\newcommand{\maindatefont}{\begin{center}\large}
+\newcommand{\postmaindate}{\par\end{center}}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lamaketitle}
+% The |\maketitle| command (defined by each class) must not incapacitate
+% several commands that it normally does (e.g., |\thanks|, |\maketitle|,
+% |\title|, |\author|, |\date|, and |\and|). The following is a
+% modification of |\maketitle| as in the \Lpack{article}, \Lpack{report},
+% and \Lpack{book} classes.
+% \changes{v0.3}{2000/05/20}{Revised maketitle-related commands.}
+% \begin{macrocode}
+\if@titlepage
+ \newcommand{\c@lamaketitle}{\begin{titlepage}%
+ \let\footnotesize\small
+ \let\footnoterule\relax
+ \let \footnote \thanks
+ \null\vfil
+ \vskip 60\p@
+ {\maintitlefont \@title \postmaintitle}
+ {\mainauthorfont \@author \postmainauthor}
+ {\maindatefont \@date \postmaindate}
+ \par
+ \@thanks
+ \vfil\null
+ \end{titlepage}%
+ \setcounter{footnote}{0}%
+ \c@lmtitlempty %% change here
+ } % end titlepage defs
+\else
+ \newcommand{\c@lamaketitle}{\par
+ \begingroup
+ \c@lmtitle %% change here
+ \endgroup
+ \setcounter{footnote}{0}%
+ \c@lmtitlempty %% change here
+ } % end non-titlepage
+
+% \end{macrocode}
+% I use |\def\@maketitle| to account for the cases where the main class
+% does not have titling commands, and to ensure an existing |\@maketitle|
+% gets overridden.
+% \begin{macrocode}
+
+ \def\@maketitle{%
+ \newpage
+ \null
+ \vskip 2em%
+ {\maintitlefont \@title \postmaintitle}
+ {\mainauthorfont \@author \postmainauthor}
+ {\maindatefont \@date \postmaindate}
+ \par
+ \vskip 1.5em}
+\fi % end mod A of titling
+
+% \end{macrocode}
+%
+% \begin{macro}{\c@lmtitle}
+% This macro contains much of the code that is common between
+% |\c@l@maketitle| and |\c@lbmaketitle|.
+% \begin{macrocode}
+\newcommand{\c@lmtitle}{%
+ \renewcommand\thefootnote{\@fnsymbol\c@footnote}%
+ \def\@makefnmark{\rlap{\@textsuperscript{\normalfont\@thefnmark}}}%
+ \long\def\@makefntext##1{\parindent 1em\noindent
+ \hb@xt@1.8em{%
+ \hss\@textsuperscript{\normalfont\@thefnmark}}##1}%
+ \if@twocolumn
+ \ifnum \col@number=\@ne
+ \@maketitle
+ \else
+ \twocolumn[\@maketitle]%
+ \fi
+ \else
+ \newpage
+ \global\@topnum\z@
+ \@maketitle
+ \fi
+ \thispagestyle{plain}\@thanks
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% The modification for imported documents is simpler as there seems no
+% point in allowing for a \Lopt{titlepage} option. Also, don't start
+% a new page for the title and use a local typesetting style.
+% \begin{macrocode}
+ \newcommand{\c@lbmaketitle}{\par
+ \begingroup
+ \let\newpage\relax
+ \let\@maketitle\c@lb@maketitle
+ \c@lmtitle
+ \endgroup
+ \setcounter{footnote}{0}%
+ \c@lmtitlempty
+ }
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lmtitlempty}
+% A helper macro to save some macro space.
+% It empties elements of |\maketitle|.
+% \begin{macrocode}
+\newcommand{\c@lmtitlempty}{%
+ \global\let\@thanks\@empty
+ \global\let\@author\@empty
+ \global\let\@date\@empty
+ \global\let\@title\@empty
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\importtitlefont}
+% \begin{macro}{\postimporttitle}
+% \begin{macro}{\importauthorfont}
+% \begin{macro}{\postimportauthor}
+% \begin{macro}{\importdatefont}
+% \begin{macro}{\postimportdate}
+% The fonts and layouts for use within |\maketitle| in imported documents.
+% \changes{v0.3}{2000/05/20}{Added \cs{...import...} commands.}
+% \begin{macrocode}
+\newcommand{\importtitlefont}{\begin{center}\LARGE\bfseries}
+\newcommand{\postimporttitle}{\par\end{center}}
+\newcommand{\importauthorfont}{\begin{center}
+ \large\itshape \lineskip .5em%
+ \begin{tabular}[t]{c}}
+\newcommand{\postimportauthor}{\end{tabular}\par\end{center}}
+\newcommand{\importdatefont}{\begin{center}\large}
+\newcommand{\postimportdate}{\par\end{center}}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lb@maketitle}
+% This typesets the title in an imported document. It also includes the
+% code for implementing the \Lopt{nodate}, \Lopt{notitle} and \Lopt{noauthor}
+% options. The vertical spacing is reduced slightly from normal.
+% The title and author texts are set with |\importtitlefont| and
+% |\importauthorfont| respectiveley. The date is set with |\importdatefont|.
+% \begin{macrocode}
+\newcommand{\c@lb@maketitle}{%
+%% \newpage
+ \begingroup
+ \let\footnote\thanks
+ \null
+ \vskip 2em%
+ \ifc@lnotitle\else
+ {\importtitlefont \@title \postimporttitle}
+ \fi
+ \ifc@lnoauthor\else
+ {\importauthorfont \@author \postimportauthor}
+ \fi
+ \ifc@lnodate\else
+ {\importdatefont \@date \postimportdate}%
+ \fi
+ \par
+ \endgroup
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{Cross referencing}
+%
+% This section deals with |\tableofcontents| and friends, together
+% with labeling, referencing and citations.
+%
+% \begin{macro}{\c@lbstarttoc}
+% The |\@starttoc| command (from \file{ltsect.dtx}) has to be modified
+% for imported documents so that a local ToC (LoF, LoT) file is used
+% instead of the one for the main document. I use a file identifier
+% of |c@l#1fnum| instead of the normal |tf@#1|.
+% \begin{macrocode}
+\newcommand{\c@lb@starttoc}[1]{%
+ \begingroup
+ \makeatletter
+ \def\tocfname{\jobname.#1}
+ \@input{\tocfname}%
+ \if@filesw
+% \end{macrocode}
+% The following tests are to check if we can use a predefined output stream
+% or have to allocate a new one (e.g., if a new list of floats hase been
+% defined).
+% \begin{macrocode}
+ \def\c@ltempa{#1} \def\c@ltempb{toc}
+ \ifx \c@ltempa \c@ltempb
+ \immediate\openout\c@ltocfnum \tocfname\relax
+ \else
+ \def\c@ltempb{lof}
+ \ifx \c@tempa \c@ltempb
+ \immediate\openout\c@lloffnum \tocfname\relax
+ \else
+ \def\c@ltempb{lot}
+ \ifx \c@tempa \c@ltempb
+ \immediate\openout\c@llotfnum \tocfname\relax
+ \else
+ \expandafter\newwrite\csname c@l#1fnum\endcsname
+ \immediate\openout\csname c@l#1fnum\endcsname \tocfname\relax
+ \fi
+ \fi
+ \fi
+ \fi
+ \@nobreakfalse
+ \endgroup}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbwritefile}
+% To go along with local ToC files, |\@writefile| (in \file{ltmiscen.dtx})
+% has to be modified to match. We also check if a local file exists before
+% writing to it.
+% \begin{macrocode}
+\newcommand{\c@lb@writefile}[2]{%
+ \def\tocfname{\jobname.#1}
+ \IfFileExists{\tocfname}
+ {\@temptokena{#2}%
+ \immediate\write\csname c@l#1fnum\endcsname{\the\@temptokena}}
+ {}
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lclosetocs}
+% At the end of each imported document, any local ToC, etc., files
+% must be closed.
+% \begin{macrocode}
+\newcommand{\c@lclosetocs}{%
+ \immediate\closeout\c@ltocfnum
+ \immediate\closeout\c@lloffnum
+ \immediate\closeout\c@llotfnum
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\c@ltocgobble}
+% A macro containing some common code for |\...addtocontents| commands.
+% \begin{macrocode}
+\newcommand{\c@ltocgobble}{%
+ \let\label\@gobble \let\index\@gobble \let\glossary\@gobble}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@laaddtocontents}
+% \begin{macro}{\c@laaddcontentsline}
+% It turns out to be useful to have versions of ToC addition commands
+% that go towards the main document.
+% \begin{macrocode}
+\newcommand{\c@laaddtocontents}[2]{%
+ \protected@write\@mainaux
+ {\c@ltocgobble}%
+ {\string\@writefile{#1}{#2}}
+}
+\newcommand{\c@laaddcontentsline}[3]{%
+ \c@laaddtocontents{#1}{\protect\contentsline{#2}{#3}{\thecolpage}}
+}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lbaddtocontents}
+% To implement the \Lopt{maintoc} option, we need a modification of
+% |\addtocontents| (in \file{ltsect.dtx}) so that it will write to
+% both the local and the main \file{.aux} files.
+% \begin{macrocode}
+\ifc@lmaintoc
+ \newcommand{\c@lbaddtocontents}[2]{%
+ \protected@write\@auxout
+ {\c@ltocgobble}%
+ {\string\@writefile{#1}{#2}}
+ \ifx\@mainaux\@auxout\else %% prevent writing twice to mainaux
+ \protected@write\@mainaux
+ {\c@ltocgobble}%
+ {\string\@writefile{#1}{\protect\begin{tocindent}{\toctocindent}}}
+ \protected@write\@mainaux
+ {\c@ltocgobble}%
+ {\string\@writefile{#1}{#2}}
+ \protected@write\@mainaux
+ {\c@ltocgobble}%
+ {\string\@writefile{#1}{\protect\end{tocindent}}}
+ \fi
+ }
+\fi
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lblabel}
+% \begin{macro}{\c@lb@setref}
+% To get the `correct' page number for labels in an imported
+% document, we have to use the global and not the local page number.
+% \begin{macrocode}
+\newcommand{\c@lblabel}[1]{\@bsphack
+ \protected@write\@auxout{}%
+ {\string\newlabel{#1}{{\@currentlabel}{\thecolpage}}}%
+ \@esphack}
+\newcommand{\c@lb@setref}[3]{%
+ \ifx#1\relax
+ \protect\G@refundefinedtrue
+ \nfss@text{\reset@font\bfseries ??}%
+ \@latex@warning{Reference `#3' on page \thecolpage \space
+ undefined}%
+ \else
+ \expandafter#2#1\null
+ \fi}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lbnewlabel}
+% \begin{macro}{\c@lbref}
+% \begin{macro}{\c@lpagebref}
+% For local labels and cross-references in an imported document,
+% special versions of
+% |\newlabel|, |\ref| and |\pageref| (in \file{ltxref.dtx}) are needed.
+% I use |\jobname| to distinguish identical labels in different imported
+% files.
+% \begin{macrocode}
+\newcommand{\c@lbnewlabel}{\@newl@bel{R?\jobname?}}
+\newcommand{\c@lbref}[1]{\expandafter\@setref\csname R?\jobname?@#1\endcsname
+ \@firstoftwo{#1}}
+\newcommand{\c@lbpageref}[1]{\expandafter\@setref\csname R?\jobname?@#1\endcsname
+ \@secondoftwo{#1}}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lwritemainbib}
+% \begin{macro}{\c@lwritelocalbib}
+% For citatations we may be writing to either the main bibliography
+% or to a local bibliography. For local bibliographies I use the
+% |\jobname| as a distinguishing characteristic.
+% \changes{v0.6}{2002/08/24}{Added \cs{c@lwritemainbib} and \cs{c@lwritelocalbib}}
+% \begin{macrocode}
+\newcommand{\c@lwritemainbib}{%
+ \if@filesw\immediate\write\@mainaux{\string\citation{\@citeb}}\fi
+ \@ifundefined{b@\@citeb}{\mbox{\reset@font\bfseries ?}%
+ \G@refundefinedtrue
+ \@latex@warning
+ {Citation `\@citeb' on page \thecolpage \space undefined}}%
+ {\hbox{\csname b@\@citeb\endcsname}}}
+\newcommand{\c@lwritelocalbib}{%
+ \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi
+ \@ifundefined{B?\jobname?@\@citeb}{\mbox{\reset@font\bfseries ?}%
+ \G@refundefinedtrue
+ \@latex@warning
+ {Citation `\@citeb' on page \thecolpage \space undefined}}%
+ {\hbox{\csname B?\jobname?@\@citeb\endcsname}}}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+%
+% \begin{macro}{\c@lanocite}
+% Slight mod to the kernel |\nocite| macro.
+% \changes{v0.6}{2002/08/24}{Added \cs{c@lanocite}}
+% \begin{macrocode}
+\newcommand{\c@lanocite}[1]{\@bsphack
+ \@for\@citeb:=#1\do{%
+ \edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \if@filesw\immediate\write\@mainaux{\string\citation{\@citeb}}\fi
+ \@ifundefined{b@\@citeb}{\G@refundefinedtrue
+ \@latex@warning{Citation `\@citeb' undefined}}{}}%
+ \@esphack}
+\let\nocite\c@lanocite
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbnocite}
+% Need another version of |\nocite| for imports.
+% \changes{v0.6}{2002/08/24}{Added \cs{c@lbnocite}}
+% \begin{macrocode}
+\newcommand{\c@lbnocite}[1]{\@bsphack
+ \@for\@citeb:=#1\do{%
+ \edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi
+ \@ifundefined{B?\jobname?@\@citeb}{\G@refundefinedtrue
+ \@latex@warning{Citation `\@citeb' undefined}}{}}%
+ \@esphack}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lb@citex}
+% \begin{macro}{\c@lbbibcite}
+% For local citations in an imported document, special versions of
+% |\@citex| and |\bibcite| (in \file{ltbibl.dtx}) are needed. I use
+% the |\jobname| as a means of distinguishing between identical citation
+% labels in different imported files.
+% \changes{v0.6}{2002/08/24}{Added code for bib options to \cs{c@lbbibcite}}
+% \begin{macrocode}
+\def\c@lb@citex[#1]#2{%
+ \ifc@lcombib
+ \c@lanocite{#2}%
+ \fi
+ \let\@citea\@empty
+ \@cite{\@for\@citeb:=#2\do
+ {\@citea\def\@citea{,\penalty\@m\ }%
+ \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}%
+ \ifc@lcombib
+ \c@lwritelocalbib
+ \else
+ \ifc@lonebib
+ \c@lwritemainbib
+ \else
+ \c@lwritelocalbib
+ \fi
+ \fi}}{#1}}
+
+\ifc@lonebib
+ \newcommand{\c@lbbibcite}{\@newl@bel b}
+ \ifc@lcombib
+ \renewcommand{\c@lbbibcite}{\@newl@bel{B?\jobname?}}
+ \fi
+\else
+ \newcommand{\c@lbbibcite}{\@newl@bel{B?\jobname?}}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+%
+% \subsection{Page styles and numbering}
+%
+% \begin{macro}{\c@lapagestyle}
+% \begin{macro}{\c@lastyle}
+% \begin{macro}{\c@lbpagestyle}
+% I want to be able to restore the main document pagestyle after an
+% import. The current main pagestyle is kept in |\c@lastyle| which is
+% defined by |\c@lapagestyle| (original in \file{ltpage.dtx}).
+% \changes{v0.41}{2001/04/04}{Changed c@lstyle to \cs{c@lastyle} (two places)}
+% \begin{macrocode}
+\newcommand{\c@lapagestyle}[1]{%
+ \gdef\c@lastyle{#1}
+ \@ifundefined{ps@#1}{}{\@nameuse{ps@#1}}
+}
+% \end{macrocode}
+% |\c@lbpagestyle| is the same as the kernel |\pagestyle|, except for some
+% reason \LaTeX{} complains that the original command |\undefinedpagestyle|
+% is undefined!
+% \begin{macrocode}
+\newcommand{\c@lbpagestyle}[1]{%
+ \@ifundefined{ps@#1}{}{\@nameuse{ps@#1}}
+}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lbpagenumbering}
+% Need to do something about changing the page numbering in imported
+% documents, as it can have an unfortunate impact on later numbering.
+% The original command is in \file{ltpageno.dtx}. Disable changing
+% the style of the page number unless the \Lopt{folios} option is in effect.
+% \begin{macrocode}
+\ifc@lfolios
+ \newcommand{\c@lbpagenumbering}[1]{%
+ \global\c@page \@ne \gdef\thepage{\csname @#1\endcsname
+ \c@page}}
+\else
+ \newcommand{\c@lbpagenumbering}[1]{}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@laps@plain}
+% \begin{macro}{\c@lbps@plain}
+% Alternative definitions for the |plain| pagestyle.
+% \begin{macrocode}
+\if@twoside
+ \newcommand{\c@laps@plain}{%
+ \let\@mkboth\@gobbletwo
+ \let\@oddhead\@empty \let\@evenhead\@empty
+ \def\@oddfoot{\reset@font\hfil\thepage}%
+ \def\@evenfoot{\reset@font\thepage\hfil}%
+ }
+ \ifc@lfolios
+ \newcommand{\c@lbps@plain}{%
+ \let\@mkboth\@gobbletwo
+ \let\@oddhead\@empty \let\@evenhead\@empty
+ \def\@oddfoot{\reset@font(\thepage)\hfil\thecolpage}%
+ \def\@evenfoot{\reset@font\thecolpage\hfil(\thepage)}%
+ }
+ \else
+ \newcommand{\c@lbps@plain}{%
+ \let\@mkboth\@gobbletwo
+ \let\@oddhead\@empty \let\@evenhead\@empty
+ \def\@oddfoot{\reset@font\hfil\thecolpage}%
+ \def\@evenfoot{\reset@font\thecolpage\hfil}%
+ }
+ \fi
+\else
+ \newcommand{\c@laps@plain}{%
+ \let\@mkboth\@gobbletwo
+ \let\@oddhead\@empty \let\@evenhead\@empty
+ \def\@oddfoot{\reset@font\hfil\thepage}%
+ \let\@evenfoot\@oddfoot
+ }
+ \ifc@lfolios
+ \newcommand{\c@lbps@plain}{%
+ \let\@mkboth\@gobbletwo
+ \let\@oddhead\@empty \let\@evenhead\@empty
+ \def\@oddfoot{\reset@font(\thepage)\hfil\thecolpage}%
+ \let\@evenfoot\@oddfoot
+ }
+ \else
+ \newcommand{\c@lbps@plain}{%
+ \let\@mkboth\@gobbletwo
+ \let\@oddhead\@empty \let\@evenhead\@empty
+ \def\@oddfoot{\reset@font\hfil\thecolpage}%
+ \let\@evenfoot\@oddfoot
+ }
+ \fi
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \section{New class commands}
+%
+% That completes the preliminaries. We can now move on and define the
+% new commands and environment implemented by the \Lpack{combine} class.
+%
+% \begin{macro}{\ps@combine}
+% A new pagestyle. Like |plain| but the page numbers are put at
+% a bottom corner instead of being centered. It also changes the
+% the |plain| style to match.
+% \begin{macrocode}
+\if@twoside
+ \newcommand{\ps@combine}{%
+ \let\@mkboth\@gobbletwo
+ \let\@oddhead\@empty \let\@evenhead\@empty
+ \def\@oddfoot{\reset@font\hfil\thepage}%
+ \def\@evenfoot{\reset@font\thepage\hfil}%
+ \let\ps@plain\c@laps@plain
+ }
+\else
+ \newcommand{\ps@combine}{%
+ \let\@mkboth\@gobbletwo
+ \let\@oddhead\@empty \let\@evenhead\@empty
+ \def\@oddfoot{\reset@font\hfil\thepage}%
+ \let\@evenfoot\@oddfoot
+ \let\ps@plain\c@laps@plain
+ }
+\fi
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\import}
+% |\import{|\meta{texfile}|}| attempts to find and input the file
+% \meta{texfile}\texttt{.tex}. It is very loosely based on |\include|.
+% It also adds the |\coltoctitle|, etc., to the ToC in a useful
+% order\footnote{This need pointed out by Stefan Becuwe
+% (\texttt{Stefan.Becuwe@ua.ac.be}) by Email on 2001/07/09.}.
+% \changes{v0.51}{2001/07/09}{\cs{import} adds coltoctitle, etc., to the ToC}
+% \changes{v0.53}{2001/09/05}{Added empty \cs{numberline} to title in ToC}
+% \begin{macrocode}
+\newcommand{\import}[1]{%
+ \ifc@ltoctitle
+ \addtocontents{toc}{\protect\contentsline{coltoctitle}%
+ {\protect\numberline{}\savec@ltoctitle}{\thecolpage}}
+ \c@ltoctitlefalse
+ \fi
+ \ifc@ltocauthor
+ \addcontentsline{toc}{coltocauthor}{\protect\numberline{}\savec@ltocauthor}
+ \c@ltocauthorfalse
+ \fi
+ \ifc@lpub
+ \addcontentsline{toc}{published}{\protect\numberline{}\savec@lpublished}
+ \c@lpubfalse
+ \fi
+ \gdef\jobname{#1}
+% \end{macrocode}
+% \changes{v0.6}{2002/08/24}{Added empty definition for nocite{*}
+% handling to \cs{import}}
+% \begin{macrocode}
+ \expandafter\let\csname B?\jobname?@*\endcsname\@empty
+ \gdef\c@lauxfile{#1.aux}
+ \@tempswatrue
+ \let\@auxout\@partaux
+ \@input@{#1.tex}%
+%% \@writeckpt{#1}%
+ \let\@auxout\@mainaux
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\bodytitlemark}
+% \begin{macro}{\bodytitle}
+% |\bodytitle[|\meta{short}|]{|\meta{long}|}| is for putting a sectional
+% title into the main document for the following imported document. It is
+% like a |\section| (or |\chapter|) command and has its own numbering scheme.
+% \begin{macrocode}
+\newcommand*\bodytitlemark[1]{}
+\newcounter{bodytitle}
+\renewcommand{\thebodytitle}{\@arabic\c@bodytitle}
+\ifc@lhaschapter
+ \newcommand{\bodytitle}{\@startsection{bodytitle}{0}{\z@}%
+ {-3.5ex \@plus -1ex \@minus -.2ex}%
+ {2.3ex \@plus.2ex}%
+ {\normalfont\Huge\bfseries}}
+\else
+ \newcommand{\bodytitle}{\@startsection{bodytitle}{1}{\z@}%
+ {-3.5ex \@plus -1ex \@minus -.2ex}%
+ {2.3ex \@plus.2ex}%
+ {\normalfont\Large\bfseries}}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@ll@chapseci}
+% \begin{macro}{\c@ll@chapsecii}
+% These are two helper macros that contain common code used for
+% some of the ToC typesetting commands that will be defined. Essentially
+% they hold the first and second quarter of the code for ToC typesetting
+% of chapters and sections.
+% \begin{macrocode}
+\newcommand{\c@ll@chapseci}{%
+% \setlength\@tempdima{1.5em}%
+ \setlength\@tempdima{0em}%
+ \begingroup
+ \parindent \z@ \rightskip \@pnumwidth
+ \parfillskip -\@pnumwidth
+ \leavevmode
+}
+\newcommand{\c@ll@chapsecii}[2]{%
+ \advance\leftskip\@tempdima
+ \hskip -\leftskip
+ #1\nobreak\hfil \nobreak\hb@xt@\@pnumwidth{\hss #2}\par
+}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\l@bodytitle}
+% |\l@bodytitle| typesets the ToC entry for |\bodytitle|.
+% \begin{macrocode}
+\ifc@lhaschapter
+ \newcommand*\l@bodytitle[2]{% % as per chapter
+ \ifnum \c@tocdepth >\m@ne
+ \addpenalty{-\@highpenalty}%
+ \addvspace{1.0em \@plus\p@}%
+ \c@ll@chapseci
+ \bfseries %% bold ToC entry
+ \c@ll@chapsecii{#1}{#2}
+ \penalty\@highpenalty
+ \endgroup
+ \fi}
+\else
+ \newcommand*\l@bodytitle[2]{% % as per section
+ \ifnum \c@tocdepth >\z@
+ \addpenalty\@secpenalty
+ \addvspace{1.0em \@plus\p@}%
+ \c@ll@chapseci
+ \bfseries %% bold ToC entry
+ \c@ll@chapsecii{#1}{#2}
+ \endgroup
+ \fi}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\toctitleindent}
+% \begin{macro}{\tocauthorindent}
+% \begin{macro}{\tocpubindent}
+% \begin{macro}{\toctocindent}
+% These lengths control the indentations of the imported title, author,
+% published, and sectional headings in the main ToC.
+% \begin{macrocode}
+\newlength{\toctitleindent}\setlength{\toctitleindent}{0pt}
+\newlength{\tocauthorindent}\setlength{\tocauthorindent}{1.5em}
+\newlength{\tocpubindent}\setlength{\tocpubindent}{1.5em}
+\newlength{\toctocindent}\setlength{\toctocindent}{1.5em}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{environment}{tocindent}
+% The |tocindent| environment is used to set the various main ToC indents.
+% \begin{macrocode}
+\newenvironment{tocindent}[1]{%
+ \hangindent #1 \hangafter -100\relax}{}
+
+% \end{macrocode}
+% \end{environment}
+%
+% \begin{macro}{\toctitlefont}
+% \begin{macro}{\tocauthorfont}
+% \begin{macro}{\tocpubfont}
+% These macros define the fonts to be used for typesetting the title,
+% author and publication entries in the main ToC.
+% \begin{macrocode}
+\newcommand{\toctitlefont}{\bfseries}
+\newcommand{\tocauthorfont}{\itshape}
+\newcommand{\tocpubfont}{\normalfont}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\coltoctitle}
+% \begin{macro}{\l@coltoctitle}
+% |\coltoctitle{|\meta{title}|}| adds \meta{title} to the ToC for the
+% following imported document. The ToC entry is typeset by |\l@coltoctitle|.
+% \changes{v0.51}{2001/07/09}{Save the value of \cs{coltoctitle}}
+% \begin{macrocode}
+\newcommand*{\coltoctitle}[1]{%
+ \c@ltoctitletrue%
+ \gdef\savec@ltoctitle{#1}
+}
+
+% \end{macrocode}
+%
+% We want to arrange it so that if the title is near the bottom of a
+% page in the ToC, have the pagebreak before rather than after the title.
+% \changes{v0.42}{2001/04/04}{Changed pagebreak penalties in \cs{l@coltoctitle}}
+% \changes{v0.53}{2001/09/05}{Fixed extraneous space in \cs{l@coltoctitle}}
+% \begin{macrocode}
+\ifc@lhaschapter
+ \newcommand*\l@coltoctitle[2]{% % as per chapter
+ \ifnum \c@tocdepth >\m@ne
+ \addpenalty{-\@highpenalty}% encourage page break
+ \addvspace{1.0em \@plus\p@}%
+ \c@ll@chapseci
+ \setlength{\@tempdima}{\toctitleindent}% eliminate any spaces here
+ \toctitlefont %% bold ToC entry
+ \c@ll@chapsecii{#1}{#2}
+ \penalty\@highpenalty % discourage page break
+ \endgroup
+ \fi}
+\else
+ \newcommand*\l@coltoctitle[2]{% % as per section
+ \ifnum \c@tocdepth >\z@
+ \addpenalty\@secpenalty
+ \addvspace{1.0em \@plus\p@}%
+ \c@ll@chapseci
+ \setlength{\@tempdima}{\toctitleindent}% eliminate any spaces here
+ \toctitlefont %% bold ToC entry
+ \c@ll@chapsecii{#1}{#2}
+ \penalty\@highpenalty % discourage page break
+ \endgroup
+ \fi}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\coltocauthor}
+% \begin{macro}{\l@coltocauthor}
+% |\coltocauthor{|\meta{authors}|}| adds \meta{authors} to the ToC for the
+% following imported document. The ToC entry is typeset by |\l@coltocauthor|.
+% Note that a page number is not printed.
+% \changes{v0.51}{2001/07/09}{Save value of \cs{coltocauthor}}
+% \begin{macrocode}
+\newcommand*{\coltocauthor}[1]{%
+ \c@ltocauthortrue%
+ \gdef\savec@ltocauthor{#1}
+}
+
+% \end{macrocode}
+% As it is unlikely that the author will be in the ToC without the title,
+% don't encourage a page break beforehand.
+% \changes{v0.42}{2001/04/04}{Changed pagebreak penalties in \cs{l@coltocauthor}}
+% \changes{v0.53}{2001/09/05}{Fixed extraneous space in \cs{l@coltocauthor}}
+%
+% \begin{macrocode}
+\ifc@lhaschapter
+ \newcommand*\l@coltocauthor[2]{% % similar to chapter
+ \ifnum \c@tocdepth >\m@ne
+ \c@ll@chapseci
+ \setlength{\@tempdima}{\tocauthorindent}% eliminate any spaces here
+ \tocauthorfont %% italic ToC entry
+ \c@ll@chapsecii{#1}{}
+ \penalty\@highpenalty % discourage page break
+ \endgroup
+ \fi}
+\else
+ \newcommand*\l@coltocauthor[2]{% % similar to section
+ \ifnum \c@tocdepth >\z@
+ \c@ll@chapseci
+ \setlength{\@tempdima}{\tocauthorindent}% eliminate any spaces here
+ \tocauthorfont %% italic ToC entry
+ \c@ll@chapsecii{#1}{}
+ \penalty\@highpenalty % discourage page break
+ \endgroup
+ \fi}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\published}
+% \begin{macro}{\pubfont}
+% \begin{macro}{\l@published}
+% |\published[|\meta{short}|]{|\meta{long}|}| adds \meta{long} to the
+% body of the document. It also adds \meta{long} to the ToC, unless the
+% optional argument is present, in which case \meta{short} is added
+% to the ToC.
+%
+% In the body of the document \meta{long} is typeset using |\pubfont|.
+% The ToC entry is typeset by |\l@published|.
+% Note that a page number is not printed.
+% \changes{v0.51}{2001/07/09}{Save value of \cs{published}}
+% \begin{macrocode}
+\newcommand{\published}[2][\@empty]{%
+ \c@lpubtrue
+ \ifc@lnopubintoc\else
+ \ifx #1\@empty
+ \gdef\savec@lpublished{#2}
+ \else
+ \gdef\savec@lpublished{#1}
+ \fi
+ \fi
+ \ifc@lnopubindoc\else
+ {\parindent \z@ \pubfont #2\par\nobreak}
+ \fi
+}
+\newcommand{\pubfont}{\normalfont\centering}
+
+% \end{macrocode}
+% As the published information is unlikely to be in the ToC without
+% prior title or author information, don't encourage a prior break,
+% but also don't try and prevent one afterwards either.
+% \changes{v0.42}{2001/04/04}{Changed pagebreak penalties in \cs{l@published}}
+% \changes{v0.53}{2001/09/05}{Fixed extraneous space in \cs{l@published}}
+%
+% \begin{macrocode}
+\ifc@lhaschapter
+ \newcommand*\l@published[2]{% % similar to chapter
+ \ifnum \c@tocdepth >\m@ne
+ \c@ll@chapseci
+ \setlength{\@tempdima}{\tocpubindent}% eliminate any spaces here
+ \tocpubfont %% normal font ToC entry
+ \c@ll@chapsecii{#1}{}
+ \endgroup
+ \fi}
+\else
+ \newcommand*\l@published[2]{% % similar to section
+ \ifnum \c@tocdepth >\z@
+ \c@ll@chapseci
+ \setlength{\@tempdima}{\tocpubindent}% eliminate any spaces here
+ \tocpubfont %% normal font ToC entry
+ \c@ll@chapsecii{#1}{}
+ \endgroup
+ \fi}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\erasetitling}
+% This macro sets the |\coltoctitle|, |\coltocauthor| and |\published|
+% flags to FALSE.
+% \begin{macrocode}
+\newcommand{\erasetitling}{\c@ltoctitlefalse\c@ltocauthorfalse\c@lpubfalse}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{environment}{papers}
+% The |papers| environment has one optional argument,
+% default |\cleardoublepage| which gets executed at the start of the
+% environment. Then the appropriate changes to the kernel commands are
+% executed.
+% \begin{macrocode}
+\newenvironment{papers}[1][\cleardoublepage]{%
+#1
+\setuppapers
+}{%
+\takedownpapers
+}
+
+% \end{macrocode}
+% \end{environment}
+%
+% \begin{macro}{\setuppapers}
+% This macro executes the kernel modifications within the |papers|
+% environment. Various options are also checked and implemented if required.
+% Sectional numbering is reset to zero. Imported files can't |\include|
+% other files, so |\include| is replaced by |\input|. If |\chapter| is
+% defined, then the chapter typesetting is redefined to look more like
+% a |\section| heading.
+% \changes{v0.41}{2000/06/18}{\cs{def}ed \cs{maketitle} instead of \cs{let}ing
+% inside \cs{setuppapers} to ignore any titling package redefinitions}
+% \changes{v0.52}{2001/08/25}{Added \cs{c@lbLoadClass} to \cs{setuppapers}}
+% \changes{v0.6}{2002/08/24}{Added onebib and combinedbib options code to \cs{setuppapers}}
+% \changes{v0.62}{2003/06/30}{Left \cs{bibliographystyle} unaltered}.
+% \begin{macrocode}
+\newcommand{\setuppapers}{%
+\let\documentclass\c@lbdocumentclass
+\ifc@lpackages\else \let\usepackage\c@lbusepackage \fi
+\let\document\c@lbdocument
+\let\enddocument\c@lbenddocument
+\let\LoadClass\c@lbLoadClass
+%% \let\maketitle\c@lbmaketitle
+\def\maketitle{\c@lbmaketitle}
+\let\@writefile\c@lb@writefile
+\let\@starttoc\c@lb@starttoc
+\ifc@lnomaketitle \let\maketitle\relax \fi
+\ifc@lnotoc \let\tableofcontents\relax \fi
+\ifc@lnolof \let\listoffigures\relax \fi
+\ifc@lnolot \let\listoftables\relax \fi
+\ifc@lmaintoc \let\addtocontents\c@lbaddtocontents \fi
+\let\label\c@lblabel
+\let\@setref\c@lb@setref
+\let\newlabel\c@lbnewlabel
+\let\ref\c@lbref
+\let\pageref\c@lbpageref
+%%% \renewcommand{\bibliographystyle}[1]{}
+\ifc@lcombib
+\else
+ \ifc@lonebib
+ \renewcommand{\bibliography}[1]{}
+ \fi
+\fi
+\let\@citex\c@lb@citex
+\let\bibcite\c@lbbibcite
+\let\nocite\c@lbnocite
+\ifc@lhaschapter
+ \renewcommand{\chapter}{\@startsection{chapter}{0}{\z@}%
+ {-3.5ex \@plus -1ex \@minus -.2ex}%
+ {2.3ex \@plus.2ex}%
+ {\normalfont\Large\bfseries}}
+\fi
+\c@ltoctitlefalse
+\c@ltocauthorfalse
+\c@lpubfalse
+\let\pagenumbering\c@lbpagenumbering
+\setcounter{colpage}{\value{page}}
+\let\pagestyle\c@lbpagestyle
+\pagestyle{\c@lastyle}
+\let\include\input
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\takedownpapers}
+% This macro executes the actions, if any, at the end of the |papers|
+% environment.
+% \begin{macrocode}
+\newcommand{\takedownpapers}{%
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\emptyAtBeginDocument}
+% This macro empties tokens stored for use at |\begin{document}| time.
+% \changes{v0.51}{2003/07/17}{Added \cs{emptyAtBeginDocument}}
+% \begin{macrocode}
+\newcommand{\emptyAtBeginDocument}{\let\@begindocumenthook\@empty}
+
+% \end{macrocode}
+% \end{macro}
+%
+% Finally, use the appropriate revised kernel commands for the main document.
+% \changes{v0.41}{2000/06/18}{Moved main document \cs{maketitle} letting to
+% its begin document}
+% \begin{macrocode}
+\let\document\c@ladocument
+\let\enddocument\c@laenddocument
+%%\let\maketitle\c@lamaketitle
+\let\pagestyle\c@lapagestyle
+\pagestyle{combine}
+
+% \end{macrocode}
+%
+%
+%
+%
+% The end of this class.
+% \begin{macrocode}
+%</usc>
+% \end{macrocode}
+%
+% \section{The \Lpack{combinet} package code} \label{packcode}
+%
+%
+% \begin{macrocode}
+%<*pck>
+% \end{macrocode}
+% The usual preliminaries. The \Lpack{combine} class is expected.
+% \changes{v0.53}{2001/09/05}{combinet package now version 0.2}
+% \changes{v0.64}{2004/03/06}{combinet package now version 0.2a}
+% \begin{macrocode}
+\@ifclassloaded{combine}{}{%
+ \PackageError{combinet}{The `combine' class is expected}{\@ehc}%
+}
+
+% \end{macrocode}
+%
+% \begin{macro}{\ifc@lnomtitle}
+% \begin{macro}{\ifc@lnomauthor}
+% \begin{macro}{\ifc@lnothanks}
+% \begin{macro}{\ifc@lpubopt}
+% \begin{macro}{\ifc@lpubtop}
+% \begin{macro}{\ifc@lpubs}
+% Booleans for implementing the options.
+% \begin{macrocode}
+\newif\ifc@lnomtitle
+ \c@lnomtitlefalse
+\newif\ifc@lnomauthor
+ \c@lnomauthorfalse
+\newif\ifc@lnothanks
+ \c@lnothanksfalse
+\newif\ifc@lpubopt
+ \c@lpuboptfalse
+\newif\ifc@lpubtop
+ \c@lpubtopfalse
+\newif\ifc@lpubs
+ \c@lpubsfalse
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% Declare and execute the options.
+% \begin{macrocode}
+\DeclareOption{nomtitle}{\c@lnomtitletrue}
+\DeclareOption{nomauthor}{\c@lnomauthortrue}
+\DeclareOption{nothanks}{\c@lnothankstrue}
+\DeclareOption{pub}{\c@lpubopttrue\c@lpubtopfalse\c@lpubstrue}
+\DeclareOption{pubtop}{\c@lpubtoptrue\c@lpuboptfalse\c@lpubstrue}
+\ProcessOptions\relax
+
+% \end{macrocode}
+%
+% \begin{macro}{\published}
+% \begin{macro}{\c@lpubtoc}
+% \begin{macro}{\c@lpubbody}
+% In order to implement either of the \Lopt{pub} options, the |\published|
+% command must be modified to delay printing.
+% \begin{macrocode}
+\ifc@lpubs
+ \renewcommand{\published}[2][\@empty]{%
+ \c@lpubtrue
+ \ifx #1\@empty
+ \gdef\c@lpubtoc{#2}
+ \else
+ \gdef\c@lpubtoc{#1}
+ \fi
+ \gdef\c@lpubbody{#2}
+ }
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\title}
+% \begin{macro}{\author}
+% To implement the \Lopt{nothanks} option, the |\title| and |\author|
+% kernel commands must be extended to save their values.
+%
+% Originally I used |\xdef| below which worked unless there was some
+% command other than |\thanks| in the title or author text.
+% David Kastrup\footnote{At \texttt{dak@neuroinformatik.ruhr-uni-bochum.de}.}
+% and Donald Arseneau\footnote{At \texttt{asnd@triumf.ca}.}
+% both pointed out the use of |\protected@xdef|.
+% Barbara Beeton\footnote{\texttt{bnb@ams.org}} suggested adding the |\unskip|
+% to the redefinition of |\and| in order to remove any preceeding spaces when
+% it gets printed in the ToC.
+% \changes{v0.4}{2000/06/09}{Added \cs{unskip} to \cs{and} redefinition}
+% \changes{v0.41}{2000/06/18}{Appended to \cs{title} and \cs{author} definitions}
+% \begin{macrocode}
+\appendiargdef{\title}{%
+ \begingroup
+ \renewcommand{\thanks}[1]{}
+ \protected@xdef\c@l@title{#1}
+ \endgroup
+}
+\appendiargdef{\author}{%
+ \begingroup
+ \renewcommand{\thanks}[1]{}
+ \renewcommand{\and}{\unskip, }
+ \protected@xdef\c@l@author{#1}
+ \endgroup
+}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lbmaketitle}
+% The |\c@lbmaketitle| command is (re)defined so that it adds the title
+% and author (if given) to the main ToC. If |\coltoctitle| and/or
+% |\coltocauthor| have been used then nothing is done with the title
+% and/or author respectively.
+% \changes{v0.53}{2001/09/05}{Added empty \cs{numberline} in \cs{c@lbmaketitle}}
+% \changes{v0.64}{2004/03/06}{Changed \cs{c@laaddtocontents} for titles to
+% \cs{c@laaddcontentsline} in \cs{c@lbmaketitle}}
+% \begin{macrocode}
+\def\c@lbmaketitle{\par
+ \begingroup
+ \let\newpage\relax
+ \let\@maketitle\c@lb@maketitle
+ \ifc@lpub
+ \ifc@lpubtop
+ \ifc@lnopubindoc\else
+ {\parindent\z@ \pubfont \c@lpubbody\par\nobreak}
+ \fi
+ \fi
+ \fi
+ \c@lmtitle %% typeset the title block
+ \endgroup
+ \setcounter{footnote}{0}
+ \begingroup
+ \let\thanks\@empty
+ \ifc@ltoctitle\else
+ \ifc@lnomtitle\else
+ \ifx\@title\@empty\else
+ \ifc@lnothanks
+% \end{macrocode}
+% I originally used
+% \begin{verbatim}
+% \c@laaddtocontents{toc}%
+% {\protect\contentsline{coltoctitle}%
+% {\protect\numberline{}\c@l@title}{\thecolpage}}
+% \end{verbatim}
+% below, but James Szinger\footnote{Email, 2004/03/05, \texttt{szinger@lanl.gov}}
+% asked me to change to \verb?\c@laaddcontentsline? instead
+% (which I should have done, looking back I've no idea why I didn't) to help
+% with using hyperref, which he said required redefining
+% \verb?\c@laaddcontentsline? to be compatible with hyperref's (hyperref never
+% seems to bother with trying to be compatible with other classes though).
+% \begin{macrocode}
+ \c@laaddcontentsline{toc}%
+ {coltoctitle}{\protect\numberline{}\c@l@title}%
+ \else
+ \c@laaddcontentsline{toc}%
+ {coltoctitle}{\protect\numberline{}\@title}%
+ \fi
+ \fi
+ \fi
+ \fi
+ \ifc@ltocauthor\else
+ \ifc@lnomauthor\else
+ \ifx\@author\@empty\else
+ \ifc@lnothanks
+ \c@laaddcontentsline{toc}%
+ {coltocauthor}{\protect\numberline{}\c@l@author}
+ \else
+ \c@laaddcontentsline{toc}%
+ {coltocauthor}{\protect\numberline{}\@author}
+ \fi
+ \fi
+ \fi
+ \fi
+ \endgroup
+ \ifc@lpub
+ \ifc@lpubopt
+ \ifc@lnopubindoc\else
+ {\parindent\z@ \pubfont \c@lpubbody\par\nobreak}
+ \fi
+ \fi
+ \ifc@lpubs
+ \ifc@lnopubintoc\else
+ \c@laaddcontentsline{toc}{published}{\protect\numberline{}\c@lpubtoc}
+ \fi
+ \fi
+ \fi
+ \c@lmtitlempty
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+% The end of this package
+% \begin{macrocode}
+%</pck>
+% \end{macrocode}
+%
+%
+% \section{The \Lpack{combnat} package code} \label{natpackcode}
+%
+% This package calls the \Lpack{natbib} package~\cite{NATBIB}
+% and then makes some minor changes to some of its macro definitions.
+% \changes{v0.6}{2002/08/24}{Added onebib option processing to combnat package}
+%
+% \begin{macrocode}
+%<*natpack>
+% \end{macrocode}
+% The usual preliminaries. The \Lpack{natbib} package is required
+% and all options are passed to it to deal with.
+% \changes{v0.5}{2001/07/03}{Added the combnat package}
+% \changes{v0.6}{2002/08/24}{Added combine class check to the combnat package}
+% \changes{v0.6}{2002/08/24}{combnat package is now version 0.2}
+% \changes{v0.61}{2003/05/22}{combnat package is now version 0.21}
+% \changes{v0.61}{2003/05/22}{Somehow removed extraneous space from combnat package}
+% \changes{v0.7}{2010/03/22}{combnat bug fix thanks to Nicola Talbot}
+% \begin{macrocode}
+\@ifclassloaded{combine}{}{%
+ \PackageError{combnat}{The `combine' class is expected}{\@ehc}}
+\RequirePackageWithOptions{natbib}
+% \end{macrocode}
+%
+% For multiple bibliographies (|\c@lonebibfalse|)
+% the change consists of replacing
+% \Lpack{natbib}'s
+% naming of citation labels in the \file{.aux} files by the form
+% used by the \Lpack{combine} class. That is, the |b@| in each
+% code fragment like |b@#...| or |b@\...| is replaced by
+% |B?\jobname?@...|.
+%
+% For a single main bibliography |\c@lonebibtrue|, implementation is much
+% easier, merely ensuring that the stuff gets written to the main
+% *.aux file.
+%
+%
+% \begin{macro}{\c@lNATwritemainbib}
+% \begin{macro}{\c@lNATwritemainbibdate}
+% We have to write different biblabels to different files. These write
+% to the main *.aux file.
+% \begin{macrocode}
+\newcommand{\c@lNATwritemainbib}{%
+ \if@filesw\immediate\write\@mainaux{\string\citation{\@citeb}}\fi
+ \@ifundefined{b@\@citeb\@extra@b@citeb}{%
+ {\reset@font\bfseries?}
+ \NAT@citeundefined\PackageWarning{natbib}%
+ {Citation `\@citeb' on page \thepage \space undefined}}}
+
+\newcommand{\c@lNATwritemainbibdate}{%
+ \if@filesw\immediate\write\@mainaux{\string\citation{\@citeb}}\fi
+ \@ifundefined{b@\@citeb\@extra@b@citeb}{\@citea%
+ {\reset@font\bfseries ?}\NAT@citeundefined
+ \PackageWarning{natbib}%
+ {Citation `\@citeb' on page \thepage \space undefined}
+ \def\NAT@date{}}}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lNATwritelocalbib}
+% \begin{macro}{\c@lNATwritelocalbibdate}
+% We have to write different biblabels to different files. These write
+% to the local *.aux files.
+% \begin{macrocode}
+\newcommand{\c@lNATwritelocalbib}{%
+ \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi
+ \@ifundefined{B?\jobname?@\@citeb\@extra@b@citeb}{%
+ {\reset@font\bfseries?}
+ \NAT@citeundefined\PackageWarning{natbib}%
+ {Citation `\@citeb' on page \thepage \space undefined}}}
+
+\newcommand{\c@lNATwritelocalbibdate}{%
+ \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi
+ \@ifundefined{B?\jobname?@\@citeb\@extra@b@citeb}{\@citea%
+ {\reset@font\bfseries ?}\NAT@citeundefined
+ \PackageWarning{natbib}%
+ {Citation `\@citeb' on page \thepage \space undefined}
+ \def\NAT@date{}}}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+%
+% \begin{macro}{\c@lNAT@citexnum@swatrue}
+% Holds some of the internals of the original |\NAT@citexnum|.
+% \begin{macrocode}
+\newcommand{\c@lNAT@citexnum@swatrue}{%
+ \ifnum\NAT@ctype>1\relax\@citea
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \ifnum\NAT@ctype=2\relax\NAT@test{\NAT@ctype}%
+ \else\NAT@alias
+ \fi\hyper@natlinkend\else
+ \ifnum\NAT@sort>1\relax
+ \begingroup\catcode`\_=8
+ \ifcat _\ifnum\z@<0\NAT@num _\else A\fi
+ \global\let\NAT@nm=\NAT@num \else \gdef\NAT@nm{-2}\fi
+ \ifcat _\ifnum\z@<0\NAT@last@num _\else A\fi
+ \global\@tempcnta=\NAT@last@num \global\advance\@tempcnta by\@ne
+ \else \global\@tempcnta\m@ne\fi
+ \endgroup
+ \ifnum\NAT@nm=\@tempcnta
+ \ifx\NAT@last@yr\relax
+ \edef\NAT@last@yr{\@citea \mbox{\noexpand\citenumfont\NAT@num}}%
+ \else
+ \edef\NAT@last@yr{--\penalty\@m\mbox{\noexpand\citenumfont\NAT@num}}%
+ \fi
+ \else
+ \NAT@last@yr \@citea \mbox{\citenumfont\NAT@num}%
+ \let\NAT@last@yr\relax
+ \fi
+ \else
+ \@citea \mbox{\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ {\citenumfont\NAT@num}\hyper@natlinkend}%
+ \fi
+ \fi
+ \def\@citea{\NAT@sep\penalty\@m\NAT@space}%
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\NAT@citexnum}
+% We redefine the original |\NAT@citexnum| to write for the main file.
+% \begin{macrocode}
+\def\NAT@citexnum[#1][#2]#3{%
+ \NAT@sort@cites{#3}%
+ \let\@citea\@empty
+ \@cite{\def\NAT@num{-1}\let\NAT@last@yr\relax\let\NAT@nm\@empty
+ \@for\@citeb:=\NAT@cite@list\do
+ {\edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \c@lNATwritemainbib %%% change here
+ {\let\NAT@last@num\NAT@num\let\NAT@last@nm\NAT@nm
+ \NAT@parse{\@citeb}%
+ \ifNAT@longnames\@ifundefined{bv@\@citeb\@extra@b@citeb}{%
+ \let\NAT@name=\NAT@all@names
+ \global\@namedef{bv@\@citeb\@extra@b@citeb}{}}{}%
+ \fi
+ \ifNAT@full\let\NAT@nm\NAT@all@names\else
+ \let\NAT@nm\NAT@name
+ \fi
+ \ifNAT@swa
+ \c@lNAT@citexnum@swatrue
+ \else
+ \ifcase\NAT@ctype\relax
+ \ifx\NAT@last@nm\NAT@nm \NAT@yrsep\penalty\@m\NAT@space\else
+ \@citea \NAT@test{1}\ \NAT@@open
+ \if*#1*\else#1\ \fi\fi \NAT@mbox{%
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ {\citenumfont\NAT@num}\hyper@natlinkend}%
+ \def\@citea{\NAT@@close\NAT@sep\penalty\@m\ }%
+ \or\@citea
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@test{\NAT@ctype}\hyper@natlinkend
+ \def\@citea{\NAT@sep\penalty\@m\ }%
+ \or\@citea
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@test{\NAT@ctype}\hyper@natlinkend
+ \def\@citea{\NAT@sep\penalty\@m\ }%
+ \or\@citea
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@alias\hyper@natlinkend
+ \def\@citea{\NAT@sep\penalty\@m\ }%
+ \fi
+ \fi
+ }}%
+ \ifnum\NAT@sort>1\relax\NAT@last@yr\fi
+ \ifNAT@swa\else\ifnum\NAT@ctype=0\if*#2*\else
+ \NAT@cmt#2\fi \NAT@@close\fi\fi}{#1}{#2}}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbNAT@citexnum}
+% A local version of |\NAT@citexnum|.
+% \begin{macrocode}
+\def\c@lbNAT@citexnum[#1][#2]#3{%
+ \ifc@lcombib\c@laNATnocite{#3}\fi %%% change here
+ \NAT@sort@cites{#3}%
+ \let\@citea\@empty
+ \@cite{\def\NAT@num{-1}\let\NAT@last@yr\relax\let\NAT@nm\@empty
+ \@for\@citeb:=\NAT@cite@list\do
+ {\edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \c@lNATwritelocalbib %%% change here
+ {\let\NAT@last@num\NAT@num\let\NAT@last@nm\NAT@nm
+ \NAT@parse{\@citeb}%
+ \ifNAT@longnames\@ifundefined{bv@\@citeb\@extra@b@citeb}{%
+ \let\NAT@name=\NAT@all@names
+ \global\@namedef{bv@\@citeb\@extra@b@citeb}{}}{}%
+ \fi
+ \ifNAT@full\let\NAT@nm\NAT@all@names\else
+ \let\NAT@nm\NAT@name\fi
+ \ifNAT@swa
+ \c@lNAT@citexnum@swatrue
+ \else
+ \ifcase\NAT@ctype\relax
+ \ifx\NAT@last@nm\NAT@nm \NAT@yrsep\penalty\@m\NAT@space\else
+ \@citea \NAT@test{1}\ \NAT@@open
+ \if*#1*\else#1\ \fi\fi \NAT@mbox{%
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ {\citenumfont\NAT@num}\hyper@natlinkend}%
+ \def\@citea{\NAT@@close\NAT@sep\penalty\@m\ }%
+ \or\@citea
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@test{\NAT@ctype}\hyper@natlinkend
+ \def\@citea{\NAT@sep\penalty\@m\ }%
+ \or\@citea
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@test{\NAT@ctype}\hyper@natlinkend
+ \def\@citea{\NAT@sep\penalty\@m\ }%
+ \or\@citea
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@alias\hyper@natlinkend
+ \def\@citea{\NAT@sep\penalty\@m\ }%
+ \fi\fi
+ }}%
+ \ifnum\NAT@sort>1\relax\NAT@last@yr\fi
+ \ifNAT@swa\else\ifnum\NAT@ctype=0\if*#2*\else
+ \NAT@cmt#2\fi \NAT@@close\fi\fi}{#1}{#2}}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\c@lNAT@citex@swatrue}
+% Holds some of the internals of the original |\NAT@citex|.
+% \begin{macrocode}
+\newcommand{\c@lNAT@citex@swatrue}{%
+ \ifcase\NAT@ctype
+ \if\relax\NAT@date\relax
+ \@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}\NAT@date\hyper@natlinkend
+ \else
+ \ifx\NAT@last@nm\NAT@nm\NAT@yrsep
+ \ifx\NAT@last@yr\NAT@year
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}\NAT@exlab
+ \hyper@natlinkend
+ \else
+ \unskip\
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}\NAT@date
+ \hyper@natlinkend
+ \fi
+ \else\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}%
+ \hyper@natlinkbreak{\NAT@aysep\ }{\@citeb\@extra@b@citeb}%
+ \NAT@date\hyper@natlinkend
+ \fi
+ \fi
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}\hyper@natlinkend
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@date\hyper@natlinkend
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@alias\hyper@natlinkend
+ \fi \def\@citea{\NAT@sep\ }%
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@laNAT@citex}
+% We redefine the original |\NAT@citex| macro for the main document.
+% \begin{macrocode}
+\def\NAT@citex%
+ [#1][#2]#3{%
+ \NAT@sort@cites{#3}%
+ \let\@citea\@empty
+ \@cite{\let\NAT@nm\@empty\let\NAT@year\@empty
+ \@for\@citeb:=\NAT@cite@list\do
+ {\edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \c@lNATwritemainbibdate %%%% change here
+ {\let\NAT@last@nm=\NAT@nm\let\NAT@last@yr=\NAT@year
+ \NAT@parse{\@citeb}%
+ \ifNAT@longnames\@ifundefined{bv@\@citeb\@extra@b@citeb}{%
+ \let\NAT@name=\NAT@all@names
+ \global\@namedef{bv@\@citeb\@extra@b@citeb}{}}{}%
+ \fi
+ \ifNAT@full\let\NAT@nm\NAT@all@names\else
+ \let\NAT@nm\NAT@name\fi
+ \ifNAT@swa
+ \c@lNAT@citex@swatrue
+ \else
+ \ifcase\NAT@ctype
+ \if\relax\NAT@date\relax
+ \@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}\hyper@natlinkend
+ \else
+ \ifx\NAT@last@nm\NAT@nm\NAT@yrsep
+ \ifx\NAT@last@yr\NAT@year
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}\NAT@exlab
+ \hyper@natlinkend
+ \else\unskip\
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}\NAT@date
+ \hyper@natlinkend
+ \fi
+ \else\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}%
+ \hyper@natlinkbreak{\ \NAT@@open\if*#1*\else#1\ \fi}%
+ {\@citeb\@extra@b@citeb}%
+ \NAT@date\hyper@natlinkend\fi
+ \fi
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}\hyper@natlinkend
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@date\hyper@natlinkend
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@alias\hyper@natlinkend
+ \fi \if\relax\NAT@date\relax\def\@citea{\NAT@sep\ }%
+ \else\def\@citea{\NAT@@close\NAT@sep\ }\fi
+ \fi
+ }}\ifNAT@swa\else\if*#2*\else\NAT@cmt#2\fi
+ \if\relax\NAT@date\relax\else\NAT@@close\fi\fi}{#1}{#2}}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbNAT@citex}
+% The local version of |\NAT@citex|.
+% \begin{macrocode}
+\def\c@lbNAT@citex[#1][#2]#3{%
+ \ifc@lcombib \c@laNATnocite{#3} \fi %%%% change here
+ \NAT@sort@cites{#3}%
+ \let\@citea\@empty
+ \@cite{\let\NAT@nm\@empty\let\NAT@year\@empty
+ \@for\@citeb:=\NAT@cite@list\do
+ {\edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \c@lNATwritelocalbibdate %%%% change here
+ {\let\NAT@last@nm=\NAT@nm\let\NAT@last@yr=\NAT@year
+ \NAT@parse{\@citeb}%
+ \ifNAT@longnames\@ifundefined{bv@\@citeb\@extra@b@citeb}{%
+ \let\NAT@name=\NAT@all@names
+ \global\@namedef{bv@\@citeb\@extra@b@citeb}{}}{}%
+ \fi
+ \ifNAT@full\let\NAT@nm\NAT@all@names\else
+ \let\NAT@nm\NAT@name\fi
+ \ifNAT@swa
+ \c@lNAT@citex@swatrue
+ \else
+ \ifcase\NAT@ctype
+ \if\relax\NAT@date\relax
+ \@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}\hyper@natlinkend
+ \else
+ \ifx\NAT@last@nm\NAT@nm\NAT@yrsep
+ \ifx\NAT@last@yr\NAT@year
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}\NAT@exlab
+ \hyper@natlinkend
+ \else\unskip\
+ \hyper@natlinkstart{\@citeb\@extra@b@citeb}\NAT@date
+ \hyper@natlinkend
+ \fi
+ \else\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}%
+ \hyper@natlinkbreak{\ \NAT@@open\if*#1*\else#1\ \fi}%
+ {\@citeb\@extra@b@citeb}%
+ \NAT@date\hyper@natlinkend\fi
+ \fi
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@nmfmt{\NAT@nm}\hyper@natlinkend
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@date\hyper@natlinkend
+ \or\@citea\hyper@natlinkstart{\@citeb\@extra@b@citeb}%
+ \NAT@alias\hyper@natlinkend
+ \fi \if\relax\NAT@date\relax\def\@citea{\NAT@sep\ }%
+ \else\def\@citea{\NAT@@close\NAT@sep\ }\fi
+ \fi
+ }}\ifNAT@swa\else\if*#2*\else\NAT@cmt#2\fi
+ \if\relax\NAT@date\relax\else\NAT@@close\fi\fi}{#1}{#2}}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@laNATnocite}
+% \begin{macro}{\nocite}
+% A main document version of the natbib |\nocite|.
+% \begin{macrocode}
+\newcommand\c@laNATnocite[1]{\@bsphack
+ \@for\@citeb:=#1\do{%
+ \edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \if@filesw\immediate\write\@mainaux{\string\citation{\@citeb}}\fi
+ \if*\@citeb\else
+ \@ifundefined{b@\@citeb\@extra@b@citeb}{%
+ \NAT@citeundefined \PackageWarning{natbib}%
+ {Citation `\@citeb' undefined}}{}\fi}%
+ \@esphack}
+\renewcommand{\nocite}[1]{\c@laNATnocite{#1}}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@lbNATnocite}
+% The local version pf |\nocite|.
+% \begin{macrocode}
+\newcommand\c@lbNATnocite[1]{\@bsphack
+ \@for\@citeb:=#1\do{%
+ \edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi
+ \if*\@citeb\else
+ \@ifundefined{B?\jobname?@\@citeb\@extra@b@citeb}{%
+ \NAT@citeundefined \PackageWarning{natbib}%
+ {Citation `\@citeb' undefined}}{}\fi}%
+ \@esphack}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\NAT@wrout}
+% Main version of the original |\NAT@wrout|.
+% \begin{macrocode}
+\renewcommand{\NAT@wrout}[5]{%
+ \if@filesw
+ {\let\protect\noexpand\let~\relax
+ \immediate
+ \write\@mainaux{\string\bibcite{#5}{{#1}{#2}{{#3}}{{#4}}}}}\fi
+\ignorespaces}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbNAT@wrout}
+% Local version of the original |\NAT@wrout|.
+% \begin{macrocode}
+\newcommand{\c@lbNAT@wrout}[5]{%
+ \if@filesw
+ {\let\protect\noexpand\let~\relax
+ \immediate
+ \write\@auxout{\string\bibcite{#5}{{#1}{#2}{{#3}}{{#4}}}}}\fi
+\ignorespaces}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+%
+% \begin{macro}{\c@laNAT@parse}
+% \begin{macro}{\c@lbNAT@parse}
+% Main and local versions of |\NAT@parse|.
+% \begin{macrocode}
+\newcommand\c@laNAT@parse[1]{{%
+ \let\protect=\@unexpandable@protect\let~\relax
+ \let\active@prefix=\@gobble
+ \xdef\NAT@temp{\csname b@#1\@extra@b@citeb\endcsname}}%
+ \expandafter\NAT@split\NAT@temp?????@@%
+ \expandafter\NAT@parse@date\NAT@date??????@@%
+ \ifciteindex\NAT@index\fi}
+
+\newcommand\c@lbNAT@parse[1]{{%
+ \let\protect=\@unexpandable@protect\let~\relax
+ \let\active@prefix=\@gobble
+ \xdef\NAT@temp{\csname B?\jobname?@#1\@extra@b@citeb\endcsname}}%
+ \expandafter\NAT@split\NAT@temp?????@@%
+ \expandafter\NAT@parse@date\NAT@date??????@@%
+ \ifciteindex\NAT@index\fi}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@laNAT@lbibitem}
+% \begin{macro}{\c@lbNAT@lbibitem}
+% Main and local version of |\@lbibitem|.
+% \begin{macrocode}
+\def\c@laNAT@lbibitem[#1]#2{%
+ \if\relax\@extra@b@citeb\relax\else
+ \@ifundefined{br@#2\@extra@b@citeb}{}{%
+ \@namedef{br@#2}{\@nameuse{br@#2\@extra@b@citeb}}}\fi
+ \@ifundefined{b@#2\@extra@b@citeb}{\def\NAT@num{}}{\NAT@parse{#2}}%
+ \item[\hfil\hyper@natanchorstart{#2\@extra@b@citeb}\@biblabel{\NAT@num}%
+ \hyper@natanchorend]%
+ \NAT@ifcmd#1(@)(@)\@nil{#2}}
+
+\def\c@lbNAT@lbibitem[#1]#2{%
+ \if\relax\@extra@b@citeb\relax\else
+ \@ifundefined{br@#2\@extra@b@citeb}{}{%
+ \@namedef{br@#2}{\@nameuse{br@#2\@extra@b@citeb}}}\fi
+ \@ifundefined{B?\jobname?@#2\@extra@b@citeb}{\def\NAT@num{}}{\NAT@parse{#2}}%
+ \item[\hfil\hyper@natanchorstart{#2\@extra@b@citeb}\@biblabel{\NAT@num}%
+ \hyper@natanchorend]%
+ \NAT@ifcmd#1(@)(@)\@nil{#2}}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@laNATbibcite}
+% \begin{macro}{\c@lbNATbibcite}
+% Main and local versions of |\NATbibcite|.
+% \begin{macrocode}
+\newcommand\c@laNATbibcite[2]{\@ifundefined{b@#1\@extra@binfo}\relax
+ {\NAT@citemultiple
+ \PackageWarningNoLine{natbib}{Citation `#1' multiply defined}}%
+ \global\@namedef{b@#1\@extra@binfo}{#2}}
+
+\newcommand\c@lbNATbibcite[2]{\@ifundefined{B?\jobname?@#1\@extra@binfo}\relax
+ {\NAT@citemultiple
+ \PackageWarningNoLine{natbib}{Citation `#1' multiply defined}}%
+ \global\@namedef{B?\jobname?@#1\@extra@binfo}{#2}}
+
+\ifc@lonebib
+ \ifc@lcombib
+ \else
+ \renewcommand\c@lbNATbibcite[2]{\@ifundefined{b@#1\@extra@binfo}\relax
+ {\NAT@citemultiple
+ \PackageWarningNoLine{natbib}{Citation `#1' multiply defined}}%
+ \global\@namedef{B?\jobname?@#1\@extra@binfo}{#2}}
+ \fi
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@laNAT@testdef}
+% \begin{macro}{\c@lbNAT@testdef}
+% Main and local versions of |\NAT@testdef|.
+% \begin{macrocode}
+\newcommand\c@laNAT@testdef[2]{%
+ \def\NAT@temp{#2}\expandafter \ifx \csname b@#1\@extra@binfo\endcsname
+ \NAT@temp \else \ifNAT@swa \NAT@swafalse
+ \PackageWarningNoLine{natbib}{Citation(s) may have
+ changed.\MessageBreak
+ Rerun to get citations correct}\fi\fi}
+
+\newcommand\c@lbNAT@testdef[2]{%
+ \def\NAT@temp{#2}\expandafter \ifx \csname B?\jobname?@#1\@extra@binfo\endcsname
+ \NAT@temp \else \ifNAT@swa \NAT@swafalse
+ \PackageWarningNoLine{natbib}{Citation(s) may have
+ changed.\MessageBreak
+ Rerun to get citations correct}\fi\fi}
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@laNAT@make@cite@list}
+% \begin{macro}{\c@lbNAT@make@cite@list}
+% Main and local versions of |\NAT@make@cite@list|.
+% \begin{macrocode}
+\ifnum\NAT@sort>0
+ \begingroup \catcode`\_=8
+ \gdef\c@laNAT@make@cite@list{%
+ \edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \@ifundefined{b@\@citeb\@extra@b@citeb}{\def\NAT@num{A}}%
+ {\NAT@parse{\@citeb}}%
+ \ifcat _\ifnum\z@<0\NAT@num _\else A\fi
+ \@tempcnta\NAT@num \relax
+ \ifnum \@tempcnta>\@tempcntb
+ \edef\NAT@num@list{\NAT@num@list \@celt{\NAT@num}}%
+ \edef\NAT@cite@list{\NAT@cite@list\@citeb,}%
+ \@tempcntb\@tempcnta
+ \else
+ \let\NAT@@cite@list=\NAT@cite@list \def\NAT@cite@list{}%
+ \edef\NAT@num@list{\expandafter\NAT@num@celt \NAT@num@list \@gobble @}%
+ {\let\@celt=\NAT@celt\NAT@num@list}%
+ \fi
+ \else
+ \edef\NAT@nonsort@list{\NAT@nonsort@list\@citeb,}%
+ \fi}
+ \endgroup
+
+ \begingroup \catcode`\_=8
+ \gdef\c@lbNAT@make@cite@list{%
+ \edef\@citeb{\expandafter\@firstofone\@citeb}%
+ \@ifundefined{B?\jobname?@\@citeb\@extra@b@citeb}{\def\NAT@num{A}}%
+ {\NAT@parse{\@citeb}}%
+ \ifcat _\ifnum\z@<0\NAT@num _\else A\fi
+ \@tempcnta\NAT@num \relax
+ \ifnum \@tempcnta>\@tempcntb
+ \edef\NAT@num@list{\NAT@num@list \@celt{\NAT@num}}%
+ \edef\NAT@cite@list{\NAT@cite@list\@citeb,}%
+ \@tempcntb\@tempcnta
+ \else
+ \let\NAT@@cite@list=\NAT@cite@list \def\NAT@cite@list{}%
+ \edef\NAT@num@list{\expandafter\NAT@num@celt \NAT@num@list \@gobble @}%
+ {\let\@celt=\NAT@celt\NAT@num@list}%
+ \fi
+ \else
+ \edef\NAT@nonsort@list{\NAT@nonsort@list\@citeb,}%
+ \fi}
+ \endgroup
+\fi
+
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% Some things are done at the end of a document.
+%
+% \begin{macrocode}
+\AtEndDocument{%
+ \ifNAT@stdbst\if@filesw\immediate\write
+ \@mainaux{\string\global\string\NAT@numberstrue}\fi\fi
+ }
+
+\AtEndDocument{\NAT@swatrue\let\bibcite\NAT@testdef}
+
+% \end{macrocode}
+%
+% \begin{macro}{\c@laNAT@set@cites}
+% Main version of |\NAT@set@cites|.
+% \begin{macrocode}
+\newcommand{\c@laNAT@set@cites}{\ifNAT@numbers
+ \ifNAT@super \let\@cite\NAT@citesuper
+ \def\NAT@mbox##1{\unskip\nobreak\hspace{1\p@}\textsuperscript{##1}}%
+ \let\citeyearpar=\citeyear
+ \let\NAT@space\relax\else
+ \let\NAT@mbox=\mbox
+ \let\@cite\NAT@citenum \def\NAT@space{ }\fi
+ \let\@citex\NAT@citexnum
+ \ifx\@biblabel\@empty\let\@biblabel\NAT@biblabelnum\fi
+ \let\@bibsetup\NAT@bibsetnum
+ \def\natexlab##1{}%
+ \else
+ \let\@cite\NAT@cite
+ \let\@citex\NAT@citex
+ \let\@biblabel\NAT@biblabel
+ \let\@bibsetup\NAT@bibsetup
+ \def\natexlab##1{##1}%
+ \fi}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbNAT@set@cites}
+% Local version of |\NAT@set@cites|.
+% \begin{macrocode}
+\newcommand{\c@lbNAT@set@cites}{\ifNAT@numbers
+ \ifNAT@super \let\@cite\NAT@citesuper
+ \def\NAT@mbox##1{\unskip\nobreak\hspace{1\p@}\textsuperscript{##1}}%
+ \let\citeyearpar=\citeyear
+ \let\NAT@space\relax\else
+ \let\NAT@mbox=\mbox
+ \let\@cite\NAT@citenum \def\NAT@space{ }\fi
+ \let\@citex\NAT@citexnum
+ \ifx\@biblabel\@empty\let\@biblabel\NAT@biblabelnum\fi
+ \let\@bibsetup\NAT@bibsetnum
+ \def\natexlab##1{}%
+ \else
+ \let\@cite\NAT@cite
+ \let\@citex\NAT@citex
+ \let\@biblabel\NAT@biblabel
+ \let\@bibsetup\NAT@bibsetup
+ \def\natexlab##1{##1}%
+ \fi}
+
+% \end{macrocode}
+% \end{macro}
+%
+% For the main document, use |\c@la...| to replace the |\NAT...| definitions.
+% \begin{macrocode}
+\let\NAT@parse\c@laNAT@parse
+%%\let\nocite\c@laNATnocite
+%%\let\NAT@wrout\c@laNAT@wrout
+\let\@lbibitem\c@laNAT@lbibitem
+\let\bibcite\c@laNATbibcite
+\let\NAT@testdef\c@laNAT@testdef
+%%\let\NAT@make@cite@list\c@laNAT@make@cite@list
+%%\let\NAT@citexnum\c@laNAT@citexnum
+%%\let\NAT@citex\c@laNAT@citex
+
+% \end{macrocode}
+%
+% And similarly for imported documents
+% \begin{macrocode}
+\let\c@loldsetuppapers\setuppapers
+\newcommand{\c@lNATsetuplocal}{%
+ \let\NAT@parse\c@lbNAT@parse
+ \let\nocite\c@lbNATnocite
+ \let\NAT@wrout\c@lbNAT@wrout
+ \let\@lbibitem\c@lbNAT@lbibitem
+ \let\bibcite\c@lbNATbibcite
+ \let\NAT@testdef\c@lbNAT@testdef
+ \let\NAT@make@cite@list\c@lbNAT@make@cite@list
+ \let\NAT@citexnum\c@lbNAT@citexnum
+ \let\NAT@citex\c@lbNAT@citex
+ \let\NAT@set@cites\c@lbNAT@set@cites
+ \c@lbNAT@set@cites
+}
+\renewcommand{\setuppapers}{%
+ \c@loldsetuppapers
+ \ifc@lcombib
+ \c@lNATsetuplocal
+ \else
+ \ifc@lonebib
+ \else
+ \c@lNATsetuplocal
+ \fi
+ \fi
+}
+
+% \end{macrocode}
+%
+%
+% The end of this package
+% \begin{macrocode}
+%</natpack>
+% \end{macrocode}
+%
+%
+%
+% \section{The \Lpack{combcite} package code} \label{citepackcode}
+%
+% This package calls the \Lpack{cite} package~\cite{CITE}
+% and then makes some minor changes to some of its macro definitions.
+% \changes{v0.63}{2003/11/09}{Added the combcite package}
+%
+% \begin{macrocode}
+%<*citepack>
+% \end{macrocode}
+% The usual preliminaries. The \Lpack{cite} package is required
+% and all options are passed to it to deal with.
+% \begin{macrocode}
+\@ifclassloaded{combine}{}{%
+ \PackageError{combcite}{The `combine' class is expected}{\@ehc}}
+% \end{macrocode}
+% By definition, we need the \Lpack{cite} package, but first have
+% to set up some option handling.
+% \begin{macro}{\ifc@lbsuperopt}
+% \cs{ifc@lbsuperopt} is a flag for if the \Lpack{cite} \Lopt{superscript}
+% option has been used.
+% \begin{macrocode}
+\newif\ifc@lbsuperopt
+ \c@lbsuperoptfalse
+% \end{macrocode}
+% \end{macro}
+% Now do the options.
+% \begin{macrocode}
+\DeclareOption{super}{\ExecuteOptions{superscript}}
+\DeclareOption{superscript}{\c@lbsuperopttrue
+ \PassOptionsToClass{superscript}{cite}}
+\ProcessOptions
+% \end{macrocode}
+%
+% We need the latest cite package (version 4.01 November 2003)
+% \begin{macrocode}
+\RequirePackageWithOptions{cite}[2003/11/04]
+
+% \end{macrocode}
+% Need special versions of various macros for imported papers,
+% principally to handle writing to the .aux files.
+% Indicate these by prepending `c@lb' to the name.
+%
+% \begin{macro}{\c@lbciten}
+% \begin{macrocode}
+\DeclareRobustCommand\c@lbciten[1]{%
+ \begingroup
+ \let\@safe@activesfalse\@empty
+%% \c@lb@nocite{#1}% ignores spaces, writes to .aux file, returns #1 in \@no@sparg
+ \@nocite{#1}% ignores spaces, writes to .aux file, returns #1 in \@no@sparg
+ \@tempcntb\m@ne % \@tempcntb tracks highest number
+ \let\@h@ld\@empty % nothing held from list yet
+ \let\@citea\@empty % no punctuation preceding first
+ \let\@celt\delimiter % an unexpandable, but identifiable, token
+ \def\@cite@list{}% % empty list to start
+ \@for \@citeb:=\@no@sparg\do{\c@lb@make@cite@list}% make a sorted list of numbers
+ % After sorted citelist is made, execute it to compress citation ranges.
+ \@tempcnta\m@ne % no previous number
+ \let\@celt\@compress@cite \@cite@list % output number list with compression
+ \@h@ld % output anything held over
+ \endgroup
+ \@restore@auxhandle
+ }
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lb@make@cite@list}
+%
+% \begin{macrocode}
+\def\c@lb@make@cite@list{%
+ \expandafter\let \expandafter\@B@citeB
+ \csname B?\jobname?@\@citeb\@extra@b@citeb \endcsname
+ \ifx\@B@citeB\relax % undefined: output ? and warning
+ \@citea {\bfseries ?}\let\@citea\citepunct \G@refundefinedtrue
+ \@warning {Citation `\@citeb' on page \thepage\space undefined}%
+ \oc@verbo \global\@namedef{B?\jobname?@\@citeb\@extra@b@citeb}{?}%
+ \else % defined % remove previous line to repeat warnings
+ \ifcat _\ifnum\z@<0\@B@citeB _\else A\fi % a positive number, put in list
+ \@addto@cite@list
+ \else % citation is not a number, output immediately
+ \@citea \citeform{\@B@citeB}\let\@citea\citepunct
+ \fi\fi}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbcite}
+% The revision to \cs{cite} depends on whether the \Lopt{superscript}
+% option has been used.
+% \begin{macrocode}
+\ifc@lbsuperopt
+ \DeclareRobustCommand{\c@lbcite}{%
+ \@ifnextchar[{\@tempswatrue\c@lb@citex}{\@tempswafalse\c@lb@citew}}
+\else
+ \DeclareRobustCommand{\c@lbcite}{%
+ \@ifnextchar[{\@tempswatrue\c@lb@citex}{\@tempswafalse\c@lb@citex[]}}
+\fi
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lb@citex}
+%
+% \begin{macrocode}
+\def\c@lb@citex[#1]#2{\@cite{\c@lbciten{#2}}{#1}}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lb@citew}
+%
+% \begin{macrocode}
+\def\c@lb@citew#1{\begingroup \leavevmode
+ \@if@fillglue \lastskip \relax \unskip
+ \def\@tempa{\@tempcnta\spacefactor
+ \/% this allows the last word to be hyphenated, and it looks better.
+ \@citess{\c@lbciten{#1}}\spacefactor\@tempcnta
+ \endgroup \@restore@auxhandle}%
+ \oc@movep\relax}% check for following punctuation (depending on options)
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\c@lbnocite}
+%
+% \begin{macrocode}
+\DeclareRobustCommand\c@lbnocite[1]{%
+ \@bsphack \@nocite{#1}%
+ \@for \@citeb:=\@no@sparg\do{\@ifundefined{B?\jobname?@\@citeb\@extra@b@citeb}%
+ {\G@refundefinedtrue\@warning{Citation `\@citeb' undefined}%
+ \oc@verbo \global\@namedef{B?\jobname?@\@citeb\@extra@b@citeb}{?}}{}}%
+ \@esphack}
+
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\@nocite}
+%
+% \begin{macrocode}
+\def\@nocite#1{\begingroup\let\protect\string% normalize active chars
+ \xdef\@no@sparg{\expandafter\@ignsp#1 \: }\endgroup% and remove ALL spaces
+ \if@filesw \immediate\write\@newciteauxhandle % = \@auxout, except with multibib
+ {\string\citation {\@no@sparg}}\fi
+ }
+
+% \end{macrocode}
+% \end{macro}
+%
+% Finally, add the revision to \cs{setuppapers}.
+% \begin{macrocode}
+\g@addto@macro{\setuppapers}{\let\cite\c@lbcite}
+\g@addto@macro{\setuppapers}{\let\citenum\c@lbciten}
+\g@addto@macro{\setuppapers}{\let\citeonline\c@lbciten}
+
+% \end{macrocode}
+%
+%
+% The end of this package
+% \begin{macrocode}
+%</citepack>
+% \end{macrocode}
+%
+%
+%
+% \appendix
+% \section{Original code}
+%
+% This section presents the original kernel code before modification.
+%
+% The |\documentclass| macro is specified in \file{ltclass.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \def\documentclass{%
+% \let\documentclass\@twoclasseserror
+% \if@compatability\else\let\usepackage\RequirePackage\fi
+% \@fileswithoptions\@clsextension}
+% \@onlypreamble\documentclass
+% \end{verbatim}
+% \end{small}\par
+%
+% The |document| environment is specified between \file{ltfiles.dtx} and
+% \file{ltmiscen.dtx}. The |\document| command is given in \file{ltfiles.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \def\document{\endgroup
+% \ifx\@unusedoptionlist\@empty\else
+% \@latex@warning@no@line{Unused global option(s):^^J%
+% \@spaces[\@unusedoptionlist]}%
+% \fi
+% \@colht\textheight
+% \@colroom\textheight \vsize\textheight
+% \columnwidth\textwidth
+% \@clubpenalty\clubpenalty
+% \if@twocolumn
+% \advance\columnwidth -\columnsep
+% \divide\columnwidth\tw@ \hsize\columnwidth \@firstcolumntrue
+% \fi
+% \hsize\columnwidth \linewidth\hsize
+% \begingroup\@floatplacement\@dblfloatplacement
+% \makeatletter\let\@writefile\@gobbletwo
+% \global \let \@multiplelabels \relax
+% \@input{\jobname.aux}%
+% \endgroup
+% \if@filesw
+% \immediate\openout\@mainaux\jobname.aux
+% \immediate\write\@mainaux{\relax}%
+% \fi
+% \process@table
+% \let\glb@currsize\@empty
+% \normalsize
+% \everypar{}%
+% \ifx\normalsfcodes\@empty
+% \ifnum\sfcode`\.=\@m
+% \let\normalsfcodes\frenchspacing
+% \else
+% \let\normalsfcodes\nonfrenchspacing
+% \fi
+% \fi
+% \@noskipsecfalse
+% \let \@refundefined \relax
+% \let\AtBeginDocument\@firstofone
+% \@begindocumenthook
+% \ifdim\topskip<1sp\global\topskip 1sp\relax\fi
+% \global\@maxdepth\maxdepth
+% \global\let\@begindocumenthook\@undefined
+% \ifx\@listfiles\@undefined
+% \global\let\@filelist\relax
+% \global\let\@addtofilelist\@gobble
+% \fi
+% \gdef\do##1{\global\let ##1\@notprerr}%
+% \@preamblecmds
+% \global\let \@nodocument \relax
+% \global\let\do\noexpand
+% \ignorespaces}
+% \@onlypreamble\document
+% \end{verbatim}
+% \end{small}\par
+% The |\enddocument| macro is specified in \file{ltmiscen.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \def\enddocument{%
+% \@enddocumenthook
+% \@checkend{document}%
+% \clearpage
+% \begingroup
+% \if@filesw
+% \immediate\closeout\@mainaux
+% \let\@setckpt\@gobbletwo
+% \let\@newl@bel\@testdef
+% \@tempswafalse
+% \makeatletter \input\jobname.aux
+% \fi
+% \@dofilelist
+% \ifdim \font@submax >\fontsubfuzz\relax
+% \@font@warning{Size substitutions with differences\MessageBreak
+% up to \font@submax\space have occured.\@gobbletwo}%
+% \fi
+% \@defaultsubs
+% \@refundefined
+% \if@filesw
+% \ifx \@multiplelabels \relax
+% \if@tempswa
+% \@latex@warning@no@line{Label(s) may have changed.
+% Rerun to get cross-references right}%
+% \fi
+% \else
+% \@multiplelabels
+% \fi
+% \fi
+% \endgroup
+% \deadcycles\z@\@@end}
+% \end{verbatim}
+% \end{small}\par
+%
+% |\maketitle| is defined by each class. The following is from
+% \file{classes.dtx} for the \Lpack{book}, \Lpack{report} and \Lpack{article}
+% classes.
+% \par\begin{small}\begin{verbatim}
+% \if@titlepage
+% \newcommand{\maketitle}{\begin{titlepage}%
+% \let\footnotesize\small
+% \let\footnoterule\relax
+% \let \footnote \thanks
+% \null\vfil
+% \vskip 60\p@
+% \begin{center}%
+% {\LARGE \@title \par}%
+% \vskip 3em%
+% {\large
+% \lineskip .75em%
+% \begin{tabular}[t]{c}%
+% \@author
+% \end{tabular}\par}%
+% \vskip 1.5em%
+% {\large \@date \par}%
+% \end{center}\par
+% \@thanks
+% \vfil\null
+% \end{titlepage}%
+% \setcounter{footnote}{0}%
+% \global\let\thanks\relax
+% \global\let\maketitle\relax
+% \global\let\@thanks\@empty
+% \global\let\@author\@empty
+% \global\let\@date\@empty
+% \global\let\@title\@empty
+% \global\let\title\relax
+% \global\let\author\relax
+% \global\let\date\relax
+% \global\let\and\relax
+% } % end titlepage \maketitle
+% \else
+% \newcommand{\maketitle}{\par
+% \begingroup
+% \renewcommand\thefootnote{\@fnsymbol\c@footnote}%
+% \def\@makefnmark{\rlap{\@textsuperscript{\normalfont\@thefnmark}}}%
+% \long\def\@makefntext##1{\parindent 1em\noindent
+% \hb@xt@1.8em{%
+% \hss\@textsuperscript{\normalfont\@thefnmark}}##1}%
+% \if@twocolumn
+% \ifnum \col@number=\@ne
+% \@maketitle
+% \else
+% \twocolumn[\@maketitle]%
+% \fi
+% \else
+% \newpage
+% \global\@topnum\z@
+% \@maketitle
+% \fi
+% \thispagestyle{plain}\@thanks
+% \endgroup
+% \setcounter{footnote}{0}%
+% \global\let\thanks\relax
+% \global\let\maketitle\relax
+% \global\let\@maketitle\relax
+% \global\let\@thanks\@empty
+% \global\let\@author\@empty
+% \global\let\@date\@empty
+% \global\let\@title\@empty
+% \global\let\title\relax
+% \global\let\author\relax
+% \global\let\date\relax
+% \global\let\and\relax
+% } % end non-titlepage \maketitle
+%
+% \def\@maketitle{%
+% \newpage
+% \null
+% \vskip 2em%
+% \begin{center}%
+% \let \footnote \thanks
+% {\LARGE \@title \par}%
+% \vskip 1.5em%
+% {\large
+% \lineskip .5em%
+% \begin{tabular}[t]{c}%
+% \@author
+% \end{tabular}\par}%
+% \vskip 1em%
+% {\large \@date}%
+% \end{center}\par
+% \vskip 1.5em}
+% \fi
+% \end{verbatim}
+% \end{small}\par
+%
+% The definitions of |\title| and friends are in \file{ltsect.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \def\title#1{\gdef\@title{#1}}
+% \def\@title{\@latex@error{No \noexpand\title given}\@ehc}
+% \def\author#1{\gdef\@author{#1}}
+% \def\@author{\@latex@warning@no@line{No \noexpand\author given}}
+% \def\date#1{\gdef\@date{#1}}
+% \gdef\@date{\today}
+% \def\thanks#1{\footnotemark
+% \protected@xdef\@thanks{\@thanks
+% \protect\footnotetext[\the\c@footnote]{#1}}}
+% \let\@thanks\@empty
+% \def\and{% % \begin{tabular}
+% \end{tabular}%
+% \hskip 1em \@plus.17fil%
+% \begin{tabular}[t]{c}}% % \end{tabular}
+% \end{verbatim}
+% \end{small}\par
+%
+% The definition of |\@starttoc| from \file{ltsect.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \def\@starttoc#1{%
+% \begingroup
+% \makeatletter
+% \@input{\jobname.#1}%
+% \if@filesw
+% \expandafter\newwrite\csname tf@#1\endcsname
+% \immediate\openout \csname tf@#1\endcsname \jobname.#1\relax
+% \fi
+% \@nobreakfalse
+% \endgroup}
+% \end{verbatim}
+% \end{small}\par
+%
+% The definition of |\@writefile| from \file{ltmiscen.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \long\def@writefile#1#2{%
+% \@ifundefined{tf@#1}\relax
+% {\@temptokena{#2}%
+% \immediate\write\csname tf@#1\endcsname{\the\@temptokena}%
+% }}
+% \end{verbatim}
+% \end{small}\par
+%
+% The definitions of |\addtocontents| and |addcontentsline|
+% from \file{ltsect.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \long\def\addtocontents#1#2{%
+% \protected@write\@auxout
+% {\let\label\@gobble \let\index\@gobble \let\glossary\@gobble}%
+% {\string\@writefile{#1}{#2}}}
+% \def\addcontentsline#1#2#3{%
+% \addtocontents{#1}{\protect\contentsline{#2}{#3}{\thepage}}}
+% \end{verbatim}
+% \end{small}\par
+%
+% The definitions of |\label|, |\@setref|, |\newlabel|, |\ref| and |\pageref|
+% from \file{ltxref.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \def\label#1{\@bsphack
+% \protected@write\@auxout{}%
+% {\string\newlabel{#1}{{\@currentlabel}{\thepage}}}%
+% \@esphack}
+% \def\@setref#1#2#3{%
+% \ifx#1\relax
+% \protect\G@refundefinedtrue
+% \nfss@text{\reset@font\bfseries ??}%
+% \@latex@warning{Reference `#3' on page \thepage \space
+% undefined}%
+% \else
+% \expandafter#2#1\null
+% \fi}
+% \def\newlabel{\@newl@bel r}
+% \def\ref#1{\expandafter\@setref\csname r@#1\endcsname
+% \@firstoftwo{#1}}
+% \def\pageref#1{\expandafter\@setref\csname r@#1\endcsname
+% \@secondoftwo{#1}}
+% \end{verbatim}
+% \end{small}\par
+%
+% The definitions of |\bibcite| and |\@citex| from \file{ltbibl.dtx}.
+% \par\begin{small}\begin{verbatim}
+% \def\bibcite{\@newl@bel b}
+% \def\@citex[#1]#2{%
+% \let\@citea\@empty
+% \@cite{\@for\@citeb:=#2\do
+% {\@citea\def\@citea{,\penalty\@m\ }%
+% \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}%
+% \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi
+% \@ifundefined{b\@citeb}{\mbox{\reset@font\bfseries ?}%
+% \G@refundefinedtrue
+% \@latex@warning
+% {Citation `\@citeb' on page \thepage \space undefined}}%
+% {\hbox{\csname b\@citeb\endcsname}}}}{#1}}
+% \end{verbatim}
+% \end{small}\par
+%
+%
+%
+%
+% \Finale
+% \PrintIndex
+%
+\endinput
+
+%% \CharacterTable
+%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+
+
diff --git a/macros/latex/contrib/combine/combine.ins b/macros/latex/contrib/combine/combine.ins
new file mode 100644
index 0000000000..d31479d5ba
--- /dev/null
+++ b/macros/latex/contrib/combine/combine.ins
@@ -0,0 +1,84 @@
+%% combine.ins
+%% Author: Peter Wilson, Herries Press
+%% Maintainer: Will Robertson (will dot robertson at latex-project dot org)
+%% Copyright 2000, 2003, 2004 Peter R. Wilson
+%% Copyright 2010 Will Robertson
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either
+%% version 1.3c of this license or (at your option) any
+%% later version: <http://www.latex-project.org/lppl.txt>
+%%
+%% This work has the LPPL maintenance status "maintained".
+%% The Current Maintainer of this work is Will Robertson.
+%%
+%% This work consists of the files listed in the README file.
+%%
+%%
+%% This file will generate fast loadable files and documentation
+%% driver files from the doc files in this work when run through
+%% LaTeX.
+%%
+%%
+%%
+%% --------------- start of docstrip commands ------------------
+%%
+\def\batchfile{combine.ins}
+\input docstrip.tex
+\preamble
+
+ Author: Peter Wilson, Herries Press
+ Maintainer: Will Robertson (will dot robertson at latex-project dot org)
+ Copyright 2000, 2001, 2002, 2003 Peter R. Wilson
+ Copyright 2010 Will Robertson
+
+ This work may be distributed and/or modified under the
+ conditions of the LaTeX Project Public License, either
+ version 1.3c of this license or (at your option) any
+ later version: <http://www.latex-project.org/lppl.txt>
+
+ This work has the LPPL maintenance status "maintained".
+ The Current Maintainer of this work is Will Robertson.
+
+ This work consists of the files listed in the README file.
+
+\endpreamble
+
+\askforoverwritefalse
+\keepsilent
+
+%%% \Msg{*** Generating the driver file ***}
+%%% \generate{\file{combine.drv}{\from{combine.dtx}{driver}}}
+
+\Msg{*** Generating the LaTeX2e class file ***}
+
+\generate{\file{combine.cls}{\from{combine.dtx}{usc}}}
+
+\Msg{*** Generating the LaTeX2e package files ***}
+
+\generate{\file{combinet.sty}{\from{combine.dtx}{pck}}}
+\generate{\file{combnat.sty}{\from{combine.dtx}{natpack}}}
+\generate{\file{combcite.sty}{\from{combine.dtx}{citepack}}}
+
+\Msg{***********************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the following}
+\Msg{* file(s) into a directory searched by TeX:}
+\Msg{*}
+\Msg{* \space\space combine.cls}
+\Msg{* \space\space combinet.sty}
+\Msg{* \space\space combnat.sty}
+\Msg{* \space\space combcite.sty}
+\Msg{*}
+\Msg{*}
+\Msg{* To produce the documentation run the files ending with}
+\Msg{* `.dtx' through LaTeX.}
+\Msg{* Process any name.idx file by:}
+\Msg{* \space\space\space\space makeindex -s gind.ist name}
+\Msg{* Process any name.glo file by:}
+\Msg{* \space\space\space\space makeindex -s gglo.ist -o name.gls name.glo}
+\Msg{*}
+\Msg{* Happy TeXing}
+\Msg{***********************************************************}
+
+\endinput
diff --git a/macros/latex/contrib/combine/combine.pdf b/macros/latex/contrib/combine/combine.pdf
new file mode 100644
index 0000000000..866140e637
--- /dev/null
+++ b/macros/latex/contrib/combine/combine.pdf
Binary files differ