summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/oberdiek/pagesel.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/oberdiek/pagesel.dtx
Initial commit
Diffstat (limited to 'macros/latex/contrib/oberdiek/pagesel.dtx')
-rw-r--r--macros/latex/contrib/oberdiek/pagesel.dtx925
1 files changed, 925 insertions, 0 deletions
diff --git a/macros/latex/contrib/oberdiek/pagesel.dtx b/macros/latex/contrib/oberdiek/pagesel.dtx
new file mode 100644
index 0000000000..54b650226e
--- /dev/null
+++ b/macros/latex/contrib/oberdiek/pagesel.dtx
@@ -0,0 +1,925 @@
+% \iffalse meta-comment
+%
+% File: pagesel.dtx
+% Version: 2016/05/16 v1.9
+% Info: Select pages of a document for output
+%
+% Copyright (C) 1999, 2003, 2006-2008 by
+% Heiko Oberdiek <heiko.oberdiek at googlemail.com>
+% 2016
+% https://github.com/ho-tex/oberdiek/issues
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either
+% version 1.3c of this license or (at your option) any later
+% version. This version of this license is in
+% http://www.latex-project.org/lppl/lppl-1-3c.txt
+% and the latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of
+% LaTeX version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status "maintained".
+%
+% This Current Maintainer of this work is Heiko Oberdiek.
+%
+% This work consists of the main source file pagesel.dtx
+% and the derived files
+% pagesel.sty, pagesel.pdf, pagesel.ins, pagesel.drv.
+%
+% Distribution:
+% CTAN:macros/latex/contrib/oberdiek/pagesel.dtx
+% CTAN:macros/latex/contrib/oberdiek/pagesel.pdf
+%
+% Unpacking:
+% (a) If pagesel.ins is present:
+% tex pagesel.ins
+% (b) Without pagesel.ins:
+% tex pagesel.dtx
+% (c) If you insist on using LaTeX
+% latex \let\install=y\input{pagesel.dtx}
+% (quote the arguments according to the demands of your shell)
+%
+% Documentation:
+% (a) If pagesel.drv is present:
+% latex pagesel.drv
+% (b) Without pagesel.drv:
+% latex pagesel.dtx; ...
+% The class ltxdoc loads the configuration file ltxdoc.cfg
+% if available. Here you can specify further options, e.g.
+% use A4 as paper format:
+% \PassOptionsToClass{a4paper}{article}
+%
+% Programm calls to get the documentation (example):
+% pdflatex pagesel.dtx
+% makeindex -s gind.ist pagesel.idx
+% pdflatex pagesel.dtx
+% makeindex -s gind.ist pagesel.idx
+% pdflatex pagesel.dtx
+%
+% Installation:
+% TDS:tex/latex/oberdiek/pagesel.sty
+% TDS:doc/latex/oberdiek/pagesel.pdf
+% TDS:source/latex/oberdiek/pagesel.dtx
+%
+%<*ignore>
+\begingroup
+ \catcode123=1 %
+ \catcode125=2 %
+ \def\x{LaTeX2e}%
+\expandafter\endgroup
+\ifcase 0\ifx\install y1\fi\expandafter
+ \ifx\csname processbatchFile\endcsname\relax\else1\fi
+ \ifx\fmtname\x\else 1\fi\relax
+\else\csname fi\endcsname
+%</ignore>
+%<*install>
+\input docstrip.tex
+\Msg{************************************************************************}
+\Msg{* Installation}
+\Msg{* Package: pagesel 2016/05/16 v1.9 Select pages of a document for output (HO)}
+\Msg{************************************************************************}
+
+\keepsilent
+\askforoverwritefalse
+
+\let\MetaPrefix\relax
+\preamble
+
+This is a generated file.
+
+Project: pagesel
+Version: 2016/05/16 v1.9
+
+Copyright (C) 1999, 2003, 2006-2008 by
+ Heiko Oberdiek <heiko.oberdiek at googlemail.com>
+
+This work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either
+version 1.3c of this license or (at your option) any later
+version. This version of this license is in
+ http://www.latex-project.org/lppl/lppl-1-3c.txt
+and the latest version of this license is in
+ http://www.latex-project.org/lppl.txt
+and version 1.3 or later is part of all distributions of
+LaTeX version 2005/12/01 or later.
+
+This work has the LPPL maintenance status "maintained".
+
+This Current Maintainer of this work is Heiko Oberdiek.
+
+This work consists of the main source file pagesel.dtx
+and the derived files
+ pagesel.sty, pagesel.pdf, pagesel.ins, pagesel.drv.
+
+\endpreamble
+\let\MetaPrefix\DoubleperCent
+
+\generate{%
+ \file{pagesel.ins}{\from{pagesel.dtx}{install}}%
+ \file{pagesel.drv}{\from{pagesel.dtx}{driver}}%
+ \usedir{tex/latex/oberdiek}%
+ \file{pagesel.sty}{\from{pagesel.dtx}{package}}%
+ \nopreamble
+ \nopostamble
+% \usedir{source/latex/oberdiek/catalogue}%
+% \file{pagesel.xml}{\from{pagesel.dtx}{catalogue}}%
+}
+
+\catcode32=13\relax% active space
+\let =\space%
+\Msg{************************************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the following}
+\Msg{* file into a directory searched by TeX:}
+\Msg{*}
+\Msg{* pagesel.sty}
+\Msg{*}
+\Msg{* To produce the documentation run the file `pagesel.drv'}
+\Msg{* through LaTeX.}
+\Msg{*}
+\Msg{* Happy TeXing!}
+\Msg{*}
+\Msg{************************************************************************}
+
+\endbatchfile
+%</install>
+%<*ignore>
+\fi
+%</ignore>
+%<*driver>
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesFile{pagesel.drv}%
+ [2016/05/16 v1.9 Select pages of a document for output (HO)]%
+\documentclass{ltxdoc}
+\usepackage{holtxdoc}[2011/11/22]
+\begin{document}
+ \DocInput{pagesel.dtx}%
+\end{document}
+%</driver>
+% \fi
+%
+%
+% \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 \~}
+%
+% \GetFileInfo{pagesel.drv}
+%
+% \title{The \xpackage{pagesel} package}
+% \date{2016/05/16 v1.9}
+% \author{Heiko Oberdiek\thanks
+% {Please report any issues at https://github.com/ho-tex/oberdiek/issues}\\
+% \xemail{heiko.oberdiek at googlemail.com}}
+%
+% \maketitle
+%
+% \begin{abstract}
+% Single pages or page areas can be selected for output.
+% \end{abstract}
+%
+% \tableofcontents
+%
+% \newenvironment{param}{^^A
+% \newcommand{\entry}[1]{\meta{\###1}:&}^^A
+% \begin{tabular}[t]{@{}l@{ }l@{}}^^A
+% }{^^A
+% \end{tabular}^^A
+% }
+%
+% \newcommand*{\Option}[1]{\textsf{#1}}
+%
+% \section{Usage}
+% The package \Package{pagesel} is a \LaTeXe\ package:
+% \begin{quote}
+% |\usepackage|\oarg{options}|{pagesel}|
+% \end{quote}
+% (For plain\TeX\ and \LaTeX\,2.09 the similar package
+% \URL{\Package{selectp}}^^A
+% {http://ctan.org/pkg/selectp}
+% from \NameEmail{Donald Arsenau}{asnd@triumf.ca} can be used.)
+%
+% Depending on the options the package works in two modes:
+% \begin{enumerate}
+% \item If no page selecting option is present, so the package
+% ignores the other options and finishes itself. So no
+% page will be suppressed by the package and auxiliary files
+% will be written.
+% \item With at least one page selecting option the specified
+% pages are selected and the other are suppressed.
+% The default for this mode is that auxiliary will not be
+% overwritten. (This can be changed by an option.)
+% \end{enumerate}
+%
+% \subsection{Page selecting}
+% The package \Package{pagesel} sets up a new counter that is
+% incremented by each \cmd{\shipout}.
+% In this way the package counts the output pages regardless the value
+% of the page counter. So each page can individually by addressed,
+% even if there are several pages with the same page number.
+%
+% \subsubsection{Options\texorpdfstring{ for selecting pages}{}}
+% \begin{description}
+% \item[\Option{odd}:] The output pages must have an odd number.
+% All even output pages are suppressed. If there are no
+% page areas specified so all odd pages are print. With
+% page areas only the odd pages in this areas are selected.
+% \item[\Option{even}:] The opposite of option \Option{odd}.
+% \item[Page area:] A page area consists of three elements:
+% the starting output page number, an ``area'' hyphen, and
+% the output page number of the last page in this area.
+% Each component is optional, so there are four kinds
+% to spezify a page area:
+% \begin{description}
+% \item[\meta{m}\Option{-}\meta{n}:] All pages between
+% \meta{m} and \meta{n} inclusive.
+% \item[\Option{-}\meta{n}:] All pages until \meta{n} inclusive.
+% \item[\meta{m}\Option{-}:] The page area starts with \meta{m}
+% and all pages to the end of document are selected.
+% \item[\Option{-}:] All pages (not very useful).
+% \item[\meta{s}:] The single page \meta{s}.
+% \end{description}
+% \end{description}
+%
+% \subsubsection{Examples}
+% \newcommand*{\exam}[1]{\texttt{\strut[#1]}}^^A hash-ok
+% \begin{tabular}{ll}
+% Options & Output pages\\
+% \hline
+% \exam{1, 4, 9}& 1, 4, and 9\\
+% \exam{7-10, 3}& 3, 7, 8, 9, and 10\\
+% \exam{odd, 3-6}& 3, and 5\\
+% \exam{-4, 3, even, 7-8}& 2, 4, and 8\\
+% \end{tabular}
+%
+% \subsection{Auxiliary files}
+% If a page is suppressed, the \cmd{\write} commands are not
+% performed. Labels, index entries, or entries for the
+% table of contents aren't written. So it is likely that
+% the table of contents, registers, and lists are incomplete.
+% \subsubsection{Options\texorpdfstring{ for handling auxiliary files}{}}
+% \begin{description}
+% \item[\Option{nofiles}:] This is the default. Auxiliary files are
+% read but not written or changed. Also the job is aborted
+% after the last selected page for saving time.
+% \item[\Option{nonofiles}/\Option{files}:] Auxiliary files are
+% written.
+% \end{description}
+% \subsubsection{\texorpdfstring{Package }{}\Package{hyperref}}
+% In old versions of \Package{hyperref} [1999/04/12 v6.55] (and below)
+% there is a bug with \cmd{\nofiles}:
+% \begin{itemize}
+% \item Some ``garbage'' appears on terminal and in the log file.
+% This is harmless and can be ignored.
+% \item The outline auxiliary file \cmd{\jobname.out}, however,
+% is opened and truncated to zero bytes.
+% Version 1.0 of this package had
+% loaded a patch file \File{hypnofil.tex}, if it detects
+% \Package{hyperref} to get \cmd{\nofiles} work.
+%
+% With the new version of \Package{hyperref} [1999/04/13 v6.56]
+% \cmd{\nofiles} works now. Therefore the workaround code
+% is no longer needed and removed.
+% \end{itemize}
+%
+% \StopEventually{
+% }
+%
+% \section{Implementation}
+% \subsection{Package}
+% \begin{macrocode}
+%<*package>
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{pagesel}
+ [2016/05/16 v1.9 Select pages of a document for output (HO)]%
+% \end{macrocode}
+%
+% If the package is loaded twice, the package code does not
+% work. So stop loading the package, if it is already loaded.
+% \begin{macrocode}
+\@ifundefined{ps@makevoid}{}{%
+ \PackageWarningNoLine{pagesel}{Package already loaded.}%
+ \endinput
+}
+% \end{macrocode}
+%
+% \begin{macro}{\ps@makevoid}
+% Macro \cmd{\ps@makevoid} clears the output box. Because
+% nothing is shipped out and this is intended, we reduce
+% the counter \cmd{\deadcycles} in order to avoid problems, if
+% more than \cmd{\maxdeadcycles} pages are omitted.
+% \begin{macrocode}
+\newcommand*{\ps@makevoid}{%
+ \global\setbox\@cclv\copy\voidb@x
+ \begingroup
+ \count@=\deadcycles
+ \advance\count@ by -1\relax
+ \deadcycles=\count@
+ \endgroup
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ps@oddpages}
+% \begin{macrocode}
+\newcommand*\ps@oddpages{0}
+\DeclareOption{odd}{\renewcommand*\ps@oddpages{1}}
+\DeclareOption{even}{\renewcommand*\ps@oddpages{2}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+\DeclareOption{nofiles}{\let\ps@nofiles\nofiles}
+\DeclareOption{nonofiles}{\let\ps@nofiles\@empty}
+\DeclareOption{files}{\let\ps@nofiles\@empty}
+\ExecuteOptions{nofiles}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\DeclareOption*{%
+ \begingroup
+ \expandafter\ps@checkoption\CurrentOption-\END
+ \edef\x{\endgroup\noexpand\ps@store{\ps@first}{\ps@last}}%
+ \x
+}
+% \end{macrocode}
+%
+% \begin{macro}{\ps@checkoption}
+% \begin{macrocode}
+\newcommand\ps@checkoption{}
+\def\ps@checkoption#1-#2\END{%
+ \ifx\\#2\\%
+ \ifx\\#1\\%
+ % empty option
+ \def\ps@first{\maxdimen}%
+ \def\ps@last{\maxdimen}%
+ \else
+ \edef\ps@first{#1}%
+ \edef\ps@last{#1}%
+ \fi
+ \else
+ \ifx\\#1\\%
+ \def\ps@first{-\maxdimen}%
+ \else
+ \edef\ps@first{#1}%
+ \fi
+ \ps@checklast#2%
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ps@checklast}
+% \begin{macrocode}
+\newcommand\ps@checklast{}
+\def\ps@checklast#1-{%
+ \ifx\\#1\\%
+ \def\ps@last{\maxdimen}%
+ \else
+ \edef\ps@last{#1}%
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ps@store}
+% \begin{macrocode}
+\newcommand*{\ps@store}[2]{%
+ \expandafter\def\expandafter\ps@testlist\expandafter{%
+ \ps@testlist\ps@pagetest{#1}{#2}%
+ }%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ps@testlist}
+% \begin{macrocode}
+\newcommand*\ps@testlist{}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+\ProcessOptions
+% \end{macrocode}
+%
+% \begin{macrocode}
+\begingroup
+ \edef\x{%
+ \ifnum\ps@oddpages>0 \relax\fi
+ \ifx\ps@testlist\@empty\else\relax\fi
+ }%
+ \ifx\x\@empty
+ \endgroup
+ \PackageInfo{pagesel}{Nothing to do}%
+ \expandafter\endinput
+ \fi
+\endgroup
+% \end{macrocode}
+%
+% \begin{macrocode}
+\RequirePackage{everyshi}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\ps@nofiles
+% \end{macrocode}
+%
+% \begin{macro}{\c@ps@count}
+% \begin{macrocode}
+\newcounter{ps@count}
+\setcounter{ps@count}{0}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ps@ReturnAfterElseFi}
+% \begin{macro}{\ps@ReturnAfterFi}
+% \begin{macrocode}
+\long\def\ps@ReturnAfterElseFi#1\else#2\fi{\fi#1}
+\long\def\ps@ReturnAfterFi#1\fi{\fi#1}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \begin{macrocode}
+\newcommand{\ps@lastpage}{\maxdimen}
+\ifx\ps@nofiles\nofiles
+ \ifx\ps@testlist\@empty
+ \else
+ \def\ps@lastpage{0}%
+ \newcommand*{\ps@pagetest}[2]{%
+ \ifnum#2>\ps@lastpage\relax
+ \def\ps@lastpage{#2}%
+ \fi
+ }%
+ \ps@testlist
+ \let\ps@pagetest\relax
+ \fi
+\fi
+% \end{macrocode}
+%
+% \begin{macro}{\ps@ifinset}
+% \begin{macrocode}
+\newcommand*{\ps@ifinset}[4]{%
+ \ifnum#1>\value{ps@count}%
+ \ps@ReturnAfterElseFi{#4}%
+ \else
+ \ps@ReturnAfterFi{%
+ \ifnum#2<\value{ps@count}%
+ \ps@ReturnAfterElseFi{#4}%
+ \else
+ \ps@ReturnAfterFi{#3}%
+ \fi
+ }%
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\ps@pagetest}
+% \begin{macrocode}
+\newcommand*{\ps@pagetest}[2]{%
+ \ps@ifinset{#1}{#2}{\let\ps@next\@empty}{}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+\EveryShipout{%
+ \stepcounter{ps@count}%
+ \ifnum\value{ps@count}>\ps@lastpage\relax
+ \global\output{%
+ \ps@cleanup@if
+ \ps@group@message
+ \typeout{%
+ Package pagesel Notice: Aborting LaTeX job %
+ after last selected page (\ps@lastpage).%
+ }%
+ \ps@message@ignore
+ \global\setbox\@cclv\box\voidb@x
+ \deadcycles0\relax
+% \end{macrocode}
+% First leave the output group before ending the job.
+% \begin{macrocode}
+ \aftergroup\@@end
+ }%
+ \fi
+ \let\ps@next\@empty
+ \ifx\ps@testlist\@empty
+ \else
+ \let\ps@next\ps@makevoid
+ \ps@testlist
+ \fi
+ \ifnum\ps@oddpages=1 %
+ \ifodd\value{ps@count}%
+ \else
+ \let\ps@next\ps@makevoid
+ \fi
+ \fi
+ \ifnum\ps@oddpages=2 %
+ \ifodd\value{ps@count}%
+ \let\ps@next\ps@makevoid
+ \else
+ \fi
+ \fi
+ \ps@begindvi
+ \ps@next
+}
+% \end{macrocode}
+%
+% \begin{macrocode}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname currentiflevel\endcsname\relax
+ \let\ps@cleanup@if\@empty
+\else
+ \def\ps@cleanup@if{%
+ \ifnum\currentiflevel>\@ne
+ \csname fi\endcsname
+ \expandafter\ps@cleanup@if
+ \fi
+ }%
+\fi
+% \end{macrocode}
+% Because of \cs{aftergroup} it is too dangerous to perform
+% a similar cleanup for groups.
+% \begin{macrocode}
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname currentgrouplevel\endcsname\relax
+ \let\ps@group@message\@empty
+ \def\ps@message@ignore{%
+ \typeout{%
+ (pagesel) \space\space\@spaces\@spaces\@spaces
+ Messages (\string\end\space occurred ...) can be ignored.%
+ }%
+ }%
+\else
+ \def\ps@group@message{%
+ \ifnum\currentgrouplevel>\@ne
+ \def\ps@message@ignore{%
+ \typeout{%
+ (pagesel) \space\space\@spaces\@spaces\@spaces
+ Message (\string\end\space occurred ...) %
+ can be ignored.%
+ }%
+ }%
+ \else
+ \let\ps@message@ignore\@empty
+ \fi
+ }%
+\fi
+% \end{macrocode}
+%
+% \subsection{AtBeginDvi hook support}
+%
+% The material of box \cs{@begindvibox} is recorded in parallel
+% in box \cs{ps@begindvibox}.
+% \begin{macrocode}
+\newbox\ps@begindvibox
+\ifvoid\@begindvibox
+\else
+ \global\setbox\ps@begindvibox\vbox{%
+ \unvbox\@begindvibox
+ }%
+\fi
+\let\ps@org@AtBeginDvi\AtBeginDvi
+\def\AtBeginDvi#1{%
+ \global\setbox\ps@begindvibox\vbox{%
+ \unvbox\ps@begindvibox
+ #1%
+ }%
+ \ps@org@AtBeginDvi{#1}%
+}
+% \end{macrocode}
+%
+% \begin{macro}{\ps@begindvi}
+% Macro \cs{ps@begindvi} is called the similar way as \cs{@begindvi}.
+% If the first page is printed, then \cs{AtBeginDvi} should work
+% as usual. Otherwise the contents of box \cs{ps@begindvibox} is
+% set on the first selected page.
+% \begin{macrocode}
+\def\ps@begindvi{%
+ \ifx\ps@next\@empty
+ \global\let\ps@begindvi\@empty
+ \else
+ \global\let\ps@begindvi\ps@begindvi@do
+ \fi
+}
+\def\ps@begindvi@do{%
+ \ifx\ps@next\@empty
+ \setbox\@cclv\vbox{%
+ \unvbox\ps@begindvibox
+ \box\@cclv
+ }%
+ \global\let\ps@begindvi\@empty
+ \fi
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+%</package>
+% \end{macrocode}
+%
+% \section{Installation}
+%
+% \subsection{Download}
+%
+% \paragraph{Package.} This package is available on
+% CTAN\footnote{\url{http://ctan.org/pkg/pagesel}}:
+% \begin{description}
+% \item[\CTAN{macros/latex/contrib/oberdiek/pagesel.dtx}] The source file.
+% \item[\CTAN{macros/latex/contrib/oberdiek/pagesel.pdf}] Documentation.
+% \end{description}
+%
+%
+% \paragraph{Bundle.} All the packages of the bundle `oberdiek'
+% are also available in a TDS compliant ZIP archive. There
+% the packages are already unpacked and the documentation files
+% are generated. The files and directories obey the TDS standard.
+% \begin{description}
+% \item[\CTAN{install/macros/latex/contrib/oberdiek.tds.zip}]
+% \end{description}
+% \emph{TDS} refers to the standard ``A Directory Structure
+% for \TeX\ Files'' (\CTAN{tds/tds.pdf}). Directories
+% with \xfile{texmf} in their name are usually organized this way.
+%
+% \subsection{Bundle installation}
+%
+% \paragraph{Unpacking.} Unpack the \xfile{oberdiek.tds.zip} in the
+% TDS tree (also known as \xfile{texmf} tree) of your choice.
+% Example (linux):
+% \begin{quote}
+% |unzip oberdiek.tds.zip -d ~/texmf|
+% \end{quote}
+%
+% \paragraph{Script installation.}
+% Check the directory \xfile{TDS:scripts/oberdiek/} for
+% scripts that need further installation steps.
+% Package \xpackage{attachfile2} comes with the Perl script
+% \xfile{pdfatfi.pl} that should be installed in such a way
+% that it can be called as \texttt{pdfatfi}.
+% Example (linux):
+% \begin{quote}
+% |chmod +x scripts/oberdiek/pdfatfi.pl|\\
+% |cp scripts/oberdiek/pdfatfi.pl /usr/local/bin/|
+% \end{quote}
+%
+% \subsection{Package installation}
+%
+% \paragraph{Unpacking.} The \xfile{.dtx} file is a self-extracting
+% \docstrip\ archive. The files are extracted by running the
+% \xfile{.dtx} through \plainTeX:
+% \begin{quote}
+% \verb|tex pagesel.dtx|
+% \end{quote}
+%
+% \paragraph{TDS.} Now the different files must be moved into
+% the different directories in your installation TDS tree
+% (also known as \xfile{texmf} tree):
+% \begin{quote}
+% \def\t{^^A
+% \begin{tabular}{@{}>{\ttfamily}l@{ $\rightarrow$ }>{\ttfamily}l@{}}
+% pagesel.sty & tex/latex/oberdiek/pagesel.sty\\
+% pagesel.pdf & doc/latex/oberdiek/pagesel.pdf\\
+% pagesel.dtx & source/latex/oberdiek/pagesel.dtx\\
+% \end{tabular}^^A
+% }^^A
+% \sbox0{\t}^^A
+% \ifdim\wd0>\linewidth
+% \begingroup
+% \advance\linewidth by\leftmargin
+% \advance\linewidth by\rightmargin
+% \edef\x{\endgroup
+% \def\noexpand\lw{\the\linewidth}^^A
+% }\x
+% \def\lwbox{^^A
+% \leavevmode
+% \hbox to \linewidth{^^A
+% \kern-\leftmargin\relax
+% \hss
+% \usebox0
+% \hss
+% \kern-\rightmargin\relax
+% }^^A
+% }^^A
+% \ifdim\wd0>\lw
+% \sbox0{\small\t}^^A
+% \ifdim\wd0>\linewidth
+% \ifdim\wd0>\lw
+% \sbox0{\footnotesize\t}^^A
+% \ifdim\wd0>\linewidth
+% \ifdim\wd0>\lw
+% \sbox0{\scriptsize\t}^^A
+% \ifdim\wd0>\linewidth
+% \ifdim\wd0>\lw
+% \sbox0{\tiny\t}^^A
+% \ifdim\wd0>\linewidth
+% \lwbox
+% \else
+% \usebox0
+% \fi
+% \else
+% \lwbox
+% \fi
+% \else
+% \usebox0
+% \fi
+% \else
+% \lwbox
+% \fi
+% \else
+% \usebox0
+% \fi
+% \else
+% \lwbox
+% \fi
+% \else
+% \usebox0
+% \fi
+% \else
+% \lwbox
+% \fi
+% \else
+% \usebox0
+% \fi
+% \end{quote}
+% If you have a \xfile{docstrip.cfg} that configures and enables \docstrip's
+% TDS installing feature, then some files can already be in the right
+% place, see the documentation of \docstrip.
+%
+% \subsection{Refresh file name databases}
+%
+% If your \TeX~distribution
+% (\teTeX, \mikTeX, \dots) relies on file name databases, you must refresh
+% these. For example, \teTeX\ users run \verb|texhash| or
+% \verb|mktexlsr|.
+%
+% \subsection{Some details for the interested}
+%
+% \paragraph{Attached source.}
+%
+% The PDF documentation on CTAN also includes the
+% \xfile{.dtx} source file. It can be extracted by
+% AcrobatReader 6 or higher. Another option is \textsf{pdftk},
+% e.g. unpack the file into the current directory:
+% \begin{quote}
+% \verb|pdftk pagesel.pdf unpack_files output .|
+% \end{quote}
+%
+% \paragraph{Unpacking with \LaTeX.}
+% The \xfile{.dtx} chooses its action depending on the format:
+% \begin{description}
+% \item[\plainTeX:] Run \docstrip\ and extract the files.
+% \item[\LaTeX:] Generate the documentation.
+% \end{description}
+% If you insist on using \LaTeX\ for \docstrip\ (really,
+% \docstrip\ does not need \LaTeX), then inform the autodetect routine
+% about your intention:
+% \begin{quote}
+% \verb|latex \let\install=y\input{pagesel.dtx}|
+% \end{quote}
+% Do not forget to quote the argument according to the demands
+% of your shell.
+%
+% \paragraph{Generating the documentation.}
+% You can use both the \xfile{.dtx} or the \xfile{.drv} to generate
+% the documentation. The process can be configured by the
+% configuration file \xfile{ltxdoc.cfg}. For instance, put this
+% line into this file, if you want to have A4 as paper format:
+% \begin{quote}
+% \verb|\PassOptionsToClass{a4paper}{article}|
+% \end{quote}
+% An example follows how to generate the
+% documentation with pdf\LaTeX:
+% \begin{quote}
+%\begin{verbatim}
+%pdflatex pagesel.dtx
+%makeindex -s gind.ist pagesel.idx
+%pdflatex pagesel.dtx
+%makeindex -s gind.ist pagesel.idx
+%pdflatex pagesel.dtx
+%\end{verbatim}
+% \end{quote}
+%
+% \section{Catalogue}
+%
+% The following XML file can be used as source for the
+% \href{http://mirror.ctan.org/help/Catalogue/catalogue.html}{\TeX\ Catalogue}.
+% The elements \texttt{caption} and \texttt{description} are imported
+% from the original XML file from the Catalogue.
+% The name of the XML file in the Catalogue is \xfile{pagesel.xml}.
+% \begin{macrocode}
+%<*catalogue>
+<?xml version='1.0' encoding='us-ascii'?>
+<!DOCTYPE entry SYSTEM 'catalogue.dtd'>
+<entry datestamp='$Date$' modifier='$Author$' id='pagesel'>
+ <name>pagesel</name>
+ <caption>Select pages of a document for output.</caption>
+ <authorref id='auth:oberdiek'/>
+ <copyright owner='Heiko Oberdiek' year='1999,2003,2006-2008'/>
+ <license type='lppl1.3'/>
+ <version number='1.9'/>
+ <description>
+ Selects single pages, ranges of pages, odd pages or even pages
+ for output.
+ <p/>
+ The package is part of the <xref refid='oberdiek'>oberdiek</xref>
+ bundle.
+ </description>
+ <documentation details='Package documentation'
+ href='ctan:/macros/latex/contrib/oberdiek/pagesel.pdf'/>
+ <ctan file='true' path='/macros/latex/contrib/oberdiek/pagesel.dtx'/>
+ <miktex location='oberdiek'/>
+ <texlive location='oberdiek'/>
+ <install path='/macros/latex/contrib/oberdiek/oberdiek.tds.zip'/>
+</entry>
+%</catalogue>
+% \end{macrocode}
+%
+% \begin{History}
+% \begin{Version}{1999/03/01 v0.9}
+% \item
+% The first version was built as a response to a question
+% of \NameEmail{Dirk Kuypers}{dk@comnets.rwth-aachen.de},
+% published in the newsgroup
+% \href{news:de.comp.text.tex}{de.comp.text.tex}:\\
+% \URL{``\link{Re: pdflatex nur fuer bestimmte Seiten?!?}''}^^A
+% {http://groups.google.com/group/de.comp.text.tex/msg/6b68c7b3439fb658}
+% \end{Version}
+% \begin{Version}{1999/04/05 v1.0}
+% \item
+% Documentation added in dtx format.
+% \item
+% Copyright: LPPL (\CTAN{macros/latex/base/lppl.txt})
+% \item
+% Options |odd|, |even| added.
+% \item
+% \cmd{\nofiles} added, bug fix for \Package{hyperref}.
+% \item
+% Abort loading of package, if nothing to do.
+% \end{Version}
+% \begin{Version}{1999/04/13 v1.1}
+% \item
+% \cs{nofiles} bug fix removed
+% because of \xpackage{hyperref} 6.55.
+% \item
+% First CTAN release.
+% \end{Version}
+% \begin{Version}{2003/06/05 v1.2}
+% \item
+% \cs{deadcyles} is decremented for omitted pages.
+% \item
+% LPPL 1.2.
+% \end{Version}
+% \begin{Version}{2006/02/20 v1.3}
+% \item
+% Code is not changed.
+% \item
+% New DTX framework.
+% \item
+% LPPL 1.3
+% \end{Version}
+% \begin{Version}{2006/03/02 v1.4}
+% \item
+% Support for \cs{AtBeginDvi} added.
+% \end{Version}
+% \begin{Version}{2006/03/07 v1.5}
+% \item
+% Job is aborted after last selected page.
+% \end{Version}
+% \begin{Version}{2007/04/11 v1.6}
+% \item
+% Line ends sanitized.
+% \end{Version}
+% \begin{Version}{2007/04/12 v1.7}
+% \item
+% Hard coded box number 255 replaced by macro \cs{@cclv}.
+% \end{Version}
+% \begin{Version}{2008/08/11 v1.8}
+% \item
+% Code is not changed.
+% \item
+% URL updated from \texttt{www.dejanews.com}
+% to \texttt{groups.google.com}.
+% \end{Version}
+% \begin{Version}{2016/05/16 v1.9}
+% \item
+% Documentation updates.
+% \end{Version}
+% \end{History}
+%
+% \PrintIndex
+%
+% \Finale
+\endinput