From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/combine/README | 138 + macros/latex/contrib/combine/combine.dtx | 4177 ++++++++++++++++++++++++++++++ macros/latex/contrib/combine/combine.ins | 84 + macros/latex/contrib/combine/combine.pdf | Bin 0 -> 465111 bytes 4 files changed, 4399 insertions(+) create mode 100644 macros/latex/contrib/combine/README create mode 100644 macros/latex/contrib/combine/combine.dtx create mode 100644 macros/latex/contrib/combine/combine.ins create mode 100644 macros/latex/contrib/combine/combine.pdf (limited to 'macros/latex/contrib/combine') 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: + + 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: +% +% 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} +% +%\ProvidesClass{combine} +%\ProvidesPackage{combinet} +%\ProvidesPackage{combnat} +%\ProvidesPackage{combcite} +%<*usc|pck|natpack|citepack> + [2010/07/10 v0.7a +% +% collection of documents +% document titles in ToC +% combine version of natbib package +% combine version of cite package +%<*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} +% +% +% \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} +% +% \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} +% +% \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} +% +% \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} +% +% \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: +%% +%% 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: + + 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 Binary files /dev/null and b/macros/latex/contrib/combine/combine.pdf differ -- cgit v1.2.3