pst-exa (14sep17)

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

6 files changed, 497 insertions, 127 deletions

diff --git a/Master/texmf-dist/doc/latex/pst-exa/Changes b/Master/texmf-dist/doc/latex/pst-exa/Changes
index 9a245d60f59..122b5144a55 100644
--- a/Master/texmf-dist/doc/latex/pst-exa/Changes
+++ b/Master/texmf-dist/doc/latex/pst-exa/Changes
@@ -1,2 +1,3 @@
+0.06  2017-09-12  code modifications (pablo)
 0.05  2014-09-24  added style options (pablo)
 0.01  2010-01-01  first CTAN version
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/pst-exa/README b/Master/texmf-dist/doc/latex/pst-exa/README
index 49344318b9a..111a713cbf3 100644
--- a/Master/texmf-dist/doc/latex/pst-exa/README
+++ b/Master/texmf-dist/doc/latex/pst-exa/README
@@ -1,6 +1,6 @@
 The package \LPack{pst-exa} was created to realize examples with printed code and output
 side by side or on top of each other. The package looks in the image directory for the source
-code of the examples and inserts only the code between the environment \Lenv{document},
+code of the examples and inserts only the code between the document environment ,
 which is the sequence \LBEG{document} \ldots\ \LEND{document}.
 
 The package provides the environment \Lenv{PSTexample} with the optional
diff --git a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib
index 473fe07ab53..462241d6df6 100644
--- a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib
+++ b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib
@@ -13,49 +13,6 @@
 @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},
@@ -66,15 +23,6 @@
 }
 
 
-@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},
@@ -95,59 +43,22 @@
   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.},
+  edition	= {7},
   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},
@@ -164,14 +75,6 @@
   address	= {Cambridge}
 }
 
