pst-ovl (28dec)

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

12 files changed, 417 insertions, 1 deletions

diff --git a/Master/texmf-dist/doc/generic/pst-ovl/Changes b/Master/texmf-dist/doc/generic/pst-ovl/Changes
new file mode 100644
index 00000000000..9edb4c6092b
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-ovl/Changes
@@ -0,0 +1,9 @@
+pst-ovl.tex ----------- (hv)
+
+ v 0.04  2013-12-28  forgot Timothy as author
+ v 0.03  2013-12-24  create own package with documentation
+ v 0.02  2013-11-28  move functions into tx@Dict dictionary
+
+
+pst-ovl.pro ----------- (hv)
+ v 0.03  2013-12-24  first official version
diff --git a/Master/texmf-dist/doc/generic/pst-ovl/README b/Master/texmf-dist/doc/generic/pst-ovl/README
new file mode 100644
index 00000000000..04a3dd63f1f
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-ovl/README
@@ -0,0 +1,12 @@
+Save the files pst-ovl.sty|.tex| in a directory, which is part of your 
+local TeX ovl. Then do not forget to run texhash to update this ovl
+if these packages are new to your TeX distribution.
+For more information  see the documentation of your LaTeX distribution 
+on installing packages into your LaTeX distribution or the 
+TeX Frequently Asked Questions:
+(http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages).
+
+pst-ovl needs pstricks, which should be part of your
+local TeX installation, otherwise get it from a CTAN server, f.ex.
+http://mirror.ctan.org/graphics/pstricks/
+
diff --git a/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.bib b/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.bib
new file mode 100644
index 00000000000..96838e3a2db
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.bib
@@ -0,0 +1,166 @@
+@STRING{tugboat	= {TUGboat} }
+@STRING{beiprogramm	= {{\TeX}-Beiprogramm} }
+@STRING{bretter	= {Bretter, die die Welt bedeuten} }
+@STRING{dtk		= {{D}ie {\TeX}nische {K}om{\"o}die} }
+@STRING{editorial	= {Editorial} }
+@STRING{fremdebuehne	= {Von fremden B{\"u}hnen} }
+@STRING{fundus		= {Aus dem Fundus} }
+@STRING{hinterbuehne	= {Hinter der B{\"u}hne} }
+@STRING{leserbrief	= {Leserbrief(e)} }
+@STRING{magazin	= {Magazin} }
+@STRING{rezension	= {Rezensionen} }
+@STRING{schonimmer	= {Was Sie schon immer {\"u}ber {\TeX} wissen wollten \dots} }
+@STRING{theaterkasse	= {Von der Theaterkasse} }
+@STRING{theatertage	= {{\TeX}-Theatertage} }
+
+@Article{	  dtk02.2:jackson.voss:plot-funktionen,
+  author	= {Laura E. Jackson and Herbert Vo{\ss}},
+  title		= {Die {P}lot-{F}unktionen von {\texttt{pst-plot}}},
+  journal	= dtk,
+  year		= 2002,
+  volume	= {2/02},
+  altvolume	= 2,
+  altnumber	= 14,
+  month		= jun,
+  pages		= {27--34},
+  annote	= bretter,
+  keywords	= {},
+  abstract	= { Im letzten Heft wurden die mathematischen Funktionen von
+		  \PS~im Zusammenhang mit dem {\LaTeX}-Paket
+		  \texttt{pst-plot} zum Zeichnen von Funktionen beschrieben
+		  und durch Beispiele erl{\"a}utert. In diesem Teil werden
+		  die bislang nur erw{\"a}hnten Plot-Funktionen f{\"u}r
+		  externe Daten behandelt. }
+}
+
+@Article{	  dtk02.1:voss:mathematischen,
+  author	= {Herbert Vo{\ss}},
+  title		= {Die mathematischen {F}unktionen von {P}ost{S}cript},
+  journal	= dtk,
+  year		= 2002,
+  volume	= {1/02},
+  altvolume	= 1,
+  altnumber	= 14,
+  month		= mar,
+  pages		= {},
+  annote	= bretter,
+  keywords	= {},
+  abstract	= { \PS, faktisch genauso alt wie {\TeX}, ist im
+		  Verh{\"a}ltnis dazu allgemein noch weniger bekannt, wenn es
+		  darum geht zu beurteilen, was es denn nun im eigentlichen
+		  Sinne ist. Au{\ss}erdem wird h{\"a}ufig vergessen, dass
+		  sich mit den \PS-Funktionen viele Dinge erledigen lassen,
+		  bei denen sonst auf externe Programme zur{\"u}ckgegriffen
+		  wird. Dies wird im Folgenden f{\"u}r die mathematischen
+		  Funktionen im Zusammenhang mit dem Paket \texttt{pst-plot}
+		  gezeigt. }
+}
+
+@Book{tlgc2,
+  author	= {Michel Goosens and Frank Mittelbach and Sebastian Rahtz and Denis Roegel and Herbert Vo{\ss}},
+  title		= {The {\LaTeX} {G}raphics {C}ompanion},
+  publisher	= {{Addison-Wesley Publishing Company}},
+  edition	= second,
+  year		= {2007},
+  address	= {Reading, Mass.}
+}
+
+
+@Book{voss:chaos,
+  author	= {Herbert Vo{\ss}},
+  title		= {Chaos und {F}raktale selbst programmieren: von {M}andelbrotmengen 
+    {\"u}ber {F}arbmanipulationen zur perfekten Darstellung},
+  publisher	= {{Franzis Verlag}},
+  year		= {1994},
+  address	= {Poing}
+}
+
+@Article{girou:01:,
+  author	= {Denis Girou},
+  title		= {Pr\'esentation de {PST}ricks},
+  journal	= {Cahier {GUT}enberg},
+  year		= 1994,
+  volume	= {16},
+  month		= apr,
+  pages		= {21-70}
+}
+
+@Article{girou:02:,
+  author	= {{Timothy van} Zandt and Denis Girou},
+  title		= {Inside {PST}ricks},
+  journal	= TUGboat,
+  year		= 1994,
+  volume	= {15},
+  month		= sep,
+  pages		= {239-246}
+}
+
+@Book{PostScript,
+  Author         = {Kollock, Nikolai G.},
+  Title          = {Post{S}cript richtig eingesetzt: vom {K}onzept zum
+                   praktischen {E}insatz},
+  Publisher      = {IWT},
+  Address        = {Vaterstetten},
+  year           = 1989,
+}
+
+@Manual{pstricks,
+  Title          = {PSTricks - {\PS} macros for generic {\TeX}},
+  Author         = {{Timothy van} Zandt},
+  Organization   = {},
+  Address        = {\url{http://www.tug.org/application/PSTricks}},
+  Note           = {},
+  year           = 1993
+}
+
+@Manual{pst-plot,
+  Title          = {\texttt{pst-plot}: Plotting two dimensional functions and data},
+  Author         = {{Timothy van} Zandt},
+  Organization   = {},
+  Address        = {\url{CTAN:graphics/pstricks/generic/pst-plot.tex}},
+  Note           = {},
+  year           = 1999
+}
+
+@Manual{multido,
+  Title          = {\texttt{multido.tex} - a loop macro, that supports fixed-point addition},
+  Author         = {{Timothy van} Zandt},
+  Organization   = {},
+  Address        = {\url{CTAN:/graphics/pstricks/generic/multido.tex}},
+  Note           = {},
+  year           = 1997
+}
+
+@Book{PSTricks2,
+  author	= {Herbert Vo\ss},
+  title		= {\texttt{PSTricks} -- {G}rafik f\"ur \TeX{} und \LaTeX},
+  edition	= {6.},
+  publisher	= {DANTE -- Lehmanns},
+  year		= {2010},
+  address	= {Heidelberg/Berlin}
+}
+
+@Book{voss:math,
+  author	= {Herbert Vo\ss},
+  title		= {Typesetting mathematics with \LaTeX},
+  publisher	= {UIT},
+  year		= {2010},
+  address	= {Cambridge}
+}
+
+@Book{PSTricks2-UIT,
+  author	= {Herbert Vo\ss},
+  title		= {PSTricks -- Graphics for \TeX\ and \LaTeX},
+  publisher	= {UIT},
+  year		= {2011},
+  address	= {Cambridge}
+}
+
+@Manual{wolfram,
+  author	= {Eric Weisstein},
+  title		= {Wolfram MathWorld},
+  publisher	= {{Wolfram}},
+  year		= {2007},
+  address	= {\url{http://mathworld.wolfram.com}}
+}
+
diff --git a/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.pdf b/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.pdf
new file mode 100644
index 00000000000..59d9f483939
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.pdf
diff --git a/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.tex b/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.tex
new file mode 100644
index 00000000000..c1b4e709a96
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-ovl/pst-ovl-doc.tex
@@ -0,0 +1,96 @@
+%% $Id: pst-func-doc.tex 599 2011-11-03 19:38:28Z herbert $
+\documentclass[11pt,english,BCOR10mm,DIV12,bibliography=totoc,parskip=false,
+   smallheadings, headexclude,footexclude,oneside]{pst-doc}
+\usepackage[utf8]{inputenc}
+\usepackage{pst-ovl}
+\let\pstOVLFV\fileversion
+\renewcommand\bgImage{}
+
+\lstset{language=PSTricks,
+    morekeywords={psPrintValue},basicstyle=\footnotesize\ttfamily}
+%
+\begin{document}
+
+\title{\texttt{pst-ovl}}
+\subtitle{Helper functions for overlays; v.\pstOVLFV}
+\author{Herbert Vo\ss}
+\docauthor{}
+\date{\today}
+\maketitle
+
+\tableofcontents
+\psset{unit=1cm}
+
+\section{Overlays}
+
+Overlays are mainly of interest for making slides, and the overlay macros
+described in this section are mainly of interest to \TeX{} macro writers who
+want to implement overlays in a slide macro package.  For example, the
+\LPack{seminar} package, a \LaTeX{} style for notes and slides, uses PSTricks to
+implement overlays.
+
+Overlays are made by creating an "`\Lcs{hbox}"' and then outputting the box several
+times, printing different material in the box each time. The box is created by
+the commands
+\begin{lstlisting}
+  \Lcs{overlaybox} < stuff >\Lcs{endoverlaybox}
+\end{lstlisting}
+\LaTeX{} users can instead write:
+\begin{lstlisting}
+  \begin{overlaybox} <stuff> \end{overlaybox}
+\end{lstlisting}
+
+The material for overlay <string> should go within the scope of the command
+
+  \Lcs{psoverlay}\Largb{string}
+
+<string> can be any string, after expansion. Anything not in the scope of any
+\Lcs{psoverlay} command goes on overlay "`main"', and material within the scope of
+\Lcs{psoverlay}\Largb{all} goes on all the overlays. \Lcs{psoverlay}
+commands can be nested and can be used in math mode.
+
+The command
+
+\Lcs{putoverlaybox}\Largb{string}
+
+then prints overlay <string>.
+
+Here is an example:
+
+\begin{LTXexample}[pos=t]
+\overlaybox
+\psoverlay{all}
+\psframebox[framearc=.15,linewidth=1.5pt]{%
+  \psoverlay{main}
+  \parbox{3.5cm}{\raggedright
+    Foam Cups Damage Environment {\psoverlay{one} Less than
+    Paper Cups,} Study Says.}}
+ \endoverlaybox
+
+\putoverlaybox{main} \hspace{.5in} \putoverlaybox{one}
+\end{LTXexample}
+
+
+
+\clearpage
+\section{List of all optional arguments for \texttt{pst-ovl}}
+
+\xkvview{family=pst-ovl,columns={key,type,default}}
+
+
+
+
+\bgroup
+\raggedright
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{pst-ovl-doc}
+\egroup
+
+\printindex
+
+
+
+\end{document}
+
+
diff --git a/Master/texmf-dist/dvips/pst-ovl/pst-ovl.pro b/Master/texmf-dist/dvips/pst-ovl/pst-ovl.pro
new file mode 100644
index 00000000000..2e4ce76ce1c
--- /dev/null
+++ b/Master/texmf-dist/dvips/pst-ovl/pst-ovl.pro
@@ -0,0 +1,30 @@
+% $Id: pst-ovl.pro 859 2013-12-21 16:51:58Z herbert $
+%
+%% PostScript prologue for pst-ovl.tex.
+%% Version 0.03, 2013/12/21
+%%
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License Distributed from CTAN archives
+%% in directory macros/latex/base/lppl.txt.
+%
+%
+/tx@ovlDict 10 dict def 
+tx@ovlDict begin
+%
+/BeginOL { 
+  dup (all) eq exch TheOL eq or 
+    { IfVisible not { Visible /IfVisible true def } if } 
+    { IfVisible { Invisible /IfVisible false def } if } ifelse 
+} def
+%
+/InitOL { 
+  /OLUnit [ 3000 3000 matrix defaultmatrix dtransform ] cvx def
+  /Visible { CP OLUnit idtransform T moveto } def 
+  /Invisible { CP OLUnit neg exch neg exch idtransform T moveto } def 
+  /BOL { BeginOL } def
+  /IfVisible true def 
+} def
+%
+end
+%
+% END pst-ovl.pro
diff --git a/Master/texmf-dist/tex/generic/pst-ovl/pst-ovl.tex b/Master/texmf-dist/tex/generic/pst-ovl/pst-ovl.tex
new file mode 100644
index 00000000000..008009f2847
--- /dev/null
+++ b/Master/texmf-dist/tex/generic/pst-ovl/pst-ovl.tex
@@ -0,0 +1,82 @@
+%% $Id: pst-ovl.tex 859 2013-12-21 16:51:58Z herbert $
+%%
+%%
+%% This is file `pst-ovl.tex',
+%%
+%% IMPORTANT NOTICE:
+%%
+%% Package `pst-ovl.tex'
+%% 
+%% 2014 --  Timothy Van Zandt
+%%          Herbert Voss <hvoss@tug.org>
+%%
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License Distributed from CTAN archives
+%% in directory macros/latex/base/lppl.txt.
+%%
+%% DESCRIPTION:
+%%   `pst-ovl' is a PSTricks related package for  
+%%    overlay support
+%%
+\csname PSTovlloaded\endcsname
+\let\PSTovlloaded\endinput
+%
+% Requires main PSTricks
+\ifx\PSTricksLoaded\endinput\else\input pstricks \fi
+%
+\def\fileversion{0.04}
+\def\filedate{2013/12/28}
+\message{`pst-ovl' v\fileversion, \filedate\space (tvz,hv)}
+%
+\edef\PstAtCode{\the\catcode`\@} \catcode`\@=11\relax
+%
+\pstheader{pst-ovl.pro}
+%
+\def\tx@BeginOL{ tx@ovlDict begin BeginOL }
+\def\tx@InitOL{ tx@ovlDict begin InitOL }
+\def\tx@BOL{ tx@ovlDict begin BOL end }
+%
+\def\pst@initoverlay#1{\pst@Verb{ \tx@InitOL /TheOL (#1) def end }}
+\def\AltOverlayMode{%
+  \def\pst@initoverlay##1{%
+    \pst@Verb{
+      \tx@InitOL
+      /Visible { initclip } def
+      /Invisible {
+        CP newpath OLUnit itransform moveto clip newpath moveto
+      } def
+      /TheOL (##1) def end }}}
+%
+\def\pst@overlay#1{%
+  \edef\curr@overlay{#1}%
+  \pst@Verb{ tx@ovlDict begin (#1) BOL end }%
+  \aftergroup\pst@endoverlay}
+%
+\def\pst@endoverlay{\pst@Verb{ tx@ovlDict begin (\curr@overlay) BOL end }}
+\def\curr@overlay{all}
+%
+\newbox\theoverlaybox
+%
+\def\overlaybox{%
+  \global\setbox\theoverlaybox=\hbox\bgroup
+  \begingroup
+  \let\psoverlay\pst@overlay
+  \def\overlaybox{%
+    \@pstrickserr{Overlays cannot be nested}\@eha}%
+  \def\putoverlaybox{%
+    \@pstrickserr{You must end the overlay box
+         before using \string\putoverlaybox}}%
+  \psoverlay{main}%
+  \ignorespaces}
+%
+\def\endoverlaybox{\endgroup\egroup}
+\def\putoverlaybox#1{%
+  \hbox{\pst@initoverlay{#1}\copy\theoverlaybox}}
+%
+\def\psoverlay{\@pstrickserr{\string\psoverlay\space
+  can only be used after \string\overlaybox}}
+%
+\catcode`\@=\PstAtCode\relax
+%
+%% END: pst-ovl.tex
+\endinput
diff --git a/Master/texmf-dist/tex/latex/pst-ovl/pst-ovl.sty b/Master/texmf-dist/tex/latex/pst-ovl/pst-ovl.sty
new file mode 100644
index 00000000000..84ca3cd63e3
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/pst-ovl/pst-ovl.sty
@@ -0,0 +1,18 @@
+%% $Id: pst-ovl.sty 859 2013-12-21 16:51:58Z herbert $
+%% 
+%% pst-ovl.sty Copyright (C) 2013 Herbert Voss <hvoss@tug.org>
+%%
+\NeedsTeXFormat{LaTeX2e}
+
+\ProvidesPackage{pst-ovl}
+          [2013/07/08 v0.01 LaTeX wrapper for `pst-ovl' (HV)]
+\input{pst-ovl}
+\ProvidesFile{pst-ovl.tex}
+          [2013/07/08 v0.01 overlay macros `pst-ovl' (HV)]
+\IfFileExists{pst-ovl.pro}{%
+      \ProvidesFile{pst-ovl.pro}%
+        [2013/12/21,  PostScript prologue file (hv)]
+        \@addtofilelist{pst-ovl.pro}}{}%
+
+\endinput
+%%
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index 2c91a78bcb6..d49aba54838 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -382,7 +382,8 @@ my @TLP_working = qw(
     pst-infixplot pst-jtree pst-knot pst-labo pst-layout
     pst-lens pst-light3d pst-magneticfield pst-math pst-mirror pst-node
     pst-ob3d pst-ode pst-optexp pst-optic
-    pst-osci pst-pad pst-pdgr pst-platon pst-plot pst-poly pst-pdf pst-pulley
+    pst-osci pst-ovl
+    pst-pad pst-pdgr pst-platon pst-plot pst-poly pst-pdf pst-pulley
     pst-qtree pst-rubans
     pst-sigsys pst-slpe pst-solarsystem pst-solides3d pst-soroban pst-spectra
     pst-stru pst-support pst-text pst-thick pst-tools pst-tree pst-tvz pst-uml
diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds
index 719a470dd1c..574a7d2ba0d 100755
--- a/Master/tlpkg/libexec/ctan2tds
+++ b/Master/tlpkg/libexec/ctan2tds
@@ -835,6 +835,7 @@ chomp ($Build = `cd $Master/../Build/source && pwd`);
  'pst-ob3d',	"&MAKEpst",
  'pst-optic',	"&MAKEpst",
  'pst-osci',	"&MAKEpst",
+ 'pst-ovl',	"&MAKEpst",
  'pst-pad',	"&MAKEpst",
  'pst-pdgr',	"&MAKEpst",
  'pst-platon',	"&MAKEpst",
diff --git a/Master/tlpkg/tlpsrc/collection-pstricks.tlpsrc b/Master/tlpkg/tlpsrc/collection-pstricks.tlpsrc
index 6ac00edaabc..7a46ae4c2e1 100644
--- a/Master/tlpkg/tlpsrc/collection-pstricks.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-pstricks.tlpsrc
@@ -61,6 +61,7 @@ depend pst-ode
 depend pst-optexp
 depend pst-optic
 depend pst-osci
+depend pst-ovl
 depend pst-pad
 depend pst-pdgr
 depend pst-platon
diff --git a/Master/tlpkg/tlpsrc/pst-ovl.tlpsrc b/Master/tlpkg/tlpsrc/pst-ovl.tlpsrc
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/pst-ovl.tlpsrc