doc/latex

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

11 files changed, 471 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/pdfpages/dummy-l.pdf b/Master/texmf-dist/doc/latex/pdfpages/dummy-l.pdf
new file mode 100644
index 00000000000..5d4ad9de0b4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/dummy-l.pdf
diff --git a/Master/texmf-dist/doc/latex/pdfpages/dummy.pdf b/Master/texmf-dist/doc/latex/pdfpages/dummy.pdf
new file mode 100644
index 00000000000..95b4dc7ae7f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/dummy.pdf
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.pdf b/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.pdf
new file mode 100644
index 00000000000..787260d25a2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.pdf
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.tex b/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.tex
new file mode 100644
index 00000000000..2dbfdc5a32e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.tex
@@ -0,0 +1,170 @@
+%%
+%% This is file `pdf-ex.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% pdfpages.dtx  (with options: `example1')
+%% 
+%% This file is a demonstration of the pdfpages package.
+%% Run it through pdfLaTeX.
+%% 
+%% Please send error reports and suggestions for improvements to
+%%   Andreas MATTHIAS <amat@kabsi.at>.
+%%
+
+\documentclass[a4paper,12pt]{article}
+\usepackage[final]{pdfpages}
+\usepackage{verbatim}
+%% Uncomment the following lines, if you want to produce thumbnails.
+%%\usepackage{pdflscape}
+%%\usepackage{thumbpdf}
+
+\newcounter{example}
+\setcounter{example}{1}
+
+\newenvironment{example}
+  {\par\vskip\topsep%
+   \noindent\textbf{Example \arabic{example}:}%
+   \stepcounter{example}%
+   \par\vskip\topsep%
+   \minipage{.9\linewidth}%
+   \verbatim}
+  {\endverbatim%
+   \endminipage\par\vskip\topsep}
+
+\begin{document}
+
+\title{A Demonstration of the \texttt{pdfpages} Package}
+\author{Andreas MATTHIAS}
+\maketitle
+
+This is a demonstration of the \texttt{pdfpages} package.
+It is \textit{not} the documentation of the package.
+To get the documentation run: `latex pdfpages.dtx'
+
+\tableofcontents
+
+\section{Inserting Pages:}
+\begin{example}
+\includepdf[pages=3-5]{dummy.pdf}
+\end{example}
+\includepdf[pages=3-5]{dummy.pdf}
+
+\section{Using the \texttt{nup} Option}
+Arranging several logical pages on one sheet of paper.
+
+\begin{example}
+\includepdf[nup=1x2, landscape, pages=4-7]{dummy.pdf}
+\end{example}
+\includepdf[nup=1x2, landscape, pages=4-7]{dummy.pdf}
+
+Use the option \texttt{turn=false}, if the pages
+should not be displayed in landscape orientation.
+(If the last two pages were not displayed in
+landscape orientation, you use a PDF viewer that
+does not support this option.)
+
+\begin{example}
+\includepdf[nup=1x2, landscape,
+            pages=4-7, turn=false]{dummy.pdf}
+\end{example}
+\includepdf[nup=1x2, landscape,
+            pages=4-7, turn=false]{dummy.pdf}
+
+\begin{example}
+\includepdf[nup=1x2, pages=1-4]{dummy-l.pdf}
+\end{example}
+\includepdf[nup=1x2, pages=1-4]{dummy-l.pdf}
+
+\noindent
+With the option \texttt{pages} special pages and
+ranges of pages can be selected.
+
+\begin{example}
+\includepdf[nup=3x2, pages={1,4-6,8,10}]{dummy.pdf}
+\end{example}
+\includepdf[nup=3x2, pages={1,4-6,8,10}]{dummy.pdf}
+
+\noindent
+A column-major layout can be achieved with the
+option \texttt{column}.
+
+\begin{example}
+\includepdf[nup=2x2, pages=1-4, column]{dummy.pdf}
+\end{example}
+\includepdf[nup=2x2, pages=1-4, column]{dummy.pdf}
+
+\noindent
+Sometimes it might be useful to put an empty page
+at the beginning.
+\begin{example}
+\includepdf[nup=2x2, pages={{},5-7}]{dummy.pdf}
+\end{example}
+\includepdf[nup=2x2, pages={{},5-7}]{dummy.pdf}
+
+\section{Changing Layout}
+
+To put some space between the logical pages, use the option
+\texttt{delta}.
+
+Any options of \verb|\includegraphics| are allowed in
+\verb|\includepdf| as well. See the \texttt{scale}
+option in the next example.
+\begin{example}
+\includepdf[nup=2x2, pages=3-6, scale=.8,
+            delta=8mm 11mm, frame]{dummy.pdf}
+\end{example}
+\includepdf[nup=2x2, pages=3-6, scale=.8,
+            delta=8mm 11mm, frame]{dummy.pdf}
+
+\noindent
+By default the output is centered, as you could see in
+the last examples. With the \texttt{offset} option it is
+possible to displace the output.
+
+\begin{example}
+\includepdf[nup=2x2, pages=3-6, scale=.8,
+            offset=5mm 7mm, frame]{dummy.pdf}
+\end{example}
+\includepdf[nup=2x2, pages=3-6, scale=.8,
+            offset=5mm 7mm, frame]{dummy.pdf}
+
+\noindent
+To remove the header and the footer of the inserted
+document use the \texttt{trim} and \texttt{clip}
+options of the \texttt{graphicx} package.
+
+\begin{example}
+\includepdf[nup=2x2, pages=1-4,
+            trim=0 40mm 0 40mm,
+            clip, pagecommand={}]{dummy.pdf}
+\end{example}
+
+\noindent The option
+\verb|pagecommand={\thispagestyle{empty}}|
+is set by default. If you don't want the page style
+to be set to empty, you can remove this default
+setting by using the \texttt{pagecommand} option
+as follows:
+\verb|pagecommand={}|.
+
+\includepdf[nup=2x2, pages=1-4,
+            trim=0 40mm 0 40mm,
+            clip, pagecommand={}]{dummy.pdf}
+
+\noindent
+You like the crazy way? Then try this one \texttt{;-)}
+\begin{example}
+\includepdf[pages={3,4}, nup=1x2,
+            landscape, scale=1.1,
+            angle=30, delta=0 -85mm]{dummy.pdf}
+\end{example}
+\includepdf[pages={3,4}, nup=1x2,
+            landscape, scale=1.1,
+            angle=30, delta=0 -85mm]{dummy.pdf}
+
+\end{document}
+\endinput
+%%
+%% End of file `pdf-ex.tex'.
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.pdf b/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.pdf
new file mode 100644
index 00000000000..6703e24d0e4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.pdf
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex b/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex
new file mode 100644
index 00000000000..1d737651a18
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex
@@ -0,0 +1,142 @@
+%%
+%% This is file `pdf-hyp.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% pdfpages.dtx  (with options: `example2')
+%% 
+%% This file is a demonstration of the pdfpages package.
+%% Run it through pdfLaTeX.
+%% 
+%% Please send error reports and suggestions for improvements to
+%%   Andreas MATTHIAS <amat@kabsi.at>.
+%%
+
+\documentclass[a4paper,12pt]{article}
+\usepackage[final]{pdfpages}
+\usepackage{verbatim}
+%% Uncomment the following lines, if you want to produce thumbnails.
+%%\usepackage{pdflscape}
+%%\usepackage{thumbpdf}
+\usepackage[bookmarksopen]{hyperref}
+
+\newcounter{example}
+\setcounter{example}{1}
+
+\newenvironment{example}
+  {\par\vskip\topsep%
+   \noindent\textbf{Example \arabic{example}:}%
+   \stepcounter{example}%
+   \par\vskip\topsep%
+   \minipage{.9\linewidth}%
+   \verbatim}
+  {\endverbatim%
+   \endminipage\vskip\topsep}
+
+\newcommand{\meta}[1]{\ensuremath\langle\texttt{#1}\ensuremath\rangle}
+\newcommand{\link}[2]{\meta{#1}.\meta{#2}}
+
+\newcommand*{\bookmark}[3][0]{%
+  \pdfoutline user {<< /S /GoTo /D (#3) >>} count #1 {#2}}
+
+\begin{document}
+
+\title{A Demonstration of the Hypertext Operations\\
+       of the \texttt{pdfpages} Package}
+\author{Andreas MATTHIAS}
+\maketitle
+
+This is a demonstration of the \texttt{pdfpages} package.
+It is \textit{not} the documentation of the package.
+To get the documentation run: `latex pdfpages.dtx'
+
+\tableofcontents
+
+\section{Hyperlinks}
+\subsection{Links to the inserted Pages}
+
+Hyperlinks are created by using the option \texttt{link}
+of the \verb|\includepdf| command. Each inserted page
+gets a link name consisting of the filename and
+the page number: \link{filename}{page number}
+
+\begin{example}
+\includepdf[pages=1-2, link]{dummy.pdf}
+\end{example}
+
+In this example the two pages have the link names
+`\texttt{dummy.pdf.1}' and `\texttt{dummy.pdf.2}'.
+Setting links to these
+pages, can be done easily with the \verb|\hyperlink|
+macro from the \texttt{hyperref.sty} package:
+
+\bigskip
+\verb|\hyperlink{dummy.pdf.1}{Page 1}|\hskip10pt \hyperlink{dummy.pdf.1}{Page 1}\par
+\verb|\hyperlink{dummy.pdf.2}{Page 2}|\hskip10pt \hyperlink{dummy.pdf.2}{Page 2}
+\bigskip
+
+This way you can refer to the \hyperlink{dummy.pdf.1}{first}
+and the \hyperlink{dummy.pdf.2}{second page}.
+
+\includepdf[pages=1-2, link]{dummy.pdf}
+
+Inserting the same page twice would result in two
+identical link names. To prevent this use the option
+\texttt{linkname} to specify another name for the links.
+
+\begin{example}
+\includepdf[pages=1-2, nup=1x2, landscape,
+            link, linkname=mylink]{dummy.pdf}
+\end{example}
+
+\noindent
+Now the links are called `\texttt{mylink.1}' and
+`\texttt{mylink.2}'.
+
+\bigskip
+\verb|\hyperlink{mylink.1}{Page 1}|\hskip10pt \hyperlink{mylink.1}{Page 1}\par
+\verb|\hyperlink{mylink.2}{Page 2}|\hskip10pt \hyperlink{mylink.2}{Page 2}
+
+\includepdf[pages=1-2, nup=1x2, landscape,
+            link, linkname=mylink]{dummy.pdf}
+
+\subsection{Links to the original Document}
+
+Each page can be a hyperlink to the document from
+which it was extracted. This can be done with the
+option \texttt{linktodoc}.
+
+Click on the inserted pages and see what happens.
+
+\begin{example}
+\includepdf[pages=1-4, nup=2x2, linktodoc]{dummy.pdf}
+\end{example}
+\includepdf[pages=1-4, nup=2x2, linktodoc]{dummy.pdf}
+
+\section{Article Threads}
+
+In a PDF document one or more article threads may be defined.
+An article thread is a logical connected sequence of content
+items.
+
+With the option \texttt{thread} the inserted pages become
+an article thread.
+
+\begin{example}
+\includepdf[pages=1-4, nup=2x2, column,
+            landscape, thread]{dummy-l.pdf}
+\end{example}
+
+In Acrobat Reader the mouse pointer changes to a hand with
+a little arrow in it when moved over an article thread.
+By clicking on the page you can easily follow the logical
+structure of the article thread.
+
+\includepdf[pages=1-4, nup=2x2, column,
+            landscape, thread]{dummy-l.pdf}
+
+\end{document}
+\endinput
+%%
+%% End of file `pdf-hyp.tex'.
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.pdf b/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.pdf
new file mode 100644
index 00000000000..fbce61ae48b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.pdf
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.tex b/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.tex
new file mode 100644
index 00000000000..ac07ed3040a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.tex
@@ -0,0 +1,56 @@
+%%
+%% This is file `pdf-toc.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% pdfpages.dtx  (with options: `example3')
+%% 
+%% This file is a demonstration of the pdfpages package.
+%% Run it through pdfLaTeX.
+%% 
+%% Please send error reports and suggestions for improvements to
+%%   Andreas MATTHIAS <amat@kabsi.at>.
+%%
+
+\documentclass[a4paper]{book}
+\usepackage{pdfpages}
+\usepackage{verbatim}
+\usepackage[plainpages=false, pdfpagelabels,
+            bookmarksopen]{hyperref}
+
+\begin{document}
+\tableofcontents
+
+\chapter{How to create a toc}
+
+The next pages were inserted using the following command:
+
+\begin{verbatim}
+\includepdf[pages=1-6,
+            pagecommand={},
+            addtotoc={1, chapter, 0, Main chapter,   cha:main,
+                      1, section, 1, First section,  sec:first,
+                      3, section, 1, Second section, sec:second},
+            trim=0 120 0 120, clip]{dummy.pdf}
+\end{verbatim}
+
+\noindent
+See Chapter \ref{cha:main} (\nameref{cha:main}) on page
+\pageref{cha:main}.\par\noindent
+See Section \ref{sec:first} (\nameref{sec:first}) on page
+\pageref{sec:first}.\par\noindent
+See Section \ref{sec:second} (\nameref{sec:second}) on page
+\pageref{sec:second}.
+
+\includepdf[pages=1-6,
+            pagecommand={},
+            addtotoc={1, chapter, 0, Main chapter,   cha:main,
+                      1, section, 1, First section,  sec:first,
+                      3, section, 1, Second section, sec:second},
+            trim=0 120 0 120, clip]{dummy.pdf}
+
+\end{document}
+\endinput
+%%
+%% End of file `pdf-toc.tex'.
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdfpages.pdf b/Master/texmf-dist/doc/latex/pdfpages/pdfpages.pdf
new file mode 100644
index 00000000000..b4e224e7976
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdfpages.pdf
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pic.tex b/Master/texmf-dist/doc/latex/pdfpages/pic.tex
new file mode 100644
index 00000000000..26a448743c5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pic.tex
@@ -0,0 +1,75 @@
+\setlength{\unitlength}{.7mm}
+\def\thick{.7pt}
+\def\thin{.2pt}
+%^^A\fbox{
+\begin{picture}(145,238)
+  \small
+\put(0,33){
+  \linethickness{\thick}
+  \put(0,0){\framebox(145,205){}}
+  \linethickness{\thin}
+  \put(10,15){\dashbox(35,49){}}
+  \put(55,15){\dashbox(35,49){}}
+  \put(100,15){\dashbox(35,49){}}
+  \put(10,78){\dashbox(35,49){}}
+  \put(55,78){\dashbox(35,49){}}
+  \put(100,78){\dashbox(35,49){}}
+  \put(10,141){\dashbox(35,49){}}
+  \put(55,141){\dashbox(35,49){}}
+  \put(100,141){\dashbox(35,49){}}
+  \put(5,7){
+    \put(10,15){\framebox(35,49){}}
+    \put(55,15){\framebox(35,49){}}
+    \put(100,15){\framebox(35,49){}}
+    \put(10,78){\framebox(35,49){}}
+    \put(55,78){\framebox(35,49){}}
+    \put(100,78){\framebox(35,49){}}
+    \put(10,141){\framebox(35,49){}}
+    \put(55,141){\framebox(35,49){}}
+    \put(100,141){\framebox(35,49){}}
+    \put(45,36){\vector(1,0){10}}
+    \put(55,36){\vector(-1,0){10}}
+    \put(44.5,38){\textit{delx}}
+    \put(90,36){\vector(1,0){10}}
+    \put(100,36){\vector(-1,0){10}}
+    \put(89.5,38){\textit{delx}}
+    \put(27,64){\vector(0,1){14}}
+    \put(27,78){\vector(0,-1){14}}
+    \put(15,70){\textit{dely}}
+    \put(27,127){\vector(0,1){14}}
+    \put(27,141){\vector(0,-1){14}}
+    \put(15,133){\textit{dely}}
+  }
+  \put(10,15){\vector(1,0){5}}
+  \put(15,15){\vector(0,1){7}}
+  \put(8,8){\textit{offx}}
+  \put(17,17){\textit{offy}}
+}
+%
+%^^A legend
+%
+\setlength{\fboxsep}{4pt}
+\put(72.5,10){
+  \makebox(0,0){
+    \fbox{
+      \begin{tabular}{l@{\hskip20pt}l}
+         \linethickness{\thick}^^A
+         \raisebox{.8ex}{\line(1,0){5}} physical sheet of paper
+       &
+         |delta=|\meta{delx} \meta{dely}
+       \\
+         \linethickness{\thin}^^A
+         \raisebox{.8ex}{\line(1,0){5}} logical pages
+       &
+         |offset=|\meta{offx} \meta{offy}
+       \\
+         \raisebox{.8ex}{\line(1,0){1}\hskip.55mm\line(1,0){1}
+           \hskip.55mm\line(1,0){1}} centered position
+       &
+       \\
+       \end{tabular}
+  }}
+}
+
+\end{picture}
+%^^A}
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/pdfpages/readme b/Master/texmf-dist/doc/latex/pdfpages/readme
new file mode 100644
index 00000000000..8645c32904c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/readme
@@ -0,0 +1,28 @@
+
+The pdfpages Package
+--------------------
+
+This package makes it easy to insert pages of external PDF
+documents. It is possible to arrange several logical
+pages on each sheet of paper. (Like `psnup'.)
+
+This package supports pdfLaTeX and VTeX but does not work
+with LaTeX.
+
+Run `latex pdfpages.ins' to produce pdfpages.sty and the
+driver files pppdftex.def and ppvtex.def. Move these files
+into a directory searched by LaTeX.
+
+Run `latex pdfpages.dtx' to produce the documentation.
+
+Run `pdflatex pdf-ex.tex', `pdflatex pdf-hyp.tex',
+and `pdflatex pdf-toc.tex' to produce some examples.
+
+
+This program may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.2
+of this license or (at your option) any later version.
+
+                                Andreas MATTHIAS
+                                amat@kabsi.at
+