-@Manual{wolfram,
-  author	= {Eric Weisstein},
-  title		= {Wolfram MathWorld},
-  publisher	= {{Wolfram}},
-  year		= {2007},
-  address	= {\url{http://mathworld.wolfram.com}}
-}
-
 @Manual{pst-tools,
   author	= {Herbert Voß},
   title		= {\texttt{pst-tools} -- Helper functions},
diff --git a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc
new file mode 100644
index 00000000000..2e09c78722d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc
@@ -0,0 +1,165 @@
+\DeclareRobustCommand\PST{\texttt{PSTricks\xspace}}
+\DeclareRobustCommand\PS{\texttt{PostScript\xspace}}
+\def\dt{\ensuremath{\,\mathrm{d}t}}
+\def\Index#1{\index{#1}#1}
+%
+\def\LPack#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Package!#1@\texttt{#1}}}
+\def\nxLPack#1{\texttt{#1}}
+\def\Lprog#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Program!#1@\texttt{#1}}}
+\let\nxLprog\nxLPack
+\def\LFile#1{\texttt{#1}\index{#1@\texttt{#1}}\index{File!#1@\texttt{#1}}}
+\def\nxLFile#1{\texttt{#1}}
+\def\Lext#1{\texttt{.#1}\index{#1@\texttt{.#1}}\index{Extension!#1@\texttt{.#1}}}
+\def\nxLext#1{\texttt{.#1}}
+\def\xLcs#1{\index{#1@\nxLcs{#1}}\index{Macro!#1@\nxLcs{#1}}}
+\def\Lcs#1{\nxLcs{#1}\xLcs{#1}}
+\def\LcsStar#1{\index{#1*@\nxLcs{#1*}}\index{Macro!#1@\nxLcs{#1*}}\nxLcs{#1}\OptArg*{*}}
+\def\nxLcs#1{\texttt{\textbackslash#1}}
+\def\xLenv#1{\index{#1@\texttt{#1}}\index{Environment!#1@\texttt{#1}}}
+\def\Lenv#1{\texttt{#1}\xLenv{#1}}
+\def\Ldim#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1}}\index{Dimension!#1@\texttt{\textbackslash#1}}}
+\def\Lskip#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1}}\index{Skip!#1@\texttt{\textbackslash#1}}}
+\def\Lkeyword#1{\texttt{#1}\xLkeyword{#1}}
+\def\xLkeyword#1{\index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}}
+\def\nxLkeyword#1{\texttt{#1}}
+
+\def\LKeyword#1{\LKeyword@i#1!!}
+\def\LKeyword@i#1=#2!!{\Lkeyword{#1}\nxLkeyword{=#2}}
+\let\nxLKeyword\nxLenv % same formatting
+
+\let\nxLkeyval\nxLkeyword
+\let\nxLenv\nxLkeyword
+\let\nxLps\nxLkeyword
+\def\LColor#1{\texttt{#1}\xLColor{#1}}
+\def\xLColor#1{\index{#1@\texttt{#1}}\index{Color!#1@\texttt{#1}}}
+\def\Lkeyval#1{\texttt{#1}\xLkeyval{#1}}
+\def\xLkeyval#1{\index{#1@\texttt{#1}}\index{Keyvalue!#1@\texttt{#1}}}
+\def\xLoption#1{\index{#1@\texttt{#1}}\index{Package option!#1@\texttt{#1}}}
+\def\Loption#1{\texttt{#1}\xLoption{#1}}
+\def\LPS#1{\texttt{#1}\index{#1@\texttt{#1}}\index{PostScript!#1@\texttt{#1}}}
+\def\xLps#1{\index{#1@\texttt{#1}}\index{PostScript!#1@\texttt{#1}}}
+\def\nxLps#1{\texttt{#1}}
+\def\Lps#1{\nxLps{#1}\xLps{#1}}
+\def\LClass#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Class!#1@\texttt{#1}}}
+\let\nxLClass\nxLPack
+\let\nxLdim\nxLcs
+\let\nxLskip\nxLcs
+\def\Lctr#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Counter!#1@\texttt{#1}}}
+\def\LCtr#1{\texttt{#1}\index{#1@\texttt{#1}}\index{TeX Counter@\TeX\ Counter!#1@\texttt{#1}}}
+\def\nxLctr#1{\texttt{#1}}
+%
+\newcommand\Lnotation [1]{\nxLnotation{#1}\xLnotation{#1}}
+\newcommand\Lmnotation[1]{\nxLnotation{#1}\xLmnotation{#1}}
+\newcommand\xLnotation[1]{\index{Syntax!#1@\nxLnotation{#1}}\index{#1@\nxLnotation{#1}}}
+\def\nxLnotation#1{\texttt{#1}}
+\def\xLkeyset#1{\expandafter\xLkeyset@i#1\@nil}
+\def\xLkeyset@i#1=#2\@nil{\index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}
+  \index{#2@\texttt{#2}}\index{Value!#2@\texttt{#2}}}
+\def\Lkeyset#1{\expandafter\Lkeyset@i#1\@nil}
+\def\Lkeyset@i#1=#2\@nil{\texttt{#1=#2}%
+  \index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}
+  \index{#2@\texttt{#2}}\index{Value!#2@\texttt{#2}}}
+%
+\def\xLKeyset#1{\expandafter\xLKeyset@i#1\@nil}% without using the right value of =
+\def\xLKeyset@i#1=#2\@nil{\index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}}
+\def\LKeyset#1{\expandafter\LKeyset@i#1\@nil}
+\def\LKeyset@i#1=#2\@nil{\texttt{#1=#2}%
+  \index{#1@\texttt{#1}}\index{Keyword!#1@\texttt{#1}}}
+\let\LKeyword\LKeyset
+%
+\newcommand\Larg [1]{{\normalfont\itshape#1\/}}
+\newcommand\Larga[1]{$\langle$\Larg{#1}$\rangle$}% angles
+\newcommand\Largb[1]{\lcb\Larg{#1}\rcb}          % curly brace
+\newcommand\Largs[1]{\lsb\Larg{#1}\rsb}          % square brackets
+\newcommand\Largr[1]{\lrb\Larg{#1}\rrb}          % round brackets
+\newcommand\LBEG[1]{{\normalfont\ttfamily\bs{}begin\lcb#1\rcb}\xLenv{#1}}
+\newcommand\LmBEG[1]{{\normalfont\ttfamily\bs{}begin\lcb#1\rcb}\xLmenv{#1}}
+\newcommand\LEND[1]{{\normalfont\ttfamily\bs{}end\lcb#1\rcb}\xLenv{#1}}
+\newcommand\LmEND[1]{{\normalfont\ttfamily\bs{}end\lcb#1\rcb}\xLmenv{#1}}
+%
+\DeclareRobustCommand\bs{{\normalfont\ttfamily\textbackslash}}  % \let\bslash=\bs
+\DeclareRobustCommand\lcb{{\normalfont\ttfamily\textbraceleft}}
+\DeclareRobustCommand\rcb{{\normalfont\ttfamily\textbraceright}}
+\DeclareRobustCommand\lsb{{\normalfont\ttfamily[}}
+\DeclareRobustCommand\rsb{{\normalfont\ttfamily]}}
+\DeclareRobustCommand\lrb{{\normalfont\ttfamily(}}
+\DeclareRobustCommand\rrb{{\normalfont\ttfamily)}}
+\DeclareRobustCommand\false{{\ttfamily false}}
+\DeclareRobustCommand\true{{\ttfamily true}}
+
+%
+% without brackets
+\def\Coordx#1{$x_{#1}$}
+\def\Coordy#1{$y_{#1}$}
+\def\Coordz#1{$z_{#1}$}
+\def\Coord#1{\Coordx{#1},\kern 1pt\Coordy{#1}}
+\def\Coordn{\Coordx{n},\kern 1pt\Coordy{n}}
+\def\CoordIII#1{\Coordx{#1},\kern 1pt\Coordy{#1},\kern 1pt\Coordz{#1}}% HjG
+\def\CAny{\Coordx{},\kern 1pt\Coordy{}}
+\def\CIIIAny{\Coordx{},\kern 1pt\Coordy{},\kern 1pt\Coordz{}}%  hv
+% with brackets
+\def\coord#1{(\Coordx{#1},\kern 1pt\Coordy{#1})}
+\def\coordn{(\Coordx{n},\kern 1pt\Coordy{n})}
+\def\coordiii#1{(\Coordx{#1},\kern 1pt\Coordy{#1},\kern 1pt\Coordz{#1})}% hv
+\def\coordx#1{($x_{#1}$)}
+\def\coordy#1{($y_{#1}$)}
+\def\coordz#1{($z_{#1}$)}
+\def\cAny{(\Coordx{},\kern 1pt\Coordy{})}
+\def\ciiiAny{(\Coordx{},\kern 1pt\Coordy{},\kern 1pt\Coordz{})}% hv
+%
+\newskip\BDefaboveskip
+\newskip\BDefbelowskip
+\newskip\BDefinlineskip
+\setlength\BDefaboveskip{0pt plus 2pt}% first-level list topsep
+\setlength\BDefbelowskip{10pt}
+\setlength\BDefinlineskip{6pt}
+%
+\makeatletter
+\newsavebox{\boxdef}
+\newenvironment{BDef}
+  {\begin{lrbox}\boxdef
+      \def\arraystretch{1.0}
+      \begin{tabular}{@{}l@{}l@{}l@{}}}
+  {\end{tabular}\end{lrbox}
+%
+% braces around next block are needed to stop the list env checking for blank lines
+% and the \aftergroups then for making sure no indentation happens ... as i said
+% urg
+%
+   {\BCmd\fbox{\usebox\boxdef}\endBCmd}
+   \aftergroup\@afterindentfalse\aftergroup\@afterheading
+  }
+\newenvironment{BDef*}
+  {\begin{lrbox}\boxdef
+      \def\arraystretch{1.0}
+      \begin{tabular}{@{}l@{}l@{}l@{}}
+  }
+  {\end{tabular}\end{lrbox}
+   {\begin{BCmd*}\fbox{\usebox\boxdef}\end{BCmd*}}
+   \aftergroup\@afterindentfalse\aftergroup\@afterheading
+  }
+\newenvironment{BCmd}{
+  \@beginparpenalty-\@lowpenalty
+  \topsep\BDefaboveskip
+  \fboxsep3pt
+  \flushleft}
+ {\@endparpenalty\@M
+  \@topsepadd\BDefbelowskip
+  \endflushleft}
+
+\newenvironment{BCmd*}{
+  \@beginparpenalty\@M
+  \topsep\BDefinlineskip
+  \fboxsep3pt
+  \flushleft}
+ {\@endparpenalty5000
+  \endflushleft}
+
+
+\def\OptArgs{\colorbox{black!20}{\texttt{[Options]}}\kern1pt}
+\def\OptArg{\@ifnextchar*\OptArg@i{\OptArg@ii*}}% star version without braces
+\def\OptArg@i*#1{\colorbox{black!20}{\texttt{#1}}\kern1pt}
+\def\OptArg@ii*#1{\colorbox{black!20}{\texttt{[#1]}}\kern1pt}
+\def\DBS{{\ttfamily\textbackslash\textbackslash}}
+
+\makeatother
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf
index 1faf862603c..3344972804c 100644
--- a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf
+++ b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex
index 235b3485073..f7f3bc89ceb 100644
--- a/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex
+++ b/Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex
@@ -1,42 +1,343 @@
-\documentclass[pagesize=auto, fontsize=14pt, DIV=9, parskip=half]{scrartcl}
-\usepackage{fixltx2e}
-\usepackage{etex}
-\usepackage{lmodern}
-\usepackage[T1]{fontenc}
-\usepackage{textcomp}
+% arara: latex: {draft: yes}
+% arara: latex
+% arara: biber
+% arara: makeindex
+% arara: latex: {draft: yes}
+% arara: latex
+% arara: dvips
+% arara: ps2pdf
+% arara: clean: { files:[pst-exa-doc.out, pst-exa-doc.ps, pst-exa-doc.toc,pst-exa-doc.log,pst-exa-doc.ind,pst-exa-doc.aux, pst-exa-doc.bbl, pst-exa-doc.bcf, pst-exa-doc.blg,pst-exa-doc.dvi,pst-exa-doc.idx,pst-exa-doc.ilg,pst-exa-doc.run.xml] }
+\documentclass[11pt,english,BCOR=10mm,DIV=12,bibliography=totoc,parskip=false,headings=small,
+    headinclude=false,footinclude=false,twoside]{scrartcl}
 \usepackage[utf8]{inputenc}
-\usepackage{microtype}
-\usepackage{hyperref}
+\usepackage[T1]{fontenc}
+\usepackage{libertine}
+\usepackage[scaled=0.88]{beramono}
+\usepackage{babel}
+\usepackage{makeidx}\makeindex
+\input{\jobname.inc}
+\listfiles
+\let\Lfile\LFile
+\usepackage{pst-node}
+\usepackage{biblatex}
 
-\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{#1}}}
-\newcommand*{\pkg}[1]{\textsf{#1}}
-\newcommand*{\env}[1]{\texttt{#1}}
-\def\PS{PostScript}
-\addtokomafont{title}{\rmfamily}
+\addbibresource{\jobname.bib}
 
-\title{The \pkg{pst-exa} package\thanks{This manual corresponds to \pkg{pst-exa.sty}~v0.05, dated~2014/09/24.}}
-\author{Herbert Voß\thanks{\mail{hvoss@tug.org}}}
-\date{\today}
+\usepackage{xspace,showexpl}
+\usepackage{pst-text,pst-grad}
+\usepackage[tcb]{pst-exa}
+\let\pstFV\fileversion
 
+%\DeclareFixedFont{\RM}{T1}{ptm}{b}{n}{4cm}
+%\renewcommand\bgImage{\pscharpath[fillstyle=gradient,
+%  gradbegin=red,gradend=blue,gradangle=-90]{\RM pst-exa}}
 
+\lstset{language=PSTricks,basicstyle=\footnotesize\ttfamily}
+\def\DVI{\textsc{DVI}}
+\def\PDF{\textsc{PDF}}
+\def\gs{\textsc{Ghostscript}}
+%
 \begin{document}
-
+\title{\texttt{pst-exa}\\
+Generate examples for PSTricks environments (with pdflatex);\\  \small v. 0.06}
+\author{Herbert Vo\ss  \\ Pablo Gonz\'{a}lez Luengo}
+%\docauthor{}
+\date{\today}
 \maketitle
 
-The package \pkg{pst-exa} was created to realize examples with printed code and output
-side by side or on top of each other. The package looks in the image directory for the source
-code of the examples and inserts only the code between the environment \env{document},
-which is the sequence \verb+\begin{document} ... \end{document}+.
+\tableofcontents
 
-The package provides the environment \env{PSTexample} with the optional
-arguments. For more information read the documentation of \texttt{pst2pdf}.
+\clearpage
 
-Using \pkg{pst-exa} makes only sense together with the Perl script \texttt{pst2pdf}, which
-allows the use of Postscript code and running the document in \textsc{pdf} mode.
+\section{Introduction}
 
-\nocite{*}
-\bibliographystyle{plain}
-\bibliography{\jobname}
+The package \LPack{pst-exa} was created to realize examples with printed
+code and output side by side or on top of each other. The package
+looks in the image directory for the source code of the examples
+and inserts only the image for code environment
+
+However, creating a \PDF\ file in a direct way with \Lprog{pst2pdf} or \Lprog{ltximg} is
+possible and the compiles whits \Lprog{pdflatex}. 
+
+\PST\ as \PS\ related package uses the programming language \PS\ for internal
+calculations. This is an important advantage, because floating point arithmetic is no
+problem. Nearly all mathematical calculation can be done when running the \DVI-file
+with \gs. 
+
+\section{Loading the package}
+
+The package \LPack{pst-exa} must be loaded with one of the following options in the preamble of the document:
+
+\begin{verbatim}
+\usepackage[swpl]{pst-exa}
+\end{verbatim}
+
+automatically load \LPack{showexpl} package. 
+
+\begin{verbatim}
+\usepackage[tcb]{pst-exa}
+\end{verbatim}
+
+automatically load \LPack{tcolorbox} package.
+
+\section{Environments}
+The package \LPack{pst-exa} provides two environments:
+
+\Lenv{PSTcode} to write only code that does not generate 
+an image, this is necessary to not interrupt the order in which the images are copied by the script in the process 
+of conversion to pdf. 
+
+\Lenv{PSTexample} environment,
+to write only code that generates an image, keep in mind that the script that performs the extraction process 
+does not distinguish the format given to the lines in this environment (only reads plain text) the idea is to 
+concentrate on the image you want to extrare and then in the format of the text.
+
+\section{Programs needed}
+You need \nxLprog{pst2pdf} (or \Lprog{ltximg}) whit a latest version of \Lprog{Ghostscript} (9.14), 
+\Lprog{perl} (>=5.18), \Lprog{pdf2svg}, \Lprog{pdftoppm} and \Lprog{pdftops}
+(from \Lprog{poppler-utils} or \Lprog{xpdf-utils}) for the process file. 
+
+The general syntax for the \emph{script} is simple:
+
+\begin{BDef}
+\nxLprog{perl} \nxLprog{pst2pdf} \Larg{file.tex} \Largs{--options}
+\end{BDef}
+
+For \TeX Live users:
 
+\begin{BDef}
+\nxLprog{pst2pdf} \Larg{file.tex} \Largs{--options}
+\end{BDef}
+
+this create file-pdf-exa.pdf and file-fig-exa-1.pdf, file-fig-exa-2.pdf, file-fig-exa-\dots.pdf
+
+\section{Examples with option \texttt{tcb}}
+
+\verb|\begin{pspicture}| o \tcboxverb{\begin{pspicture}[showgrid](4,4)}
+
+\begin{pspicture}[showgrid](4,4)
+  \psRing(2,2){0.3}{0.8}
+  \psRing*[opacity=0.5](2,2){1}{2}
+\psdot(2,2)
+\end{pspicture}
+
+%\mint[hola]{algo}$\begin{pspicture} o \begin{pspicture*}$ no problem whit inline verb :)
+\section{Test PSTexample}
+% numbers=none
+\begin{PSTexample}[pos=t,numbers=fancy,title=First example]
+\pstVerb{ 1234321 srand }
+\begin{pspicture}[showgrid](-2,-2)(2,2)
+\psframe*[linecolor=blue,opacity=!Rand](2,2)
+\psframe*[linecolor=red,opacity=!Rand](-1,-1)(1,1)
+\psframe*[linecolor=green,opacity=!Rand](-2,-2)(0,0)
+\end{pspicture}
+\end{PSTexample}
+\vspace{20pt}
+\begin{PSTexample}[hwidth=5cm]
+\begin{pspicture}[showgrid](4,4)
+  \psRing(2,2){0.3}{0.8}
+  \psRing*[opacity=0.5](2,2){1}{2}
+\psdot(2,2)
+\end{pspicture}
+\end{PSTexample}
+% ned
+\section{Test PSTcode}
+\begin{PSTcode}
+\pstVerb{ 1234321 srand }
+\begin{pspicture}[showgrid](-2,-2)(2,2)
+\psframe*[linecolor=blue,opacity=!Rand](2,2)
+\psframe*[linecolor=red,opacity=!Rand](-1,-1)(1,1)
+\psframe*[linecolor=green,opacity=!Rand](-2,-2)(0,0)
+\end{pspicture}
+\end{PSTcode}
+
+\begin{PSTcode}
+\begin{pspicture}[showgrid](4,4)
+  \psRing(2,2){0.3}{0.8}
+  \psRing*[opacity=0.5](2,2){1}{2}
+\psdot(2,2)
+\end{pspicture}
+\end{PSTcode}
+
+
+\section{Examples with option \texttt{swpl}}
+
+\makeatletter
+\pstexa@swpltrue
+% Star code for swpl option
+% Environment for code
+\let\PSTcode\relax
+\let\endPSTcode\relax
+\lstnewenvironment{PSTcode}
+  {%
+\lstset{
+    language=PSTexa,%
+    frame=single,%
+    numbers=left,%
+    numbersep=1em,%
+    numberstyle=\tiny\color{black!75}\noaccsupp,%
+    rulecolor=\color{black!67},%
+    framesep=\fboxsep,%
+    framerule=\fboxrule,%
+    xleftmargin=\dimexpr\fboxsep+\fboxrule\relax,%
+    xrightmargin=\dimexpr\fboxsep+\fboxrule\relax,%
+    backgroundcolor=\color[rgb]{1,1,0.8},%
+% literateee
+literate=*{\{}{{\textcolor{blue}{\{}}}{1}
+    {\}}{{\textcolor{blue}{\}}}}{1}
+    {[}{{\textcolor{blue}{[}}}{1}
+    {]}{{\textcolor{blue}{]}}}{1}
+    {(}{{\textcolor{blue}{(}}}{1}
+    {)}{{\textcolor{blue}{)}}}{1}
+    {\$}{{\textcolor{red}{\$}}}{1}
+    {\#}{{\textcolor{red}{\#}}}{1}%,
+ }% close lstset
+ }%
+{}% close PSTcode
+
+% Change position for images
+\renewcommand*\SX@resultInput{%
+  \ifx\SX@graphicname\@empty
+    \begingroup
+      \MakePercentComment\makeatother\catcode`\^^M=5\relax
+      \SX@@preset\SX@preset
+      \if@SX@rangeaccept
+       \let\SX@tempa=\SX@input
+      \else
+       \let\SX@tempa=\input
+      \fi
+      \SX@tempa{\SX@codefile}\par%
+    \endgroup
+  \else
+    \begin{center}
+      \expandafter\includegraphics\expandafter[\SX@graphicparam]{\SX@graphicname}
+    \end{center}
+  \fi
+}% end change postition
+% PSTexample definition in swpl
+\let\PSTexample\relax
+\let\endPSTexample\relax
+ \lstnewenvironment{PSTexample}[1][]
+ {%
+ \lstset{%
+    language=PSTexa,%
+    frame=single,%
+    numbers=left,%
+    numbersep=1em,%
+    numberstyle=\tiny\color{black!75}\noaccsupp,%
+    rulecolor=\color{black!67},%
+    framesep=\fboxsep,%
+    framerule=\fboxrule,%
+    xleftmargin=\dimexpr\fboxsep+\fboxrule\relax,%
+    xrightmargin=\dimexpr\fboxsep+\fboxrule\relax,%
+    backgroundcolor=\color[rgb]{1,1,0.8},%
+% literate for swpl, need inside the explpreset
+    explpreset={
+% literate
+literate=*{\{}{{\textcolor{blue}{\{}}}{1}
+    {\}}{{\textcolor{blue}{\}}}}{1}
+    {[}{{\textcolor{blue}{[}}}{1}
+    {]}{{\textcolor{blue}{]}}}{1}
+    {(}{{\textcolor{blue}{(}}}{1}
+    {)}{{\textcolor{blue}{)}}}{1}
+    {\$}{{\textcolor{red}{\$}}}{1}
+    {\#}{{\textcolor{red}{\#}}}{1},%
+    codefile=\jobname.swpl,%
+    hsep=\columnsep,%
+    vsep=15pt,%
+    pos=l,%
+    wide=false,%
+    rframe={},%
+    preset=\centering,%
+    } % close explpreset
+ } % close lstset
+  \@temptokena{#1}%
+   \begingroup
+     \advance\c@ltxexample\@ne \advance\c@lstlisting\@ne
+     \expandafter\lstset\expandafter{\SX@explpreset,#1}%
+     \edef\x{\endgroup
+       \def\noexpand\SX@codefile{\SX@codefile}%
+       \def\noexpand\SX@graphicname{\SX@graphicname}%
+       \def\noexpand\SX@graphicparam{\SX@graphicparam}}%
+   \x
+   \xdef\SX@@explpreset{\the\@temptokena,codefile=\SX@codefile,
+     graphic={[\SX@graphicparam]{\SX@graphicname}}}%
+   \setbox\@tempboxa=\hbox\bgroup% Warum noetig?
+   \lst@BeginWriteFile{\SX@codefile}%
+% Change position for images
+ }
+ {%
+   \lst@EndWriteFile\egroup
+   \SX@put@code@result
+  }% close environment
+% end swpl code
+\makeatother
+
+% numbers=none
+\begin{PSTexample}[pos=t,numbers=none]
+\pstVerb{ 1234321 srand }
+\begin{pspicture}[showgrid](-2,-2)(2,2)
+\psframe*[linecolor=blue,opacity=!Rand](2,2)
+\psframe*[linecolor=red,opacity=!Rand](-1,-1)(1,1)
+\psframe*[linecolor=green,opacity=!Rand](-2,-2)(0,0)
+\end{pspicture}
+\end{PSTexample}
+% numbers true default
+\begin{PSTexample}[width=5cm]
+\begin{pspicture}[showgrid](4,4)
+  \psRing(2,2){0.3}{0.8}
+  \psRing*[opacity=0.5](2,2){1}{2}
+\psdot(2,2)
+\end{pspicture}
+\end{PSTexample}
+% ned
+
+\begin{PSTcode}
+\pstVerb{ 1234321 srand }
+\begin{pspicture}[showgrid](-2,-2)(2,2)
+\psframe*[linecolor=blue,opacity=!Rand](2,2)
+\psframe*[linecolor=red,opacity=!Rand](-1,-1)(1,1)
+\psframe*[linecolor=green,opacity=!Rand](-2,-2)(0,0)
+\end{pspicture}
+\end{PSTcode}
+
+\begin{PSTcode}
+\begin{pspicture}[showgrid](4,4)
+  \psRing(2,2){0.3}{0.8}
+  \psRing*[opacity=0.5](2,2){1}{2}
+\psdot(2,2)
+\end{pspicture}
+\end{PSTcode}
+
+\begin{pspicture}[showgrid](4,4)
+  \psRing(2,2){0.3}{0.8}
+  \psRing*[opacity=0.5](2,2){1}{2}
+\psdot(2,2)
+\end{pspicture}
+
+
+
+
+\definecolor{mygreen}{rgb}{0,0.6,0}
+\definecolor{mygray}{rgb}{0.5,0.5,0.5}
+
+\lstset{ %
+  basicstyle=\ttfamily\small,
+  commentstyle=\color{mygreen},
+  extendedchars=true,
+  frame={},
+  keepspaces=true,
+  keywordstyle=\color{blue},
+  numbers=left,
+  numbersep=5pt,
+  numberstyle=\tiny\color{mygray}
+}
+%\lstinputlisting[language=TeX]{pst-exa.sty}
+%\newpage
+%
+\clearpage
+\nocite{*}
+\printbibliography
 
+\printindex
 \end{document}