trunk/Master/texmf-dist/source/latex/booklet

git-svn-id: svn://tug.org/texlive/trunk@170 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 2543 insertions, 0 deletions

diff --git a/Master/texmf-dist/source/latex/booklet/booklet.dtx b/Master/texmf-dist/source/latex/booklet/booklet.dtx
new file mode 100644
index 00000000000..52486ef1aaf
--- /dev/null
+++ b/Master/texmf-dist/source/latex/booklet/booklet.dtx
@@ -0,0 +1,2464 @@
+% \iffalse meta-comment
+% booklet.dtx
+% Author: Peter Wilson (Herries Press) herries dot press at earthlink dot net
+% Copyright 2000 --- 2005 Peter R. Wilson
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either
+% version 1.3 of this license or (at your option) any 
+% later version.
+% The latest version of the license is in
+%    http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of
+% LaTeX version 2003/06/01 or later.
+%
+% This work has the LPPL maintenance status "author-maintained".
+%
+% This work consists of the files listed in the README file.
+%
+% 
+%<*driver>
+\documentclass[twoside]{ltxdoc}
+\usepackage{url}
+\usepackage[draft=false,
+            plainpages=false,
+            pdfpagelabels,
+            bookmarksnumbered,
+            hyperindex=false
+           ]{hyperref}
+\providecommand{\phantomsection}{}
+\makeatletter
+  \@mparswitchfalse
+\makeatother
+\EnableCrossrefs
+\CodelineIndex
+%%\OnlyDescription
+\renewcommand{\MakeUppercase}[1]{#1}
+\pagestyle{headings}
+\setcounter{StandardModuleDepth}{1}
+\begin{document}
+  \DocInput{booklet.dtx}
+\end{document}
+%</driver>
+%
+% \fi
+%
+% \CheckSum{629}
+%
+% \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.5}{2001/08/11}{First public release}
+% \changes{v0.6}{2001/08/26}{Reduced use of boxes}
+% \changes{v0.6a}{2002/10/05}{Improved documentation, no technical changes}
+% \changes{v0.6b}{2004/04/16}{Changed license and contact details}
+% \changes{v0.7}{2005/03/23}{Improved print setup for memoir}
+% \changes{v0.7a}{2005/06/01}{Additional documentation}
+%
+% \def\dtxfile{booklet.dtx}
+% \def\fileversion{v0.5} \def\filedate{2001/08/11}
+% \def\fileversion{v0.6} \def\filedate{2001/08/26}
+% \def\fileversion{v0.6a} \def\filedate{2002/10/05}
+% \def\fileversion{v0.6b} \def\filedate{2004/04/16}
+% \def\fileversion{v0.7} \def\filedate{2005/03/23}
+% \def\fileversion{v0.7a} \def\filedate{2005/06/01}
+% \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{Printing booklets with LaTeX\thanks{This
+%        file (\texttt{\dtxfile}) has version number \fileversion, last revised
+%        \filedate.}}
+%
+% \author{%
+% Peter Wilson\thanks{\texttt{herries dot press at earthlink dot net}}\\
+% The Herries Press
+% }
+% \date{\filedate}
+% \maketitle
+% \begin{abstract}
+%    The \Lpack{booklet} package provides some aid in printing
+% simple booklets or signatures for longer books.
+%
+% \end{abstract}
+% \tableofcontents
+%
+% 
+%
+% \section{Introduction}
+%
+%     In normal usage the \Lpack{booklet} package subverts LaTeX into
+% putting pairs of pages onto a single page. For example, the contents
+% of pairs of A4 
+% portrait pages can be rotated and printed as two A5 portrait 
+% pages side by side on an A4 landscape page.
+%
+%     In 1993 Timothy Van Zandt wrote the \Lpack{2up} generic macros 
+% for printing more than one page on a physical sheet~\cite{2UP};
+% his original code and documentation is in appendices~\ref{sec:2upcode}
+% and~\ref{sec:2updoc}.
+% The \Lpack{booklet}
+% package is a poorman's version of some of the \Lpack{2up} macros
+% specifically for (pdf)LaTeX.
+%
+%    The \Lpack{2up} and \Lpack{booklet} packages cannot be used
+% simultaneously in one document.
+%
+% 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{booklet} 
+% package and 
+% commented source code is in Section~\ref{sec:code}. Timothy Van Zandt's
+% original macros and documentation are supplied in the appendices.
+%
+%
+%
+% \section{The \Lpack{booklet} package} \label{sec:usc}
+%
+% The code provided by the \Lpack{booklet} package is meant to help
+% with some aspects of booklet printing.
+%
+%    Basically, the pages of documents processed with the \Lpack{booklet}
+% package will be reordered and scaled so that they can be printed as
+% four pages per physical sheet of paper, two pages per side of the
+% sheet. The default expectation is that the original document is in
+% a portrait orientation and the pages are printed rotated onto a landscape
+% sheet. Folding the sheet in half will produce a half-sized document, again
+% with portrait orientation.
+%
+%    Professionally printed books have many pages printed per sheet of (large)
+% paper, which is then folded and cut where necessary to produce a 
+% \emph{signature} of several smaller sheets. Folding a sheet in
+% half produces a one sheet \emph{folio} signature with four pages. 
+% Folding it in half again and cutting
+% along the original fold gives a two sheet \emph{quarto} signature 
+% with eight pages. Folding in half again, 
+% results in a four sheet \emph{octavo} signature with 16 pages, and so on
+% through \emph{16mo}, \emph{32mo}, to \emph{64mo} with six folds and 128 pages. 
+% \emph{Octavo} is the most popular of these.
+%
+%  Other folds can produce other signatures. For example a \emph{sexto},
+% obtained by folding in half and then folding in thirds, is a three sheet
+% signature with 12 pages.
+%
+%    The main differences between the \Lpack{2up} macros and the 
+% \Lpack{booklet} package are:
+% \begin{itemize}
+% \item \Lpack{2up} is generic but \Lpack{booklet} can only be used
+%       with (pdf)LaTeX.
+% \item \Lpack{2up} can be used for more than booklets
+% \item \Lpack{booklet} adds the notion of signatures and reduces the need for |\box|es.
+% \item \Lpack{booklet} adds means of automatically controlling 
+%       portrait/landscape printing.
+% \end{itemize}
+%
+% \subsection{Options}
+%
+% When the \Lopt{noprint} option is used the package is essentially vacuous.
+% That is, it behaves as though it had not been used at all, with the
+% exception that LaTeX will not hiccup at any of the package commands that
+% may be used in the document; these commands will also do nothing.
+%
+% The \Lopt{print} option must be used if you want the package to work 
+% as advertised. The reasons for the \Lopt{print} and \Lopt{noprint}
+% options are explained later in Section~\ref{sec:usage}.
+%
+%    The \Lpack{booklet} package can also take one option from each of
+% two groups.
+%
+%    The first group of options specifies how many pages there should be
+% to a hypothetical signature. The options are: \Lopt{four}, \Lopt{eight},
+% \Lopt{sixteen}, and \Lopt{thirtytwo}. TeX has to hold all the pages
+% for a signature before it outputs any of them, and TeX is memory limited.
+%
+%     If you have a duplex printer you can print out the document double-sided
+% and then just fold the sheets forming each signature ready for binding.
+% If you don't have a duplex printer, then the sheets can be photocopied
+% (1-to-2 sided) ready for folding.
+%
+%    The second group of options are for selecting one of the package's
+% predefined layouts. These options include:
+% \begin{itemize}
+% \item[\Lopt{twouparticle}] --- for portrait pages with wide margins
+%     (similar to those in the standard LaTeX \Lpack{article}, \Lpack{book}
+%      and \Lpack{report} classes)
+%     and no marginal notes, to go on landscape sheets.
+% \item[\Lopt{largetypeblock}] --- for portrait pages with a larger
+%      (wider and/or longer) typeblock 
+%   and/or marginal notes, to go on landscape sheets.
+% \item[\Lopt{1to1}] --- for portrait pages where the original is 
+%      designed to fit on half-sized paper, to go on landscape sheets.
+% \item[\Lopt{landscape}] --- for landscape pages to go onto
+%      portrait sheets. Pairs of original landscape pages will be
+%      printed at the top and bottom of a portrait page.
+%      This option is called automatically if the
+%      \Lopt{landscape} option is used for the document class.
+%
+% \end{itemize}
+%
+%    The default options are \Lopt{noprint}, \Lopt{twouparticle} and 
+% \Lopt{thirtytwo}.
+%
+% \subsection{Commands}
+%
+% The \emph{source} is the document as it would
+% be normally typeset by LaTeX (i.e., without using the \Lpack{booklet}
+% package).
+%
+% The \emph{target} is the desired document as it should 
+% be printed
+% using the \Lpack{booklet} package.
+%
+% \DescribeMacro{\source}
+% The command |\source{|\meta{mag}|}{|\meta{width}|}{|\meta{height}|}|
+% specifies the source sheets, where
+% \meta{width} and \meta{height} are the width and height for the
+% pages of the orginal document (the document that LaTeX would process
+% without the \Lpack{booklet} package). The \meta{mag} argument is the
+% magnification factor. 
+%
+%    The default definition of |\source| is: \\
+% |\source{\magstep0}{\paperwidth}{\paperheight}| \\
+% which corresponds to a full size default page.
+%
+% \DescribeMacro{\target}
+% The command |\target{|\meta{mag}|}{|\meta{width}|}{|\meta{height}|}|
+% specifies the target sheets, where
+% \meta{width} and \meta{height} are the width and height for the
+% sheets that will be used for printing with the package. For
+% example, |\target{...}{11in}{8.5in}| would be typical for a 
+% (portrait letterpaper)
+% source being put onto a (landscape) letterpaper target.
+%
+% \DescribeMacro{\magstepN}
+% \DescribeMacro{\magstepminusN}
+% The package puts two pages onto a single sheet. It often happens that
+% in order to do this the natural size of the text pages has to be changed,
+% via the \meta{mag} argument noted above. The macro |\magstepminusN|,
+% where $0 \leq N \leq 5$ is a shrinkage factor; similary, |\magstepN|
+% specifies a magnification factor. For example, the default |\target|
+% is specified as: \\
+% |\target{\magstepminus1}{\paperheight}{\paperwidth}| \\
+% whereas the target for the \Lopt{largetypeblock} option is: \\
+% |\target{\magstepminus2}{\paperheight}{\paperwidth}| \\
+% which shrinks the original pages more than the default |\target| does.
+%
+%    The \Lpack{booklet} package uses the |\source| and |\target| 
+% specifications to decide on how to scale and position the orginal
+% full size source pages onto half of a target sheet.
+%
+%    Normally there is no need to change the default |\source| but it
+% may be useful sometimes to change the |\target|. For example, if the
+% text on source letterpages is very wide it could be useful to print
+% on legal paper instead. In this case |\target| can be defined as: \\
+% |\target{\magstepminus2}{14in}{8.5in}|
+%
+% \DescribeMacro{\pagespersignature}
+% If none of the signature options are suitable, then 
+% |\pagespersignature{|\meta{num}|}| may be used to specify \meta{num}
+% pages per signature. For example, if you wanted a \emph{sexto} signature
+% then use |\pagespersignature{12}|.
+%
+% \DescribeMacro{\ifprintoption}
+% The command |\ifprintoption| is set TRUE if the \Lopt{print} option 
+% is used otherwise it is set FALSE.
+%
+% \DescribeMacro{\setdvipstargetpages}
+% If you are using LaTeX to generate a \file{.dvi} file the
+% |\setdvipstargetpages| macro sets up the correct target page sizes 
+% in the \file{.dvi} file assuming that subsequent processing will be
+% via a program that understands \file{dvips} \cs{special} commands.
+% 
+% \DescribeMacro{\setpdftargetpages}
+% If you are using pdfLaTeX to generate a \file{.pdf} file the
+% |\setpdftargetpages| macro sets up the correct target page sizes for
+% pdfLaTeX.
+%
+% \DescribeMacro{\pagesepwidth}
+% \DescribeMacro{\pageseplength}
+% \DescribeMacro{\pagesepoffset}
+%  A line may be drawn between the output text pages. The length of
+% the line is |\pageseplength| (default 6.5in), and line starts a
+% distance |\pagesepoffset| from the bottom (side) of the printed sheet
+% (default 1in). The line thickness is specified by the length
+% |\pagesepwidth|, which is initially defined to be 0pt (i.e., the
+% line is normally invisible). To see a dividing line use |\setlength|
+% to change the value of |\pagesepwidth|; in LaTeX ruled lines normally
+% have a thickness of 0.4pt.
+%
+% \DescribeMacro{\twoupclearpage}
+% \DescribeMacro{\twoupemptypage}
+% The command |\twoupclearpage| outputs the current target page (like
+% LaTeX's |\newpage|). The command |\twoupemptypage| inserts a completely
+% empty page into the target.
+%
+% \DescribeMacro{\ifuselandscape}
+% \DescribeMacro{\ifprintoption}
+% The command |\ifuselandscape| is set TRUE if the \Lopt{landscape} option 
+% is used otherwise it is set FALSE.
+%
+% \DescribeMacro{\checkforlandscape}
+% The macro |\checkforlandscape| evaluates the value of |\ifprintoption|
+% and the current value of |\ifuselandscape| and sets |\ifuselandscape| 
+% to TRUE if the document
+% requires landscape printing (when either both the \Lopt{landscape} and 
+% \Lopt{noprint} options are used, or when just the \Lopt{print}
+% option is called for), 
+% or to FALSE if the document should be printed in the normal portrait 
+% orientation (when either both the \Lopt{landscape} and \Lopt{print}
+% options are used, or when just the \Lopt{noprint} option is used without
+% \Lopt{landscape}). 
+%
+% Note that as |\checkforlandscape| may change the value of
+% |\ifuselandscape|, the command is only guaranteed when |\ifuselandscape|
+% accurately indicates the presence or absence of the \Lopt{landscape}
+% option.
+%
+% In version 0.7 of the package the macro \cs{setdvipstargetpages} was
+% introduced and the macro \cs{setpdftargetpages} was modified with the
+% result that \cs{checkforlandscape} was effectively
+% no longer needed. It is left to maintain upward compatibilty for
+% older documents.
+%
+%
+% \subsection{Usage} \label{sec:usage}
+%
+%     You use the \Lpack{booklet} package just like any other package: \\
+% |\usepackage[<options>]{booklet}| \\
+% but some other things need taking care of as well.
+%
+%    If you are making any changes to the values of |\paperwidth| or
+% |\paperheight|, say through the \Lpack{geometry} package or the
+% \Lpack{memoir} class, then the \Lpack{booklet} package must be called
+% \emph{after} those changes have been made. In this case you may have
+% to specify a different |\source| than usual, but I think that this
+% is probably unlikely.
+%
+%
+% \DescribeMacro{\special}
+%    Under normal circumstances printing should be done onto landscape
+% oriented paper instead of the usual portrait orientation. If you are
+% using the \file{dvips} program for transformation from the \file{.dvi}
+% to a \file{.ps} file, then you can use the command |\special{landscape}|
+% in the preamble so that the output is organised for landscape. Other
+% drivers may support similar commands, or command line options for
+% accomplishing this.
+%
+%    For example, it may happen that if you use \file{ghostview} (or
+% \file{gsview}) to look at \file{dvips} PostScript output of the final
+% printing that the text appears upside down. Putting: \\
+% \verb?\special{!TeXDict begin /landplus90{true}store end}? \\
+% just before the \verb?\begin{document}? may cure this.
+%
+%    I use a LaserJet printer with a duplex printing capability (i.e.,
+% printing can be done on both sides of a sheet in one pass). When
+% printing in duplex mode I also found that it was very convenient
+% to change the binding from the long to the short side of the paper;
+% the sheets were then all set for folding. Using \file{dvips} and
+% the 5SiMx LaserJet I found that the following commands in the
+% preamble let me change the printer settings from the document.
+% \begin{verbatim}
+% \special{!TeXDict begin <</Duplex true>> setpagedevice end} % duplex
+% \special{!TeXDict begin <</Tumble true>> setpagedevice end} % short binding
+% \end{verbatim}
+% How these would fare with another printer or program, I have no idea.
+% The CTAN subdirectory \texttt{/dviware/dvipsconfig} contains a
+% set of files for performing the above operations, and more, 
+% as command line options for \file{dvips}.
+%
+%    If you can only do simplex printing (one side only), then when
+% photocopying from one-sided to two-sided, alternate printed pages
+% need to be rotated 180 degrees before being fed into the copier.
+%
+%    The following physical analogy of how the package works with
+% portrait pages may help in achieving results that you want.
+%
+% \begin{itemize}
+% \item Write the original text on portrait oriented transparent 
+%       material (e.g., viewfoils) which is the same size as that 
+%       specified by the |\source| macro. Mark the centre --- the 
+%       point where the diagonals intersect --- of each original page.
+%
+% \item Take a sheet of paper the same size as that specified by
+%       the |\target| macro and in landscape orientation. Mentally
+%       divide this in half by a vertical line and then mark the centre
+%       points of the two (left and right) halves.
+% \item Take an even numbered original sheet, portrait orientaion,
+%       and place it on top of the landscape oriented target sheet
+%       with its centre point coincident with the left half centre
+%       point. Do the same with an odd numbered original sheet except
+%       that its centre is coincident with the right half centre point.
+% \item Take the assembly to a photocopier and make a copy onto a target
+%       sized sheet. This is the final result.
+% \end{itemize}
+% The analogy for landscape originals is similar with the obvious changes
+% in the orientations.
+%
+%    Not that the analogy does not include any scaling. If the size of 
+% the target is relatively small then the texts on the original sheets
+% may overlap or extend outside the physical target sheet. If the target
+% is relatively large then there may be too much white space around the
+% texts. The \meta{mag} arguments to the |\source| and |\target| macros
+% are provided to adjust the source/target text sizes. Scaling does
+% not affect the positions of the texts.
+%
+%    If you are planning to produce a booklet in the first place, then
+% design the initial page layout as though it would be printed on half-sized
+% paper. This will produce a better end result as no scaling will
+% be necessary. The \Lopt{1to1} option is provided for just this case.
+%
+%   If the original pages look too crowded after printing, you can specify
+% another |\target| with a larger shrink factor (e.g., |\magstepminus3|
+% instead of |\magstepminus2|). Conversely, too much white space can be
+% countered by decreasing the shrink factor (e.g., |\magstepminus1|
+% instead of |\magstepminus2|).
+%
+% The following are the default settings of |\source| and |\target| (the
+% source and target sheets are the same size) for the different layout 
+% options.
+% \begin{itemize}
+% \item[\Lopt{twouparticle:}] \mbox{} \\
+%    |\source{\magstep0}{\paperwidth}{\paperheight}| \\
+%    |\target{\magstepminus1}{\paperheight}{\paperwidth}| \\
+% \item[\Lopt{largetypeblock:}] \mbox{} \\
+%    |\source{\magstep0}{\paperwidth}{\paperheight}| \\
+%    |\target{\magstepminus2}{\paperheight}{\paperwidth}| \\
+% \item[\Lopt{1to1:}] \mbox{} \\
+%    |\source{\magstep0}{\paperwidth}{\paperheight}| \\
+%    |\target{\magstep0}{\paperheight}{\paperwidth}| \\
+% \end{itemize}
+%
+%    If the original is not planned to be produced as a booklet, then
+% obtaining respectable looking full size and booklet results may
+% require some trial and error in determining good values for 
+% magnifications and/or target paper sizes. The original page margins
+% may also need changing for the booklet output.
+%
+%    LaTeX is not very happy if it is forced to save some pages instead
+% of outputting each one as it is finished. It shows its displeasure
+% by messing up any internal references in the document, for example
+% a Table of Contents or an Index. To counter this, run LaTeX on the
+% document \emph{without} the \Lopt{print} package option
+% until all references
+% have stabilised. Then put the command |\nofiles| in the preamble, use
+% the \Lopt{print} option, 
+% and run LaTeX a final time before printing.
+% (The |\nofiles| command stops LaTeX from generating new \file{.aux},
+% \file{.toc} files, etc., but it will still use any old versions).
+%
+% The following gives an indication of how the relevant portion of
+% a preamble may look.
+% \begin{verbatim}
+% % possibly change default \paperwidth and/or \paperheight
+% % \usepackage[noprint,...]{booklet}         % use this 
+% % \usepackage[...]{booklet}                 % or this for initial runs
+% % \usepackage[print, ...]{booklet} \nofiles % use this for final run
+% % perhaps change \target
+% \ifpdf                         % from the ifpdf package
+%   \pdfoutput = 1               % generate pdf output
+%   \setpdftargetpages           % set output page size
+% \else
+%   \setdvipstargetpages         % use this for dvi output
+% \fi
+% ...
+% \end{verbatim}
+% It is safer to use the package without the \Lopt{print} option for
+% the initial runs rather than not using the package at all; doing it
+% this way will stop LaTeX from complaining if you happened to have
+% used any of the \Lpack{booklet} commands in the document.
+%
+%    TeX allocates a new box for each page in the first signature and then these
+% are reused for each subsequent signature. Large
+% signatures may use up all available boxes in which case
+% TeX will tell you. It is much more probable, though, that TeX will
+% run out of memory before this happens. 
+%
+%     Here is a real example of one booklet setup for typesetting a 68 page
+% book. I used the \Lpack{memoir}
+% class but afterwards I'll point out how to do the equivalent with the
+% \Lpack{book} class.
+% \begin{verbatim}
+% \documentclass[letterpaper,11pt]{memoir}
+% % typeblock size of 5.5+ by 4 inches
+% \settypeblocksize{5.5in}{4in}{*}
+% \addtolength{\textheight}{\onelineskip}
+% \setlrmargins{2in}{*}{*}
+% \setulmargins{2.25in}{*}{*}
+% \checkandfixthelayout
+% 
+% % \usepackage[noprint]{booklet}
+% \usepackage[print,1to1]{booklet} \nofiles 
+% \pagespersignature{16} % 16 pages per signature
+% 
+% \ifpdf
+%   \setpdftargetpages
+% \else
+%   \setdvipstargetpages
+% \fi
+% \ifprintoption  % tweak dvi output only for final printing
+%   \special{!TeXDict begin /landplus90{true}store end}
+%   \special{!TeXDict begin <</Tumble true>> setpagedevice end}
+% \fi
+%
+% \begin{document}
+% \pagestyle{empty}
+% % Want a blank sheet before the title page
+% \hbox{}\cleardoublepage
+% % half-title page here
+% \cleardoublepage
+% 
+% % title page here
+% \clearpage
+% 
+% % copyright page here
+% \cleardoublepage
+% 
+% \pagestyle{plain}
+% \pagenumbering{roman}
+% \tableofcontents*
+% \cleardoublepage
+% \pagenumbering{arabic}
+% \pagestyle{headings}
+% 
+% \chapter{First}
+% % and so on
+% 
+% % want some blank endpapers to get enough pages into
+% % the last signature for easy binding
+% \clearpage
+% \hbox{}\clearpage\hbox{}\cleardoublepage
+% \end{document}
+% \end{verbatim}
+%
+% Using the \Lpack{book} class just involves changing how the page layout
+% is specified:
+% \begin{verbatim}
+% \documentclass[letterpaper,11pt]{book}
+% % typeblock size of 5.5 by 4 inches
+% \setlength{\textheight}{419pt} \setlength{\textwidth}{289pt}
+% \setlength{\oddsidemargin}{72pt} \setlength{\evensidemargin}{108pt} 
+% \setlength{\topmargin}{55.9pt} \setlength{\footskip}{27.5pt} 
+% \setlength{\headheight}{14.6pt} \setlength{\headsep}{19.9pt} 
+%
+% % \usepackage[noprint]{booklet}
+% ...
+% \end{verbatim}
+%
+%    If you try and use a non-zero magnification with a document that
+% has any `true' lengths, for example the \Lpack{amsbook} class, 
+% TeX itself will complain with an error message
+% of the form: \\
+% |!Incompatible magnification (833);| \\
+% |the previous value will be retained|\\
+% Try forcing LaTeX to continue and check the output because you might
+% be lucky and it looks alright.
+%
+% \changes{v0.7a}{2005/06/01}{Added Gordo's example}
+%    Here is another example from a posting to \texttt{comp.text.tex} by
+% Gordo in the thread \textit{booklet problem}, 2005/05/26.
+% \begin{verbatim}
+% \documentclass[twoside,10pt]{article}
+% \setlength{\paperwidth}{5.5in}
+% \setlength{\paperheight}{8.5in}
+% \setlength{\topmargin}{-0.3in}
+% \setlength{\textheight}{6.9in}
+% \setlength{\oddsidemargin}{0.0in}
+% \setlength{\evensidemargin}{-0.5in}
+% \setlength{\textwidth}{4.0in}
+% \usepackage{makeidx}
+% %\usepackage[noprint,1to1]{booklet} % initial runs for ToC and index
+% \usepackage[noprint,1to1]{booklet} \nofiles % final printing run
+% \source{\magstep0}{5.5in}{8.5in}
+% \target{\magstep0}{11in}{8.5in}
+% \setpdftargetpages
+% \pagespersignature{120}
+% \makeindex
+% \begin{document}
+% \pagenumbering{roman}
+% \begin{titlepage} ... \end{titlepage} % the title
+% ...
+% \newpage
+% \begin{titlepage} \mbox{} \end{titlepage} % back cover
+% \end{document}     
+% \end{verbatim}
+%
+%
+% \changes{v0.7a}{2005/06/01}{Added example for bookleting the manual}
+% As yet another example, you can produce this manual as a booklet. Change
+% the first part of this file to read:
+% \begin{verbatim}
+% \documentclass[twoside]{ltxdoc}
+% \usepackage{url}
+% \usepackage{ifpdf}
+% \addtolength{\evensidemargin}{-0.75in}
+% % \usepackage[noprint]{booklet} % initial runs
+% \usepackage[print,largetypeblock]{booklet}\nofiles\pagespersignature{48} % final run
+% %\usepackage[draft=false,
+% %            plainpages=false,
+% %            pdfpagelabels,
+% %            bookmarksnumbered,
+% %            hyperindex=false
+% %           ]{hyperref}
+% \ifpdf
+%   \setpdftargetpages
+% \else
+%   \setdvipstargetpages
+% \fi
+% \providecommand{\phantomsection}{}
+% \makeatletter
+%   \@mparswitchfalse
+% \makeatother
+% ...
+% \end{verbatim}
+% The \Lpack{hyperref} package interferes with the \cs{setpdftargetpages}
+% macro so it is commented out. The \Lopt{largetypeblock} option is used
+% otherwise the marginal notes can fall off the edges of the pages in the
+% final printing; the \cs{evensidemargin} is also altered for the same reason.
+% The value for \cs{pagespersignature} is to ensure that
+% only a single signature is produced (you can decrease this if you are
+% willing to bind multiple signatures).
+%
+%
+%    The original source of the \Lpack{2up} package is included at
+% the end of this manual. It may provide some more insights into how to
+% use the \Lpack{booklet} package. Be careful, though, as the two packages
+% differ in some significant details.
+%
+%
+%
+% \StopEventually{
+% \bibliographystyle{alpha}
+% \begin{thebibliography}{GMS94}
+% \bibitem[GMS94]{GOOSSENS94}
+% Michel Goossens, Frank Mittelbach, and Alexander Samarin.
+% \newblock \emph{The LaTeX Companion}.
+% \newblock Addison-Wesley Publishing Company, 1994.
+% \bibitem[Zan93]{2UP}
+% Timothy Van Zandt.
+% \newblock \emph{Two-up printing for Generic TeX}.
+% \newblock January 1993.
+% \newblock (Available from CTAN in \texttt{macros/generic/2up})
+% \end{thebibliography}
+% }
+%
+%
+% \section{The package code} \label{sec:code}
+%
+% The package code essentially consists of modifications to the \Lpack{2up}
+% macros, which are given in section~\ref{sec:2upcode}. I could not
+% have written the \Lpack{booklet} package without Timothy Van Zandt's
+% \Lpack{2up} macros.
+%
+%    As much as possible I have tried to keep to the original
+% \Lpack{2up} macro names. However, the \Lpack{2up} and \Lpack{booklet}
+% packages cannot be used in the same document.
+%
+%    The code is actually in two packages, \file{booklet.sty} which 
+% provides the commands that 
+% the user sees, and \file{bkltprnt.sty} which is used by 
+% \file{booklet.sty} to do all the hard work.
+%
+% \subsection{Preliminaries}
+%
+%    Announce the name and version of the packages, which require
+% \LaTeXe.
+%    \begin{macrocode}
+%<*usc>
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{booklet}[2005/03/23 v0.7 booklet printing]
+
+%</usc>
+%<*prnt>
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{bkltprnt}[2005/03/23 v0.7 support for booklet printing]
+
+%</prnt>
+%    \end{macrocode}
+%
+% \subsection{The main \Lpack{booklet} code}
+%
+%    The \Lpack{booklet} package provides the user commands. Then, if
+% the \Lopt{print} option is used it calls the \Lpack{bkltprnt}
+% package to do the work.
+%
+%    \begin{macrocode}
+%<*usc>
+%    \end{macrocode}
+%
+% \begin{macro}{\twoup@end}
+%  For the \Lopt{print} and \Lopt{noprint} options.
+%    \begin{macrocode}
+\newcommand*{\twoup@end}{\endinput}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\pageseplength}
+% \begin{macro}{\pagesepwidth}
+% \begin{macro}{\pagesepoffset}
+% Lengths for the dividing rule.
+%    \begin{macrocode}
+\newdimen\pageseplength
+\newdimen\pagesepwidth
+\newdimen\pagesepoffset
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\ifsidebyside}
+% TRUE if pages are to be placed side-by-side on the sheet. I have changed
+% the original |\if@sidebyside| to |\ifsidebyside| so that a user can
+% call it easily. I don't
+% don't implement the |\if@twosided|.
+%    \begin{macrocode}
+\newif\ifsidebyside
+  \sidebysidetrue
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ifuselandscape}
+% \begin{macro}{\ifprintoption}
+% Booleans for some options and for if the final printing should be landscape.
+%    \begin{macrocode}
+\newif\ifuselandscape
+  \uselandscapefalse
+\newif\ifprintoption
+  \printoptionfalse
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\c@signature}
+% \begin{macro}{\c@sigcount}
+% Counters for signature handling.
+%    \begin{macrocode}
+\newcounter{signature}
+\newcounter{sigcount}
+  \setcounter{sigcount}{0}
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\pagespersignature}
+% A user-level command for setting the number of pages wanted
+% in a signature. I initialise these to 32.
+%    \begin{macrocode}
+\newcommand*{\pagespersignature}[1]{\setcounter{signature}{#1}}
+  \pagespersignature{32}
+
+%    \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\magstepminus}
+% A useful extension of the |\magstep| macro.
+%    \begin{macrocode}
+\def\magstepminus#1{%
+  \ifcase#1 \@m\or 833\or 694\or 579\or 482\or 401\fi\relax}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\target}
+% \begin{macro}{\source}
+% \begin{macro}{\setpdftargetpages}
+% \begin{macro}{\setdvipstargetpages}
+% Vacuous versions of the user-level macros.
+% \changes{v0.7}{3005/03/23}{Added \cs{setdvipstargetpages}}
+%    \begin{macrocode}
+\newcommand*{\target}[3]{}
+\newcommand*{\source}[3]{}
+\newcommand*{\setpdftargetpages}{}
+\newcommand*{\setdvipstargetpages}{}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\targettopbottom}
+% Vacuous version of the user command.
+%    \begin{macrocode}
+\newcommand*{\targettopbottom}{}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\twoupemptypage}
+% \begin{macro}{\twoupclearpage}
+% vacuous versions of the user commands.
+%    \begin{macrocode}
+\newcommand*{\twoupemptypage}{}
+\newcommand*{\twoupclearpage}{}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\checkforlandscape}
+% Sets the value of |\ifuselandscape| to 
+% (|\ifuselandscape| XOR |\ifprintoption|).
+%    \begin{macrocode}
+\newcommand*{\checkforlandscape}{%
+  \ifx\ifuselandscape\ifprintoption
+    \uselandscapefalse\else\uselandscapetrue\fi}
+
+%    \end{macrocode}
+% \end{macro}
+%
+%    Now declare the \Lopt{print}, \Lopt{noprint} and \Lopt{landscape}
+% options, 
+% prepare to pass any other
+% options to \Lpack{bkltprnt}, and execute the options.
+%    \begin{macrocode}
+\DeclareOption{print}{\printoptiontrue\def\twoup@end{}}
+\DeclareOption{noprint}{\printoptionfalse\def\twoup@end{\endinput}}
+\DeclareOption{landscape}{\uselandscapetrue}
+\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{bkltprnt}}
+\ProcessOptions\relax
+\ifuselandscape
+  \PassOptionsToPackage{landscape}{bkltprnt}
+\fi
+
+%    \end{macrocode}
+%
+%  Now call |\twoup@end|, which is either |\endinput| or vacuous, after
+% which the \Lpack{bkltprnt} package is called (if |\twoup@end| was vacuous).
+%    \begin{macrocode}
+\twoup@end
+
+\RequirePackage{bkltprnt}
+
+%    \end{macrocode}
+%
+%
+%    The end of this package.
+%
+%    \begin{macrocode}
+%</usc>
+%    \end{macrocode}
+%
+% \subsection{The main \Lpack{bkltprnt} code}
+%
+%    \begin{macrocode}
+%<*prnt>
+%    \end{macrocode}
+%
+% \begin{macro}{\@targetwidth}
+% \begin{macro}{\@targetheight}
+% \begin{macro}{\@sourcewidth}
+% \begin{macro}{\@sourceheight}
+% Parameter registers.
+%    \begin{macrocode}
+\newdimen\@targetwidth
+\newdimen\@targetheight
+\newdimen\@sourcewidth
+\newdimen\@sourceheight
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\if@leftpage}
+% \begin{macro}{\@leftpage}
+% \begin{macro}{\@rightpage}
+% \begin{macro}{\@physicalpage}
+% Registers used by output routine.
+%    \begin{macrocode}
+\newif\if@leftpage
+  \@leftpagetrue
+\newbox\@leftpage
+\newbox\@rightpage
+\newcount\@physicalpage
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+%
+% Since pages are both stored and shipped out half as often:
+%    \begin{macrocode}
+\multiply\maxdeadcycles by 40\relax
+
+%    \end{macrocode}
+%
+% \begin{macro}{\bookletpage}
+% \begin{macro}{\leftpagenumber}
+% \begin{macro}{\rightpagenumber}
+% Registers used only for booklet layout. These are specified directly
+% as this is the only layout.
+%    \begin{macrocode}
+\newcount\bookletpage
+  \bookletpage=0
+\newcount\leftpagenumber
+\newcount\rightpagenumber
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\twoupp@geboxes}
+% I have added this macro so that only the boxes required for a signature
+% are created. The original \Lpack{2up} code creates a new box for each output page.
+% \changes{v0.6}{2001/08/26}{Added \cs{twoupp@geboxes}}
+%    \begin{macrocode}
+\newcommand*{\twoupp@geboxes}{%
+  \advance\bookletpage\@ne
+  \expandafter\newbox\csname bookletbox\the\bookletpage\endcsname
+  \ifnum \bookletpage < \c@signature
+    \twoupp@geboxes
+  \fi}
+\AtBeginDocument{\twoupp@geboxes\bookletpage=\z@}
+
+%    \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\target}
+% \begin{macro}{\inv@targetmag}
+% |\@targetwidth| and |\@targetheight| are set to the \emph{unmagnified} 
+% dimensions
+% of the target page. |\inv@targetmag| is the inverse of the target
+% magnification.
+%    \begin{macrocode}
+{\catcode`\p=12\catcode`\t=12\gdef\@@inv@@mag#1pt#2{\def#2{#1}}}
+\def\target#1#2#3{%
+  \mag #1\relax
+  \@targetwidth=1000pt
+  \divide\@targetwidth by #1\relax
+  \expandafter\@@inv@@mag\the\@targetwidth\inv@targetmag
+  \@targetwidth=#2\relax
+  \@targetwidth=\inv@targetmag\@targetwidth
+  \@targetheight=#3\relax
+  \@targetheight=\inv@targetmag\@targetheight}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\source}
+% Like |\target|, but for the source:
+%    \begin{macrocode}
+\def\source#1#2#3{%
+  \@sourcewidth=1000pt
+  \divide\@sourcewidth by #1\relax
+  \expandafter\@@inv@@mag\the\@sourcewidth\inv@sourcemag
+  \@sourcewidth=#2\relax
+  \@sourcewidth=\inv@sourcemag\@sourcewidth
+  \@sourceheight=#3\relax
+  \@sourceheight=\inv@sourcemag\@sourceheight}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\setpdftargetpages}
+% This macro specifies the size of the target page for pdfLaTeX.
+% It ensures that \Lpack{memoir}'s version (\cs{fixpdflayout}) does nothing.
+% \changes{v0.7}{2005/03/23}{Modified \cs{setpdftargetpages} to cater for memoir}
+%    \begin{macrocode}
+\renewcommand*{\setpdftargetpages}{%
+  \ifprintoption
+    \setlength{\pdfpageheight}{\@targetheight}%
+    \setlength{\pdfpagewidth}{\@targetwidth}%
+    \let\fixpdflayout\relax
+  \fi}
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\setdvipstargetpages}
+% This macro specifies the size of the target page fow when dvips is
+% used. It ensures that \Lpack{memoir}'s version (\cs{fixdvipslayout}) 
+% does nothing.
+% \changes{v0.7}{2005/03/23}{Implemented \cs{setdvipstargetpages}}
+%    \begin{macrocode}
+\renewcommand*{\setdvipstargetpages}{%
+  \ifprintoption
+    \AtBeginDvi{\special{papersize=\the\@targetwidth,\the\@targetheight}}%
+    \let\fixdvipslayout\relax
+  \fi}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\targetBooklet}
+% \begin{macro}{\ship@@@leftpage}
+% \begin{macro}{\ship@@@rightpage}
+% I only provide the original \Lpack{2up} Booklet, not booklet. For
+% the \Lpack{booklet} package the Booklet code can be processed
+% immediately. The code in this chunk is equvalent to the original
+% |\target@Booklet|.
+%    \begin{macrocode}
+\def\targetBooklet{%
+  \def\ship@@@leftpage{\save@booklet\@leftpage}%
+  \def\ship@@@rightpage{\save@booklet\@rightpage}%
+  \@leftpagefalse}
+\targetBooklet
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\targettopbottom}
+% \begin{macro}{\make@@halfpage}
+% \begin{macro}{\make@fullpage}
+% I have renamed the original |\target@topbottom| to |\targettopbottom|
+%    \begin{macrocode}
+\def\targettopbottom{%
+  \def\make@@halfpage{\make@@halftopbottom}%
+  \def\make@fullpage{\make@fulltopbottom}%
+  \sidebysidefalse}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% Specify the options. There are new ones for signature sizes, and some
+% of the original \Lpack{2up} source/targets are now treated as options.
+%    \begin{macrocode}
+\DeclareOption{four}{\setcounter{signature}{4}}
+\DeclareOption{eight}{\setcounter{signature}{8}}
+\DeclareOption{sixteen}{\setcounter{signature}{16}}
+\DeclareOption{thirtytwo}{\setcounter{signature}{32}}
+\DeclareOption{twouparticle}{\twouparticle}
+\DeclareOption{landscape}{\twouplandscape}
+\DeclareOption{largetypeblock}{\twoupplain}
+\DeclareOption{1to1}{\twouponetoone}
+
+%    \end{macrocode}
+%
+% \begin{macro}{\shipout}
+% TeX's |\shipout| primitive is saved as |\&normal@shipout|, 
+% and then |\shipout|
+% is defined to save each page to |\@leftpage| or |\@rightpage| 
+% and to print out every two. There is no twosided layout in this version.
+%    \begin{macrocode}
+\expandafter\let\csname &normal@shipout\endcsname\shipout
+\def\shipout{%
+  \if@leftpage
+    \global\@leftpagefalse
+    \def\next{\afterassignment\ship@leftpage\global\setbox\@leftpage=}%
+  \else
+    \global\@leftpagetrue
+    \def\next{\afterassignment\ship@rightpage\global\setbox\@rightpage=}%
+  \fi
+  \next}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ship@leftpage}
+% \begin{macro}{\ship@rightpage}
+% The job of |\ship@leftpage| and |\ship@rightpage| is to invoke 
+% |\ship@@leftpage| or |\ship@@rightpage| at the right time. 
+% |\shipout| is followed either:
+% \begin{enumerate}
+% \item by an |\hbox|, |\vbox| or |\vtop|, in which case 
+% |\ship@leftpage| is invoked after the opening |{|; 
+% |\@leftpage| is void, and |\ship@leftpage| invokes
+% |\ship@@leftpage| after the closing |}|: or
+%
+% \item by a |\box| or |\copy|, in which case |\ship@leftpage| is invoked after
+% the full assignment; |\@leftpage| is not void, and |\ship@leftpage| invokes
+% |\ship@@leftpage| immediately.
+% \end{enumerate}
+%
+%    \begin{macrocode}
+\def\ship@leftpage{%
+  \ifvoid\@leftpage\aftergroup\ship@@leftpage\else\ship@@leftpage\fi}
+\def\ship@rightpage{%
+  \ifvoid\@rightpage\aftergroup\ship@@rightpage\else\ship@@rightpage\fi}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\ship@@leftpage}
+% \begin{macro}{\ship@@rightpage}
+%     |\ship@@leftpage|/|\ship@@rightpage| take the output box, 
+% and first make it
+% into a fully-size source page (with |\make@halfpage|) and then this is
+% centered horizontally and vertically in half of a target page (with
+% |\make@@halfpage|). Then they are shipped individually or together.
+%    \begin{macrocode}
+\def\ship@@leftpage{\make@halfpage\@leftpage\ship@@@leftpage}
+\def\ship@@rightpage{\make@halfpage\@rightpage\ship@@@rightpage}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\make@halfpage}
+%    \begin{macrocode}
+\def\make@halfpage#1{%
+  \dp#1=\z@
+  \setbox#1=\vbox to\@sourceheight{%
+    \vskip \inv@sourcemag in
+    \vskip \voffset
+    \hbox to\@sourcewidth{\hskip\inv@sourcemag in\hskip\hoffset\box#1\hss}%
+    \vss}%
+  \make@@halfpage#1}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\make@@halfsidebyside}
+% \begin{macro}{\make@@halfpage}
+% The definition of |\make@@halfpage| depends on the target layout.
+%    \begin{macrocode}
+\def\make@@halfsidebyside#1{%
+  \global\setbox#1=\vbox to\@targetheight{\vss
+    \hbox to.5\@targetwidth{\hss\box#1\hss}\vss}}
+\def\make@@halfpage{\make@@halfsidebyside}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\make@@halftopbottom}
+%    \begin{macrocode}
+\def\make@@halftopbottom#1{%
+  \global\setbox#1=\vbox to.5\@targetheight{\vss
+    \hbox to\@targetwidth{\hss\box#1\hss}\vss}}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ship@twoup}
+% The pages are generaly shipped in pairs:
+%    \begin{macrocode}
+\def\ship@twoup{%
+  \begingroup
+    \voffset=-\inv@targetmag in
+    \hoffset=\voffset
+    \global\advance\@physicalpage by 1
+    \count\z@=\@physicalpage
+    \csname &normal@shipout\endcsname\make@fullpage
+  \endgroup}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\make@fullsidebyside}
+% \begin{macro}{\make@fulltopbottom}
+%    \begin{macrocode}
+\def\make@fullsidebyside{%
+  \hbox{\box\@leftpage\pagesep@sidebyside\box\@rightpage}}
+\def\make@fulltopbottom{%
+  \vbox{\offinterlineskip\box\@leftpage\pagesep@topbottom\box\@rightpage}}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\make@fullpage}
+% The definition of |\make@fullpage| depends on the layout:
+%    \begin{macrocode}
+\def\make@fullpage{\make@fullsidebyside}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\pagesep@sidebyside}
+% \begin{macro}{\pagesep@topbottom}
+% A vertical or horizontal rule can be inserted. These can be redefined
+% for other tricks:
+%    \begin{macrocode}
+\def\pagesep@sidebyside{%
+  \begingroup
+    \advance\pageseplength by \pagesepoffset
+    \pagesepwidth=\inv@targetmag\pagesepwidth
+    \kern -.5\pagesepwidth
+    \vrule height \inv@targetmag\pageseplength
+           depth -\inv@targetmag\pagesepoffset
+           width \pagesepwidth
+    \kern -.5\pagesepwidth
+  \endgroup}
+\def\pagesep@topbottom{%
+  \begingroup
+    \pagesepwidth=\inv@targetmag\pagesepwidth
+    \vskip -.5\pagesepwidth
+    \moveright\inv@targetmag\pagesepoffset\hbox{%
+      \vrule height\pagesepwidth width\inv@targetmag\pageseplength}%
+    \vskip -.5\pagesepwidth
+  \endgroup}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \changes{v0.7a}{2005/06/01}{Added sewing example}
+%    For example it may be helpful to mark the positions of sewing holes
+% along the spine of your booklet. For \Lopt{landscape} this can be done 
+% by redefining \cs{pagesep@topbottom} and for the more typical portrait 
+% style booklet by changing \cs{pagesep@sidebyside}. The general technique
+% is to use a zero-sized picture which \LaTeX{} will think takes up no space.
+% For instance, for letterpaper (11in by 8.5in) you can do something
+% like this in your preamble:
+% \begin{verbatim}
+% \makeatletter
+% \renewcommand*{\pagesep@sidebyside}{%
+%   \begingroup
+%   \setlength{\unitlength}{1in}%      measurements in inches
+%   \begin{picture}(0,0)(0,-8.5)%      zero-sized picture, origin at page top
+%     \put(0,-1){\makebox(0,0){.}}%    mark 1in down from top
+%     \put(0,-4.25){\makebox(0,0){.}}% mark at page center
+%     \put(0,-7.5){\makebox(0,0){.}}%   mark 1in up from bottom
+%   \end{picture}%
+%   \endgroup}
+% \makeatother
+% \end{verbatim}
+%
+% \begin{macro}{\save@booklet}
+% With the Booklet layout, the pages are saved rather than
+% shipped. I have added the signature code to the original macro. This
+% outputs all the pages making up a signature even if there are still more
+% to come. The page boxes used in |\save@booklet| are assigned initially
+% by |\twoupp@geboxes|.
+% \changes{v0.6}{2001/08/26}{Modified \cs{save@booklet}}
+%    \begin{macrocode}
+\begingroup
+\let\newbox\relax
+\gdef\save@booklet#1{%
+  \begingroup
+    \globaldefs=1
+    \ifnum\c@sigcount=\z@\bookletpage=0\fi
+    \advance\bookletpage by 1
+    \addtocounter{sigcount}{1}
+%%%%    \expandafter\newbox\csname bookletbox\the\bookletpage\endcsname
+    \expandafter\setbox\csname bookletbox\the\bookletpage\endcsname\box#1%
+  \endgroup
+  \ifnum\c@sigcount=\c@signature     %%% PW
+    \twoup@eject%           
+    \setcounter{sigcount}{0}%
+  \fi}
+\endgroup
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\make@bookletpage}
+% \begin{macro}{\booklet@loop}
+% \begin{macro}{\Booklet@@loop}
+% The pages are then printed at the end with the following macros:
+%    \begin{macrocode}
+\def\make@bookletpage#1{%
+  \setbox\ifodd#1\@rightpage\else\@leftpage\fi=%
+    \expandafter\box\csname bookletbox\the#1\endcsname}
+
+\def\booklet@loop{%
+  \count\z@\rightpagenumber
+  \make@bookletpage\leftpagenumber
+  \make@bookletpage\rightpagenumber
+  \ship@twoup
+  \Booklet@@loop
+}
+
+\def\Booklet@@loop{%
+  \advance\rightpagenumber by 1
+  \advance\leftpagenumber by -1
+  \ifnum\leftpagenumber<\rightpagenumber\else\expandafter\booklet@loop\fi}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macro}{\twoupemptypage}
+% This one is easy:
+%    \begin{macrocode}
+\def\twoupemptypage{\shipout\hbox{}}
+
+%    \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\twoup@eject}
+% This clears a whole target page if there is a saved left page. Note that
+% this does not invoke the output routine; i.e., it is not like |\clearpage|
+% or |\supereject|. See |\twoupclearpage| below. (The \Lpack{booklet}
+% package doesn't need |\twoupeject| which is for non-LaTeX systems).
+%
+% This is the definition of |\twoup@eject| with the Booklet layout.
+%    \begin{macrocode}
+\def\twoup@eject{
+  \leftpagenumber\bookletpage
+  \advance\leftpagenumber by 3
+  \divide\leftpagenumber by 4
+  \multiply\leftpagenumber by 4
+  \rightpagenumber=1
+  \ifnum\leftpagenumber>\bookletpage
+    \setbox\@leftpage\hbox{}%
+    \make@@halfpage\@leftpage
+    \loop
+      \setbox\@rightpage\copy\@leftpage
+      \save@booklet\@rightpage
+    \ifnum\leftpagenumber>\bookletpage
+    \repeat
+  \fi
+  \booklet@loop}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\twoupclearpage}
+% This modification is needed for LaTeX in order to get the last page
+% printed out if the final page is a left page (the catcode business is
+% because |\enddocument| is |\let| to |\bye| in amstex):
+%    \begin{macrocode}
+\begingroup
+\catcode`\>=9\relax
+>>\gdef\twoupclearpage{\clearpage\twoup@eject}
+>>\expandafter\@temptokena\expandafter{\enddocument}
+>>\xdef\enddocument{\noexpand\twoupclearpage\the\@temptokena}
+\endgroup
+
+%    \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\TwoupWrites}
+% This is one workaround for the page cross-references problem
+%    \begin{macrocode}
+\def\TwoupWrites{%
+  \let\TwoupSaved@write\write
+  \let\TwoupSaved@read\read
+  \let\TwoupSaved@openout\openout
+  \let\TwoupSaved@closeout\closeout
+  \def\write{\TwoupSaved@write-1{}\immediate\TwoupSaved@write}%
+  \def\read{\TwoupSaved@write-1{}\immediate\TwoupSaved@read}%
+  \def\openout{\TwoupSaved@write-1{}\immediate\TwoupSaved@openout}%
+  \def\closeout{\TwoupSaved@write-1{}\immediate\TwoupSaved@closeout}%
+  \let\TwoupWrites\relax}
+
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\twouparticle}
+% \begin{macro}{\twoupplain}
+% \begin{macro}{\twouplandscape}
+% \begin{macro}{\twouponetoone}
+% The pre-defined layouts. I have taken advantage of LaTeX2e's
+% paper size lengths to generalise.
+%    \begin{macrocode}
+\def\twouparticle{\target{\magstepminus1}{\paperheight}{\paperwidth}}
+\def\twoupplain{\target{\magstepminus2}{\paperheight}{\paperwidth}}
+\def\twouplandscape{\target{\magstepminus2}{\paperwidth}{\paperheight}%
+  \targettopbottom}
+\def\twouponetoone{\target{\magstep0}{\paperheight}{\paperwidth}}
+
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+% Set the default for the source.
+%    \begin{macrocode}
+\source{\magstep0}{\paperwidth}{\paperheight}
+%    \end{macrocode}
+%
+% Set the defaults for the rule.
+%    \begin{macrocode}
+\pagesepwidth 0pt
+\pageseplength 6.5in
+\pagesepoffset 1in
+%    \end{macrocode}
+%
+% I also found that |\TwoupWrites| was really not optional.
+%    \begin{macrocode}
+\TwoupWrites
+
+%    \end{macrocode}
+%
+% The default options are \Lopt{twouparticle} and \Lopt{thirtytwo} pages
+% per signature.
+%    \begin{macrocode}
+\ExecuteOptions{twouparticle,thirtytwo}
+\ProcessOptions
+
+%    \end{macrocode}
+%
+%
+%    The end of this package.
+%    \begin{macrocode}
+%</prnt>
+%    \end{macrocode}
+%
+%
+% \appendix
+%
+% \section{The code for 2up} \label{sec:2upcode}
+%
+%    Following is a verbatim copy of Timothy Van Zandt's \Lpack{2up} code.
+% I hope that by including this I have partly met his COPYING conditions.
+%
+% \begin{verbatim}
+% 
+% %% BEGIN 2up.tex/2up.sty
+% %%
+% \def\fileversion{1.2}
+% \def\filedate{93/01/28}
+% %%
+% %% COPYRIGHT 1992, 1993 by Timothy Van Zandt, tvz@Princeton.EDU
+% %%
+% %% DESCRIPTION:
+% %%   2up.tex/2up.sty provides two-up printing for Generic TeX (e.g.,
+% %%   Plain, LaTeX, AmSTeX and AmS-LaTeX). It produces a standard dvi file,
+% %%   and does not involve an additional dvi or PostScript filter. It has a
+% %%   flexible interface for specifying paper size and layout.
+% %%
+% %% INSTALLATION:
+% %%   Put this file where your TeX looks for inputs, under the name 2up.tex.
+% %%   Name a copy 2up.sty to use as a LaTeX style option, or create a file
+% %%   2up.sty with the lines:
+% %%     \input 2up.tex
+% %%     \endinput
+% %%
+% %% DOCUMENTATION:
+% %%   Input 2up.tex, or include 2up as a LaTeX style option. There is a
+% %%   good chance you will get the desired layout. (But you will probably
+% %%   need to generate new font bitmaps to get high quality output.) See
+% %%   2up.doc, which might be appended to this file, for detailed
+% %%   documentation.
+% %%
+% %% COPYING:
+% %%   Copying of part or all of this file is allowed under the following
+% %%   conditions only:
+% %%   (1) You may freely distribute unchanged copies of the file. Please
+% %%       include the documentation when you do so.
+% %%   (2) You may modify a renamed copy of the file, but only for personal
+% %%       use or use within an organization.
+% %%   (3) You may copy fragments from the file, for personal use or for use
+% %%       in a macro package for distribution, as long as credit is given
+% %%       where credit is due.
+% %%
+% %%   You are NOT ALLOWED to take money for the distribution or use of
+% %%   this file or modified versions or fragments thereof, except for
+% %%   a nominal charge for copying etc.
+% %%
+% %% CODE:
+% %
+% \csname TwoUpLoaded\endcsname
+% \let\TwoUpLoaded\endinput
+% %
+% \edef\TheAtCode{\the\catcode`\@}
+% \catcode`\@=11\relax
+% \message{\space\space v\fileversion\space\space \filedate\space\space <tvz>}
+% %
+% % Parameter registers:
+% \newdimen\@targetwidth
+% \newdimen\@targetheight
+% \newdimen\@sourcewidth
+% \newdimen\@sourceheight
+% \newdimen\pageseplength
+% \newdimen\pagesepwidth
+% \newdimen\pagesepoffset
+% \newif\if@sidebyside
+% \@sidebysidetrue
+% \newif\if@twosided
+% %
+% % Registers used by output routine.
+% \newif\if@leftpage
+% \@leftpagetrue
+% \newbox\@leftpage
+% \newbox\@rightpage
+% \newcount\@physicalpage
+% %
+% % Since pages are shipped out half as often:
+% \multiply\maxdeadcycles by 2
+% %
+% % Registers used only for booklet layout:
+% \begingroup
+%   \let\newcount\relax
+%   \gdef\booklet@registers{%
+%     \newcount\bookletpage
+%     \bookletpage=0
+%     \newcount\leftpagenumber
+%     \newcount\rightpagenumber
+%     \multiply\maxdeadcycles by 20}
+% \endgroup
+% %
+% % A useful extension of the \magstep macro.
+% \def\magstepminus#1{%
+%   \ifcase#1 \@m\or 833\or 694\or 579\or 482\or 401\fi\relax}
+% %
+% % \@targetwidth and \@targetheight are set to the *unmagnified* dimensions
+% % of the target page. \inv@targetmag is the inverse of the target
+% % magnification.
+% {\catcode`\p=12\catcode`\t=12\gdef\@@inv@@mag#1pt#2{\def#2{#1}}}
+% \def\target#1#2#3{%
+%   \mag #1\relax
+%   \@targetwidth=1000pt
+%   \divide\@targetwidth by #1\relax
+%   \expandafter\@@inv@@mag\the\@targetwidth\inv@targetmag
+%   \@targetwidth=#2\relax
+%   \@targetwidth=\inv@targetmag\@targetwidth
+%   \@targetheight=#3\relax
+%   \@targetheight=\inv@targetmag\@targetheight}
+% %
+% % Like \target, but for the source:
+% \def\source#1#2#3{%
+%   \@sourcewidth=1000pt
+%   \divide\@sourcewidth by #1\relax
+%   \expandafter\@@inv@@mag\the\@sourcewidth\inv@sourcemag
+%   \@sourcewidth=#2\relax
+%   \@sourcewidth=\inv@sourcemag\@sourcewidth
+%   \@sourceheight=#3\relax
+%   \@sourceheight=\inv@sourcemag\@sourceheight}
+% %
+% % \targetlayout does a loop that reads the comma separated arguments.
+% % There can be no extraneous spaces.
+% \def\targetlayout#1{\process@targetlayout#1,stop,}
+% \def\process@targetlayout#1,{%
+%   \expandafter\let\expandafter\next\csname target@#1\endcsname
+%   \ifx\next\relax
+%     \begingroup
+%       \errhelp{Valid target layouts are "topbottom", "twosided",
+%         "booklet", "Booklet" and "dvidvi".}%
+%       \errmessage{`#1' is invalid 2up target layout - ignored.}%
+%     \endgroup
+%     \expandafter\process@targetlayout
+%   \else
+%     \next
+%   \fi}
+% \def\target@stop{}
+% \def\target@booklet{%
+%   \booklet@registers
+%   \def\ship@@@leftpage{\save@booklet\@leftpage}%
+%   \def\ship@@@rightpage{\save@booklet\@rightpage}%
+%   \@leftpagefalse
+%   \def\twoup@eject{\twoup@eject@booklet}%
+%   \expandafter\process@targetlayout}
+% \def\target@Booklet{%
+%   \def\booklet@@loop{\Booklet@@loop}%
+%   \target@booklet}
+% \def\target@twosided{%
+%   \@twosidedtrue
+%   \expandafter\process@targetlayout}
+% \def\target@topbottom{%
+%   \def\make@@halfpage{\make@@halftopbottom}%
+%   \def\make@fullpage{\make@fulltopbottom}%
+%   \@sidebysidefalse
+%   \expandafter\process@targetlayout}
+% \def\target@dvidvi{%
+%   \def\ship@@@leftpage{\ship@dvidvi\@leftpage}%
+%   \def\ship@@@rightpage{\ship@dvidvi\@rightpage}%
+%   \expandafter\process@targetlayout}
+% %
+% % TeX's \shipout primitive is saved as \&normal@shipout, and then \shipout
+% % is defined to save each page to \@leftpage or \@rightpage and to print out
+% % every two. With the twosided layout, filler pages are added when needed.
+% \expandafter\let\csname &normal@shipout\endcsname\shipout
+% \def\shipout{%
+%   \if@leftpage
+%     \global\@leftpagefalse
+%     \def\next{\afterassignment\ship@leftpage\global\setbox\@leftpage=}%
+%     \if@twosided
+%       \ifodd\count\z@
+%         \global\setbox\@leftpage=\hbox{}%
+%         \make@@halfpage\@leftpage\ship@@@leftpage
+%         \def\next{\shipout}%
+%       \fi
+%     \fi
+%   \else
+%     \global\@leftpagetrue
+%     \def\next{\afterassignment\ship@rightpage\global\setbox\@rightpage=}%
+%     \if@twosided
+%       \ifodd\count\z@
+%       \else
+%         \global\setbox\@rightpage=\hbox{}%
+%         \make@@halfpage\@rightpage\ship@@@rightpage
+%         \def\next{\shipout}%
+%       \fi
+%     \fi
+%   \fi
+%   \next}
+% %
+% % The job of \ship@leftpage and \ship@rightpage is to invoke \ship@@leftpage
+% % or \ship@@rightpage at the right time. \shipout is followed either
+% % (i) by an \hbox, \vbox or \vtop, in which case \ship@leftpage is invoked
+% % after the opening {. \@leftpage is void, and \ship@leftpage invokes
+% % \ship@@leftpage after the closing }, or
+% % (ii) by a \box or \copy, in which case \ship@leftpage is invoked after
+% % the full assignment. \@leftpage is not voide, and \ship@leftpage invokes
+% % \ship@@leftpage immediately.
+% \def\ship@leftpage{%
+%   \ifvoid\@leftpage\aftergroup\ship@@leftpage\else\ship@@leftpage\fi}
+% \def\ship@rightpage{%
+%   \ifvoid\@rightpage\aftergroup\ship@@rightpage\else\ship@@rightpage\fi}
+% %
+% % \ship@@leftpage/\ship@@rightpage take the output box, and first make it
+% % into a fully-size source page (with \make@halfpage) and then this is
+% % centered horizontally and vertically in half of a target page (with
+% % \make@@halfpage). Then they are shipped individually or together.
+% \def\ship@@leftpage{\make@halfpage\@leftpage\ship@@@leftpage}
+% \def\ship@@rightpage{\make@halfpage\@rightpage\ship@@@rightpage}
+% \def\make@halfpage#1{%
+%   \dp#1=\z@
+%   \setbox#1=\vbox to\@sourceheight{%
+%     \vskip \inv@sourcemag in
+%     \vskip \voffset
+%     \hbox to\@sourcewidth{\hskip\inv@sourcemag in\hskip\hoffset\box#1\hss}%
+%     \vss}%
+%   \make@@halfpage#1}
+% %
+% % The definition of \make@@halfpage depends on the target layout.
+% \def\make@@halfsidebyside#1{%
+%   \global\setbox#1=\vbox to\@targetheight{\vss
+%     \hbox to.5\@targetwidth{\hss\box#1\hss}\vss}}
+% \def\make@@halftopbottom#1{%
+%   \global\setbox#1=\vbox to.5\@targetheight{\vss
+%     \hbox to\@targetwidth{\hss\box#1\hss}\vss}}
+% \def\make@@halfpage{\make@@halfsidebyside}
+% %
+% % The pages are generaly shipped in pairs:
+% \def\ship@twoup{%
+%   \begingroup
+%     \voffset=-\inv@targetmag in
+%     \hoffset=\voffset
+%     \global\advance\@physicalpage by 1
+%     \count\z@=\@physicalpage
+%     \csname &normal@shipout\endcsname\make@fullpage
+%   \endgroup}
+% \let\ship@@@leftpage\relax
+% \def\ship@@@rightpage{\ship@twoup}
+% %
+% % The definition of \make@fullpage depends on the layout:
+% \def\make@fullsidebyside{%
+%   \hbox{\box\@leftpage\pagesep@sidebyside\box\@rightpage}}
+% \def\make@fulltopbottom{%
+%   \vbox{\offinterlineskip\box\@leftpage\pagesep@topbottom\box\@rightpage}}
+% \def\make@fullpage{\make@fullsidebyside}
+% %
+% % A vertical or horizontal rule can be inserted. These can be redefined
+% % for other tricks:
+% \def\pagesep@sidebyside{%
+%   \begingroup
+%     \advance\pageseplength by \pagesepoffset
+%     \pagesepwidth=\inv@targetmag\pagesepwidth
+%     \kern -.5\pagesepwidth
+%     \vrule height \inv@targetmag\pageseplength
+%            depth -\inv@targetmag\pagesepoffset
+%            width \pagesepwidth
+%     \kern -.5\pagesepwidth
+%   \endgroup}
+% \def\pagesep@topbottom{%
+%   \begingroup
+%     \pagesepwidth=\inv@targetmag\pagesepwidth
+%     \vskip -.5\pagesepwidth
+%     \moveright\inv@targetmag\pagesepoffset\hbox{%
+%       \vrule height\pagesepwidth width\inv@targetmag\pageseplength}%
+%     \vskip -.5\pagesepwidth
+%   \endgroup}
+% %
+% % With the dvidvi layout, the pages are shipped individually:
+% \def\ship@dvidvi#1{%
+%   \begingroup
+%     \voffset=-\inv@targetmag in
+%     \hoffset=\voffset
+%     \csname &normal@shipout\endcsname\box#1%
+%   \endgroup}
+% %
+% % With the booklet or Booklet layout, the pages are saved rather than
+% % shipped.
+% \begingroup
+% \let\newbox\relax
+% \gdef\save@booklet#1{%
+%   \begingroup
+%     \globaldefs=1
+%     \advance\bookletpage by 1
+%     \expandafter\newbox\csname bookletbox\the\bookletpage\endcsname
+%     \expandafter\setbox\csname bookletbox\the\bookletpage\endcsname\box#1%
+%   \endgroup}
+% \endgroup
+% %
+% % The pages are then printed at the end with the following macros:
+% \def\make@bookletpage#1{%
+%   \setbox\ifodd#1\@rightpage\else\@leftpage\fi=%
+%     \expandafter\box\csname bookletbox\the#1\endcsname}
+% \def\booklet@loop{%
+%   \count\z@\rightpagenumber
+%   \make@bookletpage\leftpagenumber
+%   \make@bookletpage\rightpagenumber
+%   \ship@twoup
+%   \booklet@@loop}
+% \def\booklet@@loop{%
+%   \advance\rightpagenumber by 2
+%   \advance\leftpagenumber by -2
+%   \ifnum\leftpagenumber<1\else\expandafter\booklet@loop\fi}
+% \def\Booklet@@loop{%
+%   \advance\rightpagenumber by 1
+%   \advance\leftpagenumber by -1
+%   \ifnum\leftpagenumber<\rightpagenumber\else\expandafter\booklet@loop\fi}
+% %
+% % This one is easy:
+% \def\twoupemptypage{\shipout\hbox{}}
+% %
+% % This clears a whole target page if there is a saved left page. Note that
+% % this does not invoke the output routine; i.e., it is not like \clearpage
+% % or \supereject. See \twoupclearpage and \twoupeject below.
+% \def\twoup@eject{%
+%   \if@leftpage\else
+%     \global\setbox\@rightpage\hbox{}%
+%     \make@@halfpage\@rightpage\ship@@@rightpage
+%     \global\@leftpagetrue
+%   \fi}
+% %
+% % This is the definition of \twoup@eject with the booklet option:
+% \def\twoup@eject@booklet{%
+%   \leftpagenumber\bookletpage
+%   \advance\leftpagenumber by 3
+%   \divide\leftpagenumber by 4
+%   \multiply\leftpagenumber by 4
+%   \rightpagenumber=1
+%   \ifnum\leftpagenumber>\bookletpage
+%     \setbox\@leftpage\hbox{}%
+%     \make@@halfpage\@leftpage
+%     \loop
+%       \setbox\@rightpage\copy\@leftpage
+%       \save@booklet\@rightpage
+%     \ifnum\leftpagenumber>\bookletpage
+%     \repeat
+%   \fi
+%   \booklet@loop}
+% %
+% % This modification is needed for \LaTeX in order to get the last page
+% % printed out if the final page is a left page (the catcode business is
+% % because \enddocument is \let to \bye in amstex):
+% \begingroup
+% \expandafter\ifx\csname @latexerr\endcsname\relax
+%   \catcode`\>=14\else\catcode`\>=9\fi\relax
+% >>\gdef\twoupclearpage{\clearpage\twoup@eject}
+% >>\expandafter\@temptokena\expandafter{\enddocument}
+% >>\xdef\enddocument{\noexpand\twoupclearpage\the\@temptokena}
+% \endgroup
+% %
+% % For most other macro packages we could just leave be and all pages would
+% % always be printed because of the way the \end primitive works (except that
+% % TeX will go bonkers with the booklet layout). However,
+% % sometimes a blank filler page would be printed *with* headings. We prefer
+% % the filler page to be truly blank. To achieve this,  we hack the definition
+% % of \end. This may cause problems with some macros.
+% \expandafter\ifx\csname @latexerr\endcsname\relax
+%   \let\twoup@@@end\end
+%   \def\end{\twoup@eject\twoup@@@end}
+%   \def\twoupeject{\par\vfil\supereject\twoup@eject}
+% \fi
+% %
+% % This is one workaround for the page cross-references problem
+% \def\TwoupWrites{%
+%   \let\TwoupSaved@write\write
+%   \let\TwoupSaved@read\read
+%   \let\TwoupSaved@openout\openout
+%   \let\TwoupSaved@closeout\closeout
+%   \def\write{\TwoupSaved@write-1{}\immediate\TwoupSaved@write}%
+%   \def\read{\TwoupSaved@write-1{}\immediate\TwoupSaved@read}%
+%   \def\openout{\TwoupSaved@write-1{}\immediate\TwoupSaved@openout}%
+%   \def\closeout{\TwoupSaved@write-1{}\immediate\TwoupSaved@closeout}%
+%   \let\TwoupWrites\relax}
+% %
+% %  Defaults:
+% \def\twouparticle{%
+%   \target{\magstepminus1}{11in}{8.5in}%
+%   \source{\magstep0}{8.5in}{11in}}
+% \def\twoupplain{%
+%   \target{\magstepminus2}{11in}{8.5in}%
+%   \source{\magstep0}{8.5in}{11in}}
+% \def\twouplegaltarget{%
+%   \target{\magstepminus1}{14in}{8.5in}%
+%   \source{\magstep0}{8.5in}{11in}}%
+% \def\twouplandscape{%
+%   \target{\magstepminus2}{8.5in}{11in}%
+%   \source{\magstep0}{11in}{8.5in}%
+%   \targetlayout{topbottom}}
+% \expandafter\ifx\csname @latexerr\endcsname\relax
+%   \twoupplain\else\twouparticle\fi
+% \pagesepwidth 0pt
+% \pageseplength 6.5in
+% \pagesepoffset 1in
+% %
+% \expandafter\catcode`\@=\TheAtCode\relax
+% \endinput
+% %% END 2up.tex/2up.sty
+% 
+% \end{verbatim}
+%
+%
+% \section{The documentation for 2up} \label{sec:2updoc}
+%
+%    Following is an almost verbatim copy of the documentation for Timothy
+% Van Zandt's \Lpack{2up}. I hope that by including this I have 
+% now completely met his COPYING conditions. The only change that
+% I have made to the original is replacing every occurrence of `|{verbatim}|'
+% by `|{verbtm}|', so LaTeX does not get confused when processing the
+% current document.
+%
+% \begin{verbatim}
+% 
+% %% BEGIN 2up.doc
+% %%
+% %% Documentation for 2up.tex/2up.sty.
+% %% Run through LaTeX, with or without the NFSS.
+% %%
+% %% See below if you want to try out two-up printing.
+% %%
+% %% LaTeX version of this documentation courtesy of
+% %%    H. David Todd <hdtodd@mockingbird.wesleyan.edu>
+% %%
+% %%
+% \documentstyle[12pt,twoside]{article}
+% 
+% \def\FileDate{January 28, 1993}
+% \def\FileVersion{1.2}
+% 
+% %% INSTRUCTIONS FOR TWO-UP PRINTING.
+% %% 1. Change \iffalse below to \iftrue.
+% %% 2. Uncomment \special{landscape} if using Rokicki's dvips, or otherwise
+% %%      remember to print the document out in landscape mode.
+% %% 3. Uncomment one of the booklet options, if desired.
+% %%
+% \iffalse
+%   \input 2up.tex
+%   \targetlayout{twosided}
+%   \TwoupWrites
+%   % \special{landscape}     %% This works with Rokicki's dvips
+%   % \targetlayout{Booklet}  %% Booklet printing with 2-sided printer/copier.
+%   % \targetlayout{booklet}  %% Booklet printing with 1-sided printer/copier.
+% \fi
+% 
+% \makeatletter
+% 
+% %% PAGE NUMBERING:
+% %% Adjust page numbering if using booklet layout option.
+% \setcounter{page}{0}
+% \def\next{\if@leftpage\else\stepcounter{page}\fi}
+% \@ifundefined{target@stop}{}{\next}
+% 
+% %% CONTENTS:
+% \def\tableofcontents{%
+%   \par\begin{center}
+%   \large\bf Contents
+%   \end{center}
+%   \begin{quote}\@starttoc{toc}\end{quote}}
+% 
+% %% PAGE PARAMETERS:
+% \setlength{\parindent}{0pt}          % paragraph indent
+% \setlength{\parskip}{4pt plus 1pt minus 1pt}
+% \setlength{\topmargin}{0pt}
+% \setlength{\headheight}{12pt}        % height of running head
+% \setlength{\headsep}{30pt}           % distance between header and text
+% \setlength{\textheight}{8.2in}        % height of text on page
+% 
+% %% DATES, VERSIONS AND TITLES:
+% \def\@maketitle{%
+%  \begin{center}
+%    {\Large\bf \@title \par}
+%    \vskip 1.2em {\lineskip .5em
+%    \begin{tabular}[t]{c}\@author\end{tabular}\par}
+%    \vskip .8em {\@date}%
+%   \end{center}
+%   \par
+%   \vskip .5em}
+% 
+% %% Page Style:
+% \pagestyle{myheadings}
+% \markboth{Two-Up Style Guide}{Version \FileVersion, \FileDate}
+% 
+% %% Special list:
+% \newcommand{\namelistlabel}[1]{\mbox{\bf #1}\hfil}
+% \newenvironment{namelist}[1]%
+%   {\begin{list}{}%
+%     {\let\makelabel\namelistlabel
+%     \settowidth{\labelwidth}{#1}
+%     \setlength{\leftmargin}{1.1\labelwidth}}}%
+%  {\end{list}}
+% 
+% %% VERBATIM:
+% %%
+% \begingroup
+%   \catcode`\{=12 \catcode`\}=12
+%   \catcode`\(=1 \catcode`\)=2
+%   \catcode`\+=0 \catcode`\\=12
+%   +gdef+|(\)          % \| = character \
+%   +gdef+{({)          % \{ = character {
+%   +gdef+}(})          % \} = character }
+% +endgroup
+% \def\Backslash{\protect\|}
+% %%
+% %% Define some functional font commands:
+% %%
+% \def\MainFont{\tt}      % For macro definitions.
+% \def\UsageFont{\tt}           % For in-line macro names.
+% \def\InlineFont{\tt}          % For other in-line snipets of code.
+% \def\MetaFont{\rm\it}            % For meta arguments.
+% %%
+% %% Short-cuts for font commands:
+% %%
+% \def\s#1{\string#1}
+% \def\t#1{{\InlineFont\string#1}}   % For other in-line code.
+% \def\m#1{{\MetaFont #1\/}}         % For just putting things in italics
+% \def\M#1{{\InlineFont\{\m{#1}\}}}  % Arg is in italic, enclosed in tt braces.
+% \let\N\t                           % For in-line macro names.
+% \catcode`\<=13 \def<#1>{\m{#1}}    % <meta>
+% \catcode`\"=13\def"{\verb"}        % Short verb
+% %%
+% %% This is for listing macro definitions in a quote-like environment.
+% %%
+% \begingroup
+%   \catcode`\[=1 \catcode`\]=2
+%   \catcode`\{=13 \catcode`\}=12
+%   \gdef\@MD[%
+%     \catcode`\{=13 \catcode`\}=12
+%     \def{##1}[\{[\MetaFont ##1]\}]]
+% \endgroup
+% \def\MD{%
+%   \quote
+%   \begingroup
+%     \@MD
+%     \def\end{\endgroup\end}%
+%     \def\\{\@centercr\s}%
+%     \MainFont
+%     \s}
+% \def\endMD{\endquote}
+% %%
+% 
+% %% End preamble.
+% \catcode`\@=12
+% 
+% \begin{document}
+% 
+% \title{Documentation for 2up.tex:\\
+%   Two-up printing for Generic TeX}
+% \author{Timothy Van Zandt\thanks{The documentation was put into
+%   \LaTeX\ format by David Todd.}\\ tvz@Princeton.EDU}
+% \date{Version \FileVersion\\[3pt] \FileDate}
+% 
+% \maketitle
+% \thispagestyle{empty}
+% 
+%   "2up.tex"/"2up.sty" allows one to print a document two-up, with
+% considerable flexibility as to paper size and layout. It produces a standard
+% dvi file, and does not involve an additional dvi or PostScript filter. It
+% should work with most \TeX\ macro packages.
+% 
+%   {\bf Usage:} Input "2up.tex", or include "2up" as a LaTeX style option.
+% There is a good chance you will get the desired layout. (But you will probably
+% need to generate new font bitmaps to get high quality output.) See the rest of
+% this documentation for detailed information on controlling 2up.tex.
+% 
+% \begingroup
+% \def\baselinestretch{.8}\large\normalsize
+% \tableofcontents
+% \endgroup
+% \clearpage
+% 
+% \section{Comparison with other methods}
+% 
+% There are other tools for two-up printing:
+% \begin{description}
+% \item[PostScript filters]
+% These work well as long as you only use PostScript fonts (as opposed to the
+% usual Metafont fonts). Otherwise, the PostScript filter scales bitmapped
+% fonts, and the quality is lower than with "2up.tex".
+% 
+% \item[Rokicki's dvidvi]
+% "dvidvi" is a versatil tool that does much more than
+% 2up printing. However, if only rearranges the pages, and does not adjust the
+% magnification to ensure that the pages fit properly in a two-up format. It
+% also adds one more step to the \TeX-dvi-printer cycle. "2up.tex", on the other
+% hand, combines the changes to \TeX's magnification and page layout with the
+% rearranging of the pages, all with an easy-to-use interface and from within
+% your \TeX\ document. (See Section \ref{dvidvi} on using both "2up.tex" and
+% "dvidvi" together.)
+% \end{description}
+% 
+% \section{A warning about fonts}
+% 
+% Two-up printing generally involves reducing a document, and thus using fonts
+% sizes that are not typically found on your system. If you are using bitmapped
+% fonts (standard for \TeX\ users), and you do not have and cannot generate the
+% extra fonts bitmaps, you will find 2up.sty (and any other method of two-up
+% printing) to give very poor quality output.
+% 
+% If you are using a program like Rokicki's "dvips" that can generate extra font
+% bitmaps as needed, you will find that it takes a long time to print your 2up
+% document the first few times, as "dvips" is busy making the extra fonts. This
+% problem will go away. Be thankful you have such an easy way to get extra font
+% bitmaps.
+% 
+% \section{Usage}
+% 
+% Input "2up.tex". \LaTeX\ users can include "2up" as a style option.
+% 
+% Then set the target and source layout:
+% \begin{MD}
+%   \source{mag}{width}{height}\\
+%   \target{mag}{width}{height}
+% \end{MD}
+% 
+% \begin{itemize}
+% \item The ``source'' layout is the layout of your document
+% the way it is usually printed.  The ``target'' layout is the layout when it
+% is printed two-up.
+% 
+% \item <width> and <height> are the true width and height of the paper,
+% when looking at the output right-side-up.
+% 
+% \item <mag> refers to the source and target magnification. It should be an
+% integer, equal to 1000 times the magnification factor. There are also some
+% magic magnification numbers:
+% \begin{description}
+% \item[$\setminus$magstep<n>] for a magnification of 1.2$^n$ (n=0,...,5), or
+% 
+% \item[$\setminus$magstepminus<n>] for a magnification of 1.2$^{-n}$
+% (n=0,...,5).
+% \end{description}
+% Using these magnification values will make best use of the available fonts on
+% your system.
+% \end{itemize}
+% 
+% "2up.tex" takes each source page, and centers in half a target page. To get
+% the pages to fit, the magnification of the document typically has to be
+% reduced. If you find that the pages are too crowded, try reducing the target
+% magnification. If they are too lonely, try increasing the target
+% magnification.
+% 
+% If you want to adjust the positioning of the scaled pages, try changing the
+% values of "\hoffset" or "\voffset" with "\advance" or \LaTeX's "\addtolength".
+% 
+% Don't change the magnification of your document after using the "\target"
+% command, as you will override the settings made by 2up.tex.
+% 
+% You can also specify some options:
+% \begin{MD}
+%   \targetlayout{options}
+% \end{MD}
+% where <options> is a comma separated list with no spaces. Valid
+% options are:
+% \begin{namelist}{topbottomxxx}
+% 
+% \item [topbottom] The two source pages are printed one on top of the other.
+% \item [twosided]  Odd pages are always printed on the right or the bottom.
+% \item [booklet]   Pages are printed like a booklet. See Section \ref{booklet}.
+% \item [Booklet]   Like "booklet", but for two-sided printers/copiers.
+% \item [dvidvi]    For arranging in two-up layout with "dvidvi". See Section
+% \ref{dvidvi}.
+% 
+% \end{namelist}
+% 
+% The only other changes you might want to make to your document are the
+% following:
+% \begin{itemize}
+% \item You have to see to it that the target output is printed with the
+% correct orientation (landscape or portrait). See the documentation for your
+% dvi driver for details.
+% 
+% \item "2up.tex" will inserts a line between pages if you change the following
+% dimensions:
+% \begin{namelist}{pagesepwidthxxx}
+% \item [$\setminus$pagesepwidth]   Thickness of line. (Default 0pt)
+% \item [$\setminus$pageseplength]  Length of line. (Default 6.5in)
+% \item [$\setminus$pagesepoffset]  Distance from bottom of page to bottom of
+% line, or (with "topbottom" layout) from side of page to beginning of line.
+% (Default 1in)
+% \end{namelist}
+% 
+% \item You can, but do not need to, use the following commands:
+% \begin{namelist}{twoupemptypagexxx}
+% 
+% \item [$\setminus$twoupemptypage] inserts a completely blank half page
+% in the target.
+% 
+% \item [$\setminus$twoupclearpage] \LaTeX\ users: ejects a complete target
+% page.
+% 
+% \item [$\setminus$twoupeject] Plain \TeX users: ejects a complete target
+% page.
+% 
+% \end{namelist}
+% \end{itemize}
+% 
+% \section{Defaults}
+% 
+%   The following commands set the parameters for some common sources and
+% targets. The definitions of these commands are also useful examples.
+% 
+%   For A4 paper, just replace "8.5in" and "11in" in the definitions below by
+% the width and height of A4 paper.
+% 
+% \begin{description}
+% 
+% \item [$\setminus$twouparticle]
+% 
+% This is the default for \LaTeX.
+% \begin{namelist}{Sourcexx}
+% 
+% \item [Source:] A portrait document on 8.5x11 inch paper with wide margins as
+% used in \LaTeX's article style, and without marginal notes.
+% 
+% \item [Target:] A landscape document on the same size paper, with the source
+% pages printed side by side.
+% 
+% \item [Definition:]\hspace{1pt}
+% \begin{verbtm}
+% \target{\magstepminus1}{11in}{8.5in}
+% \source{\magstep0}{8.5in}{11in}}
+% \end{verbtm}
+% \end{namelist}
+% 
+% If you use narrower side margins, or if you use marginal notes, then you
+% will need to use "\twoupplain" or \\ "\twouplegaltarget", defined below.
+% 
+% \item [$\setminus$twoupplain]
+% 
+% This is the default for non-\LaTeX.
+% 
+% It is the same as "\twouparticle", but for source documents with narrower
+% margins.
+% \begin{namelist}{Sourcexxx}
+% 
+% \item [Definition:]\hspace{1pt}
+% \begin{verbtm}
+% \target{\magstepminus2}{11in}{8.5in}
+% \source{\magstep0}{8.5in}{11in}
+% \end{verbtm}
+% \end{namelist}
+% 
+% \item [$\setminus$twouplegaltarget]
+% 
+% \begin{namelist}{Sourcexxx}
+% \item [Source:] A portrait document on 8.5x11 inch paper with just about any
+% margins and perhaps with marginal notes.
+% 
+% \item [Target:] A landscape document on legal size paper (8.5x14 inches),
+% with the source pages printed side by side.
+% 
+% \item [Definition:]\hspace{1pt}
+% \begin{verbtm}
+% \target{\magstepminus1}{14in}{8.5in}
+% \source{\magstep0}{8.5in}{11in}\
+% end{verbtm}
+% \end{namelist}
+% 
+% \item [$\setminus$twouplandscape]\hspace{1pt}
+% \begin{namelist}{Sourcexxx}
+% 
+% \item [Source:] A landscape document on 8.5x11 inch paper with just about any
+% margins.
+% 
+% \item [Target:] A portrait document on the same size paper, with the
+% source pages stacked vertically.
+% 
+% \item [Definition:]\hspace{1pt}
+% \begin{verbtm}
+% \target{\magstepminus2}{8.5in}{11in}
+% \source{\magstep0}{11in}{8.5in}
+% \targetlayout{topbottom}
+% \end{verbtm}
+% \end{namelist}
+% 
+% \end{description}
+% 
+% 
+% \section{True Dimensions}
+% 
+% \TeX\ lets you use `true' dimensions, as in
+% \begin{verbtm}
+%     \topmargin 1truein
+%     \setlength{\topmargin}{1truein}
+% \end{verbtm}
+% This sets the length to 1 inch
+% as it appears on the page, no matter what the magnification.
+% 
+% Once you use `true' dimensions, it is impossible to change the
+% magnification of your document, and hence it is almost impossible
+% to use 2up.tex. You will get an error like:
+% \begin{verbtm}
+%     ! Incompatible magnification (833);
+%       the previous value will be retained (2000).
+% \end{verbtm}%
+% 
+% The use of `true' dimensions might be hiding in macros or style files
+% you are using. For example, Plain \TeX's "\magnification" command uses
+% true dimensions; use "\mag" instead, and then set "\hsize" and
+% "\vsize" appropriately scaled. If you can't find the culprit `true'
+% dimension in your document or input files, try putting this on the
+% (very) first line of your document:
+% \begin{verbtm}
+%     \mag 143 \voffset 1truein \mag 1000
+% \end{verbtm}
+% 
+% You will get the error listed above wherever true dimensions are used
+% (and in some other places as well).
+% 
+% 
+% \section{Page Cross-References}
+% 
+%   Page cross-references (e.g., in an index or table of contents) will not be
+% accurate with "2up.tex", because finished pages are not immediately shipped
+% out. This can also cause problems with some special \LaTeX\ styles that have
+% multiple ".aux" files (e.g., for each chapter).
+% 
+%   To get better, but not perfect, page cross-references, try putting the
+% command
+% \begin{verbtm}
+%     \TwoupWrites
+% \end{verbtm}
+% at the beginning of your document, after inputting "2up.tex". This is good for
+% drafts, and may fix problems with \LaTeX\ styles that have multiple ".aux"
+% files. "\TwoupWrites" makes "\write" and "\read" "\immediate", if you know
+% what that means. It might cause problems of its own, but try it and see.
+% 
+%   To get accurate page cross-references:
+% \begin{enumerate}
+% \item Run the job without "2up.tex", until all cross-references
+% are properly resolved. Run any index utility at this point.
+% 
+% \item Run the job ONE MORE TIME with "2up.tex"; it will use the
+% correct cross-references from the previous runs. (In \LaTeX\ documents,
+% it is useful at this point to include the "\nofiles" command, so that
+% the correct cross-references are preserved.)
+% \end{enumerate}
+% 
+% \section{Booklets\label{booklet}}
+% 
+% Here are some special considerations for making booklets:
+% 
+% \begin{itemize}
+% 
+% \item  Use the "booklet" target layout if your printer or copier cannot print
+% two
+% sides directly. "2up.tex" prints out the ``tops'' of the pages, and then the
+% ``bottoms'', so that you can copy or print on both sides by doing one side,
+% flipping the output over, and doing the other side.
+% 
+% \item Use "Booklet" if your printer or copier can print directly on two sides.
+% 
+% \item You must have enough memory and box registers to hold all the pages in
+% the document. A Big\TeX\ should be able to handle at least a 32-page booklet.
+% 
+% \item Sometimes booklet printing is part of the design of a document, rather
+% than an afterthought. In this case, you should set up the margins for the
+% target half-page rather than using "2up.tex" to scale the document. For
+% example, if using \LaTeX, 8.5x11 inch paper, \LaTeX's twoside style option,
+% and headings, try the following page parameter changes:
+% \begin{verbtm}
+%     \setlength{\oddsidemargin}{-0.2in}
+%     \setlength{\evensidemargin}{-0.5in}
+%     \setlength{\textwidth}{4.2in}
+%     \setlength{\textheight}{6.5in}
+%     \setlength{\topmargin}{-.4in}
+% \end{verbtm}
+% If you do this, "2up.tex" isn't adjusting margins or scaling the
+% document. You coould therefore get by without "2up.tex" by using "dvidvi".
+% \end{itemize}
+% 
+% \section{Using dvidvi\label{dvidvi}}
+% 
+%   With the "dvidvi" layout option, "2up.tex" takes care of adjusting the
+% margins, and you then use "dvidvi" to arrange the pages in a two-up
+% format. The advantage is that cross referencing comes out right.
+% The disadvantage is that it involves one more step.
+% 
+% Start by \TeX ing your document with "2up.tex" and the "dvidvi" layout option.
+% Then run the dvi file through "dvidvi". Specify the offsets for "dvidvi" at
+% the middle of the page. E.g., for
+% a side-by-side layout on 8.5x11in paper, use
+% \begin{verbtm}
+%     dvidvi '2:0,1(5.5in,0in)' foo bar
+% \end{verbtm}
+% For other paper sizes, replace "5.5in" by half the target paper width. For the
+% "topbottom" layout, reverse the dimensions, e.g.,
+% (0in,5.5in). For booklet printing, see the
+% the documentation for "dvidvi".
+% 
+% 
+% \section{Compatibility\label{compatibility}}
+% 
+%   These macros should work with most \TeX\ macro packages, except for
+% the following possible but unlikely compatibility problems:
+% 
+% \begin{itemize}
+% 
+% \item If you use a macro package other than \LaTeX\ that does unusual things
+% to end a document and/or that modifies the definition of "\end", you may
+% find that the last page is nor printed or that an extra page with headings
+% is inserted at the end of the document. This is fixable on a case-by-case
+% basis. See the redefinition of "\end" in "2up.tex".
+% 
+% \item "2up.tex" might not work if you meddle with \TeX's "\shipout" primitive
+% after loading "2up.tex".
+% 
+% \item If the first page of the source document is not on the first two-up
+% target
+% page (possible, for example, with two-sided printing and the "booklet"
+% option, but generally unlikely), "\special"'s that come at the beginning
+% of the document also do not get onto the first page of output. This can mess
+% up "\special"'s for landscape printing or
+% including a PostScript header file. In this case, you have to specify
+% these things as command line options when using your dvi driver.
+% 
+% \end{itemize}
+% 
+% 
+% \section{Changes}
+% \begin{namelist}{V0.9xxx}
+% \raggedright
+% 
+% \item [V0.9a] Everything redone. Too many differences to point out.
+% 
+% \item [V0.9b] Interface redone again. "booklet" option added.
+% 
+% \item [V0.9c] Pages ship out a little earlier. A few bugs fixed.
+% 
+%   Parameters "\pageseplength" and "\pagesepthickness" added.
+% 
+% \item [V0.9d] Fixed bug with "\twoupclearpage" and "\twoupeject".
+% 
+% \item [V0.9e] Made pages be counted (from dvi driver's viewpoint) by the
+% physical page number.
+% 
+% \item [V0.9f] Parameter "\pagesepoffset" added, and "\pagesepthickness"
+% changed to "\pagesepwidth".
+% 
+% \item [V1.0]  None. Just seemed seemed like it was time to call it 1.0
+% 
+% \item [V1.1] Added "Booklet" and "dvidvi" target layouts.
+% 
+%   "\hoffset" and "\voffset" in source document now have expected effect.
+% 
+% \item[V1.2] Fixed incompatibility problem with AmS-\TeX/AmS-\LaTeX.
+% 
+%   Added "\TwoupWrites" command.
+% 
+% \end{namelist}
+% \end{document}
+% % END 2up.doc
+% 
+% \end{verbatim}
+%
+%    I used a slightly modified version of \file{2up.doc} as one of the
+% test documents for the \Lpack{booklet} package. First, to get a baseline,
+% I followed the instructions in \file{2up.doc} and edited and printed
+% it using \Lpack{2up} to get a booklet.
+%
+%    I then copied \file{2up.doc} to \file{2updoc.tex} and then edited
+% the new file so that the first part of the preamble became:
+% \begin{verbatim}
+% %% BEGIN 2updoc.tex
+% %% ....
+% \documentclass[12pt,twoside]{article}
+% \usepackage[print,four]{booklet}  % change options to suit
+% \usepackage{ifpdf}                % from CTAN
+%
+% \ifpdf
+%   \pdfoutput=1
+%   \setpdftargetpages
+% \else
+%   \checkforlandscape
+%   \ifuselandscape
+%     \special{dvips}
+%     \ifprintoption
+%       \special{!TeXDict begin <</Duplex true /Tumble true>> setpagedevice end}
+%     \fi
+%   \fi
+% \fi
+% 
+% \def\FileDate....
+% ...
+% \iffalse
+%   \input 2up.tex
+%   ...
+%    % \fi and \makeatletter were here
+% %% PAGE NUMBERING:
+% ...
+% \@ifundefined{target@stop}...
+% \fi     % this \fi and \makeatletter moved down from before NUMBERING
+% \makeatletter
+%
+% %% CONTENTS     % no changes after this
+% ... 
+% \end{verbatim}
+%
+% Processing, printing and folding this to make a booklet enabled me to
+% determine if the package effectively produced the same final result
+% as \Lpack{2up}. 
+% 
+%
+% \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/Master/texmf-dist/source/latex/booklet/booklet.ins b/Master/texmf-dist/source/latex/booklet/booklet.ins
new file mode 100644
index 00000000000..e3ae23666a3
--- /dev/null
+++ b/Master/texmf-dist/source/latex/booklet/booklet.ins
@@ -0,0 +1,79 @@
+%% booklet.ins
+%% Author: Peter Wilson (Herries Press) herries dot press at earthlink dot net
+%% Copyright 2000 --- 2005 Peter R. Wilson
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either
+%% version 1.3 of this license or (at your option) any 
+%% later version.
+%% The latest version of the license is in
+%%    http://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of
+%% LaTeX version 2003/06/01 or later.
+%%
+%% This work has the LPPL maintenance status "author-maintained".
+%%
+%% 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{booklet.ins}
+\input docstrip.tex
+\preamble
+
+----------------------------------------------------------------- 
+  Author: Peter Wilson (Herries Press) herries dot press at earthlink dot net
+  Copyright 2000 --- 2005 Peter R. Wilson
+ 
+  This work may be distributed and/or modified under the
+  conditions of the LaTeX Project Public License, either
+  version 1.3 of this license or (at your option) any 
+  later version.
+  The latest version of the license is in
+     http://www.latex-project.org/lppl.txt
+  and version 1.3 or later is part of all distributions of
+  LaTeX version 2003/06/01 or later.
+ 
+  This work has the LPPL maintenance status "author-maintained".
+ 
+  This work consists of the files listed in the README file.
+----------------------------------------------------------------- 
+
+\endpreamble
+
+\keepsilent
+
+%%% \Msg{*** Generating the driver file ***}
+%%% \generateFile{booklet.drv}{t}{\from{booklet.dtx}{driver}}
+
+\Msg{*** Generating the LaTeX2e package files ***}
+
+\generateFile{booklet.sty}{t}{\from{booklet.dtx}{usc}}
+\generateFile{bkltprnt.sty}{t}{\from{booklet.dtx}{prnt}}
+
+\Msg{***********************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the following}
+\Msg{* file(s) into a directory searched by TeX. For more information}
+\Msg{* see the FAQ on CTAN at /help/uk-tex-faq.}
+\Msg{*}
+\Msg{* \space\space booklet.sty}
+\Msg{* \space\space bkltprnt.sty}
+\Msg{*}
+\Msg{*}
+\Msg{* To produce the documentation run the files ending with}
+\Msg{* `.dtx' through LaTeX.}
+\Msg{* For an index, process any name.idx file by:}
+\Msg{* \space\space\space\space makeindex -s gind.ist name}
+\Msg{* For a list of changes, 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