summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pst-exa
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-09-13 22:05:42 +0000
committerKarl Berry <karl@freefriends.org>2017-09-13 22:05:42 +0000
commitce7643832e815cb88d6b094fd4a6230d6b8df779 (patch)
treeabc727adba6bf42411dfa42a38be8b4ade9e40c6 /Master/texmf-dist/doc/latex/pst-exa
parentd6ff3070e027de3b86593e9813d4804c76351b85 (diff)
pst-exa (14sep17)
git-svn-id: svn://tug.org/texlive/trunk@45289 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/pst-exa')
-rw-r--r--Master/texmf-dist/doc/latex/pst-exa/Changes1
-rw-r--r--Master/texmf-dist/doc/latex/pst-exa/README2
-rw-r--r--Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.bib99
-rw-r--r--Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.inc165
-rw-r--r--Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.pdfbin56513 -> 71512 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pst-exa/pst-exa-doc.tex357
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
Binary files differ
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}