doc/latex

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

11 files changed, 230 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/eso-pic/README b/Master/texmf-dist/doc/latex/eso-pic/README
new file mode 100644
index 00000000000..1d412f8f0da
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/README
@@ -0,0 +1,17 @@
+
+The `eso-pic' package
+
+This package makes it easy to add some picture commands to every page. 
+
+  eso-pic.dtx    -- the source file
+  eso-pic.ins    -- unpack `eso-pic.dtx' with `tex eso-pic.ins'
+  eso-ex1.tex, 
+  eso-ex2.tex,
+  eso-ex3.tex,
+  eso-ex4.tex, 
+  eso-ex5.tex    -- Some LaTeX examples
+  
+To produce the documentation run eso-pic.dtx through LaTeX.
+
+                          Rolf Niepraschk
+                          niepraschk@ptb.de
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex1.pdf b/Master/texmf-dist/doc/latex/eso-pic/eso-ex1.pdf
new file mode 100644
index 00000000000..4a9e4cb846b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex1.pdf
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex1.tex b/Master/texmf-dist/doc/latex/eso-pic/eso-ex1.tex
new file mode 100644
index 00000000000..8c4c78956df
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex1.tex
@@ -0,0 +1,39 @@
+
+% file `eso-ex1.tex'; a framed background example
+% Rolf Niepraschk, 2001-07-20, niepraschk@ptb.de
+
+\documentclass[a4paper]{article}
+\usepackage{eso-pic,calc}
+\listfiles
+
+\makeatletter
+\AddToShipoutPicture{%
+  \begingroup
+    \setlength{\@tempdima}{15mm}%
+    \setlength{\@tempdimb}{\paperwidth-2\@tempdima}%
+    \setlength{\@tempdimc}{\paperheight-2\@tempdima}%
+    \thicklines%
+    \put(\LenToUnit{\@tempdima},\LenToUnit{\@tempdima}){%
+      \framebox(\LenToUnit{\@tempdimb},\LenToUnit{\@tempdimc}){}}%
+  \endgroup  
+}
+\makeatother
+
+\begin{document}
+
+  \section*{First page}
+
+  This page and all the following have a frame with 15~mm
+  distance from the paper edges.\newpage
+
+  \section*{Second page} 
+  
+  \AddToShipoutPicture*{\put(100,100){\circle{40}}}
+  
+  Only this page has a circle on the lower left side. 
+  
+  \newpage
+
+  \section*{Last page}
+  
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex2.pdf b/Master/texmf-dist/doc/latex/eso-pic/eso-ex2.pdf
new file mode 100644
index 00000000000..fedaf52aff7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex2.pdf
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex2.tex b/Master/texmf-dist/doc/latex/eso-pic/eso-ex2.tex
new file mode 100644
index 00000000000..eb1966ec604
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex2.tex
@@ -0,0 +1,41 @@
+
+% file `eso-ex2.tex'; an example for background pictures
+% Rolf Niepraschk, 2002-07-27, niepraschk@ptb.de
+\listfiles
+\documentclass{article}
+
+%\usepackage{eso-pic}
+\usepackage{eso-pic}
+\usepackage{graphicx}
+\usepackage[dvips]{geometry}
+% Tells `dvips' and `pdfTeX' the papersize.
+
+% `rose.eps' from CTAN: macros/generic/boxedeps/
+\newcommand\BackgroundPicture{%
+   \put(0,0){%
+     \parbox[b][\paperheight]{\paperwidth}{%       
+       \vfill
+       \centering
+       \includegraphics[width=\paperwidth,height=\paperheight,%
+                        keepaspectratio]{rose}%
+       \vfill
+     }}}  
+% The picture is centered on the page background
+
+\AddToShipoutPicture{\BackgroundPicture}
+
+\begin{document}
+
+\section{\TeX}
+
+\newpage
+
+\ClearShipoutPicture
+\section{Empty}
+
+\newpage
+
+\AddToShipoutPicture{\BackgroundPicture}
+\section{\LaTeX}
+
+\end{document} 
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex3.pdf b/Master/texmf-dist/doc/latex/eso-pic/eso-ex3.pdf
new file mode 100644
index 00000000000..6552471a86f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex3.pdf
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex3.tex b/Master/texmf-dist/doc/latex/eso-pic/eso-ex3.tex
new file mode 100644
index 00000000000..fff4b73adc3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex3.tex
@@ -0,0 +1,41 @@
+
+% file `eso-ex3.tex'; an example for import pages of another (pdf) document.
+% Based on an article from Andreas Matthias <amat@kabsi.at> in d.c.t.t
+%
+% A much better solution is Andreas' package `pdfpages'.
+%
+% Rolf Niepraschk, 2001/07/21, niepraschk@ptb.de
+
+\documentclass[a4paper]{article}
+\usepackage[pdftex]{graphicx}%
+% `pdftex.def' >= 2000/05/12 v0.02u and `pdftex' >= v0.14 are needed.
+\usepackage{ifthen,calc,eso-pic}
+
+\newcounter{thispdfpage}\newcounter{afterlastpdfpage}
+\newcommand{\includepdfpages}[3]
+{%
+  \setcounter{thispdfpage}{#2}\setcounter{afterlastpdfpage}{#3+1}%
+  \newpage
+  \whiledo{\value{thispdfpage} < \value{afterlastpdfpage}}
+  {%
+    \AddToShipoutPicture*
+    {%
+      \put(0,0){%
+	\includegraphics[width=\paperwidth,height=\paperheight,%
+	        	 keepaspectratio,page=\arabic{thispdfpage}]{#1}}
+    }
+    \thispagestyle{empty}\mbox{}\newpage%
+    \stepcounter{thispdfpage}%
+  }
+}
+   
+\begin{document}
+
+\section{First page of the main document}
+
+% import pages 1 to 3 of an external document.
+\includepdfpages{ltx3info.pdf}{1}{3}
+
+\section{First page after the imported pages of the external document} 
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex4.pdf b/Master/texmf-dist/doc/latex/eso-pic/eso-ex4.pdf
new file mode 100644
index 00000000000..6e9ef5b2786
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex4.pdf
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex4.tex b/Master/texmf-dist/doc/latex/eso-pic/eso-ex4.tex
new file mode 100644
index 00000000000..580fd062f21
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex4.tex
@@ -0,0 +1,46 @@
+
+% file `eso-ex4.tex'; a framed text area example
+% Rolf Niepraschk, 2002-09-03, niepraschk@ptb.de
+
+\listfiles\errorcontextlines=100
+\documentclass[a4paper,twoside]{article}
+\usepackage{graphicx,color}
+\usepackage{eso-pic}
+\definecolor{lightgray}{gray}{.75}
+
+\AddToShipoutPicture{%
+  \AtTextLowerLeft{%
+    \framebox(\LenToUnit{\textwidth},\LenToUnit{\textheight}){}}}
+
+\setlength\parindent{0pt}
+
+\begin{document}
+
+  \section*{First page}
+  
+  This page and all the following have a frame around the
+  text area.
+
+  \vfill
+  X \hfill X\newpage
+
+  \section*{Second page} 
+  
+  \AddToShipoutPicture*{%
+    \AtTextCenter{%
+      \makebox(0,0)[c]{\resizebox{\textwidth}{!}{%
+        \rotatebox{45}{\textsf{\textbf{\color{lightgray}DRAFT}}}}} 
+    }
+  }
+  
+  Only this page has rotated text in the center of the text area.
+  
+  \vfill
+  X \hfill X\newpage
+
+  \section*{Last page}
+  
+  \vfill
+  X \hfill X
+  
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex5.pdf b/Master/texmf-dist/doc/latex/eso-pic/eso-ex5.pdf
new file mode 100644
index 00000000000..d72a215218b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex5.pdf
diff --git a/Master/texmf-dist/doc/latex/eso-pic/eso-ex5.tex b/Master/texmf-dist/doc/latex/eso-pic/eso-ex5.tex
new file mode 100644
index 00000000000..33b31c2a9e5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eso-pic/eso-ex5.tex
@@ -0,0 +1,46 @@
+
+% file `eso-ex5.tex'; background grid example 
+% Rolf Niepraschk, 2002-11-16, niepraschk@ptb.de
+
+\listfiles
+\documentclass[a4paper,twoside]{article}
+% a4paper =       210mm x 297mm   = 596bp x 842bp = 8.27in x 11.69in
+% letterpaper = 215.9mm x 279.4mm = 612bp x 792bp =  8.5in x 11in 
+
+%\usepackage[a3,center]{crop} 
+
+\usepackage[dvips]{geometry}
+% `dvips', `pdfTeX' and `VTeX' should know the papersize.
+
+\usepackage[colorgrid,gridunit=mm]{eso-pic}
+%\usepackage[colorgrid,gridunit=in,subgridcolor=blue,texcoord]{eso-pic}
+%\usepackage[grid,gridunit=bp,subgridstyle=dotted]{eso-pic}
+
+\newcommand{\cmd}[1]{\texttt{\symbol{`\\}#1}}
+
+\AddToShipoutPicture{%
+  \thicklines\normalfont\ttfamily\Large%
+  \color{blue}\setlength\unitlength{1mm}%
+  \AtTextCenter{\circle*{6}%
+    \put(-2,0){\makebox(0,0)[lb]{\cmd{AtTextCenter}}}}%
+  \AtTextUpperLeft{\circle*{6}%
+    \put(-2,5){\makebox(0,0)[lt]{\cmd{AtTextUpperLeft}}}}%
+  \AtTextLowerLeft{\circle*{6}%
+    \put(-2,-5){\makebox(0,0)[lb]{\cmd{AtTextLowerLeft}}}}%
+  \color{red}%
+  \AtPageCenter{\circle*{6}%
+    \put(-2,0){\makebox(0,0)[lt]{\cmd{AtPageCenter}}}}%
+  \AtPageUpperLeft{\circle*{6}%
+    \put(-2,-5){\makebox(0,0)[lb]{\cmd{AtPageUpperLeft}}}}%
+  \AtPageLowerLeft{\circle*{6}%
+    \put(-2,5){\makebox(0,0)[lt]{\cmd{AtPageLowerLeft}}}}%  
+}
+
+\setlength\parindent{0pt}
+
+\begin{document}  \Huge \bfseries
+
+\hrulefill First Page\hrulefill \vfill X \hfill X \newpage 
+\hrulefill  Second Page\hrulefill \vfill X \hfill X
+
+\end{document}