new package showexpl (27mar06)

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

13 files changed, 1418 insertions, 2 deletions

diff --git a/Build/cdbuild/ctan2tds.pl b/Build/cdbuild/ctan2tds.pl
index 84a92fe6c17..9cc3741cafb 100755
--- a/Build/cdbuild/ctan2tds.pl
+++ b/Build/cdbuild/ctan2tds.pl
@@ -239,6 +239,7 @@ chdir $startdir || die "chdir($startdir) failed: $!";
  'pxfonts',	"&MAKEflatten",
  'revtex',	"&MAKEflatten",
  'seminar',	"&MAKEseminar",
+ 'showexpl',	"&MAKEflatten",
  'siam',	"&MAKEsiam",
  'skak',	"&MAKEflatten",
  'symbolindex',	"print \"requires binary, skip\"",
@@ -610,6 +611,7 @@ $standardtex='\.cfg|\.sty|\.clo|\.ldf|\.cls|\.def|\.fd$';
  'revtex',	'\.sty|\.cls|\.rtx',
  'rlepsf',	'rlepsf.tex',
  'seminar',	'\.bug|\.bg2|\.cls|\.sty|2up.tex',
+ 'showexpl',	'\.sty|\.clo|\.ldf|\.cls|\.def|\.fd$',  # not cfg
  'spotcolor',	'spotcolor*.tex',
  'startex',	'\.tex',
  'syntax',	'syntax\.tex',
diff --git a/Build/tools/tpm-ctan-check b/Build/tools/tpm-ctan-check
index 7855bd8d39c..57aa79544d8 100755
--- a/Build/tools/tpm-ctan-check
+++ b/Build/tools/tpm-ctan-check
@@ -84,8 +84,8 @@ sub main
        "randbild", "robustcommand",
        "sciposter", "sectionbox", "sectsty", "semantic",
          "seminar", "semioneside",
-         "setspace", "sf298", "sides", "skaknew", "sort-by-letters",
-         "sparklines", "spotcolor",
+         "setspace", "sf298", "showexpl", "sides", "skaknew",
+         "sort-by-letters", "sparklines", "spotcolor",
          "sttools", "struktex", "subfig", "sudoku", "svn-multi", "svninfo",
        "t-angles", "tabulary", "talk", "tamethebeast", "tex-refs",
          "texmate", "texshade", 
diff --git a/Master/texmf-dist/doc/latex/showexpl/README b/Master/texmf-dist/doc/latex/showexpl/README
new file mode 100644
index 00000000000..b32d0704b60
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/showexpl/README
@@ -0,0 +1,9 @@
+
+The LaTeX package `showexpl' provides a way to typeset LaTeX source
+code and the related result in the same document. The `listings'
+package is required. See `doc/showexpl-test.tex' for the details.
+
+                          Rolf Niepraschk
+                          email: Rolf.Niepraschk@ptb.de
+                          2006-03-26
+
diff --git a/Master/texmf-dist/doc/latex/showexpl/result-picture.pdf b/Master/texmf-dist/doc/latex/showexpl/result-picture.pdf
new file mode 100644
index 00000000000..6b17a10fd6c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/showexpl/result-picture.pdf
diff --git a/Master/texmf-dist/doc/latex/showexpl/showexpl-test.pdf b/Master/texmf-dist/doc/latex/showexpl/showexpl-test.pdf
new file mode 100644
index 00000000000..c85329a5228
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/showexpl/showexpl-test.pdf
diff --git a/Master/texmf-dist/doc/latex/showexpl/showexpl-test.tex b/Master/texmf-dist/doc/latex/showexpl/showexpl-test.tex
new file mode 100644
index 00000000000..316049f555f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/showexpl/showexpl-test.tex
@@ -0,0 +1,290 @@
+
+% Rolf Niepraschk, 2005-07-16, Rolf.Niepraschk@ptb.de
+
+\listfiles\errorcontextlines=100
+\documentclass[a4paper,draft,twoside]{article}
+
+\usepackage[dvipsnames]{xcolor}
+\usepackage[textwidth=12cm,marginparwidth=4cm]{geometry}
+
+\usepackage[final]{showexpl}
+
+\usepackage[T1]{fontenc}
+
+\IfFileExists{luximono.sty}%
+{%
+  \usepackage[scaled]{luximono}%
+}
+{%
+  \IfFileExists{beramono.sty}%
+  {%
+    \usepackage[scaled]{beramono}%
+  }{}
+}
+
+\lstset{%
+    basicstyle=\ttfamily\small,
+    commentstyle=\itshape\ttfamily\small,
+    showspaces=false,
+    showstringspaces=false,
+    breaklines=true,
+    backgroundcolor=\color{lightgray},
+    breakautoindent=true,
+    captionpos=t
+}
+
+\iftrue
+\lstset{explpreset={numbers=left,numberstyle=\tiny,numbersep=.3em,
+  xleftmargin=1em,columns=flexible,language={}}}
+\fi
+
+\usepackage[font=small,labelfont=bf,justification=raggedright,%
+  singlelinecheck=false]{caption}
+\usepackage{amsmath}
+
+\AtBeginDocument{%
+  \renewcommand*\lstlistlistingname{Examples}
+  \renewcommand*\lstlistingname{Example}
+}
+
+\newcommand*{\MARKER}%
+  {\noindent\strut\vrule
+   \hrulefill~half text area~\hrulefill\vrule
+   \hrulefill~half text area~\hrulefill\vrule
+    \marginpar{\strut\vrule\hrulefill~margin area~\hrulefill\vrule}}
+    
+\begin{filecontents*}{ex1.tex}
+Line  1 \par
+Line  2 \par
+Line  3 \par
+Line  4 \par
+Line  5 \par
+Line  6 \par
+Line  7 \par
+Line  8 \par
+Line  9 \par
+Line 10 \par
+Line 11 \par
+Line 12 \par
+Line 13
+\end{filecontents*}
+
+\begin{document}
+
+\section*{The \LaTeX\ package \textsf{showexpl}}
+
+\bigskip
+
+\lstlistoflistings
+
+\subsection*{The \textsf{listings} parameters still works}
+
+\begin{LTXexample}[pos=t,numbers=none,
+  codefile=\jobname-\theltxexample.tex]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+\MARKER
+
+\subsection*{The \texttt{pos}, \texttt{overhang}, and
+  \texttt{caption} parameters}
+
+\begin{LTXexample}[pos=b,overhang=.5\marginparwidth+.5\marginparsep,%
+  caption={The \texttt{overhang} parameter}]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+  
+\MARKER
+
+\begin{LTXexample}[pos=l,hsep=50pt,width=55mm]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+\MARKER
+
+\subsection*{The \texttt{wide} parameter with inner and outer position}
+
+\begin{LTXexample}[pos=o,wide,caption={The \texttt{wide} parameter},%
+  label=ex:Gustav]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+  
+\MARKER
+
+\begin{LTXexample}[pos=i,wide]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+
+%--------------
+\newpage
+
+\subsection*{More examples on an even (left) page}
+
+\begin{LTXexample}[pos=t]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+\MARKER
+
+\begin{LTXexample}[pos=b,overhang=.5\marginparwidth+.5\marginparsep,%
+  captionpos=b,caption={The \texttt{overhang} parameter again},%
+  label=ex:Fridolin]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+  
+\MARKER
+
+\begin{LTXexample}[pos=l,hsep=50pt,width=55mm]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+\MARKER
+
+\begin{LTXexample}[pos=o,wide,captionpos=b,%
+  caption={The \texttt{wide} parameter again}]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+  
+\MARKER
+
+\begin{LTXexample}[pos=i,wide]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+  
+%--------------
+\newpage
+
+\subsection*{Whole \LaTeX{} documents as example code and 
+  the para\-meters \texttt{preset}, \texttt{rframe}, and \texttt{rangeaccept}}
+  
+\begin{LTXexample}[pos=r,wide,width=.65,preset=\LARGE,rframe={}]
+\documentclass[a4paper,twoside]{article}
+\begin{document}
+  \begin{equation}
+    \sigma(t)=\frac{1}{\sqrt{2\pi}}
+    \int^t_0 e^{-x^2/2} dx 
+  \end{equation}
+\end{document}
+\end{LTXexample}
+
+\MARKER
+
+\begin{LTXexample}[wide,width=.75,preset=\footnotesize,rframe=single,%
+  codefile=\jobname-\theltxexample.tex]
+\documentclass[a4paper,twoside]{article}
+\usepackage{amsmath}
+% enhancements for mathematical formulas
+\begin{document}
+\begin{equation}\label{eq:barwq}
+\begin{split}
+  H_c&=\frac{1}{2n} 
+  \sum^n_{l=0}(-1)^{l}(n-{l})^{p-2}
+  \sum_{l _1+\dots+ l _p=l}\prod^p_{i=1} 
+  \binom{n_i}{l _i}\\
+  &\quad\cdot[(n-l )-(n_i-l _i)]^{n_i-l _i}\cdot
+  \Bigl[(n-l )^2-\sum^p_{j=1}(n_i-l _i)^2\Bigr].
+\end{split}
+\end{equation}
+\end{document}
+\end{LTXexample}
+
+\LTXinputExample[%
+  pos=r,backgroundcolor=\color{Goldenrod!50},%
+  %firstline=3,lastline=6,%
+  linerange={3-6,8-10},%
+  float=tb,rangeaccept=true,%
+  caption={[Floating Example]%
+    This is a floating Example (parameter \texttt{rangeaccept=true})}]{ex1}
+
+\newpage
+
+\MARKER
+
+\subsection*{Using a graphic as the result}
+
+\begin{LTXexample}[pos=i,wide]
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+\begin{LTXexample}[pos=i,wide,rframe={},%
+graphic=result-picture]% graphic=\jobname-\theltxexample
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+\begin{LTXexample}[caption={The \texttt{graphic} parameter},captionpos=b,%
+  pos=i,wide,graphic={[width=.5\linewidth]result-picture}] 
+\Large\LaTeX{} \LaTeX{}
+\LaTeX{} \LaTeX{}
+\end{LTXexample}
+
+\newpage
+
+\subsection*{The parameter \texttt{varwidth}}
+
+\bigskip
+
+\MARKER
+
+\begin{LTXexample}[caption={Fix width of the result 
+  (side-by-side default: \texttt{0.5\textbackslash linewidth})},%
+  captionpos=b]
+\setlength{\unitlength}{1cm}
+\begin{picture}(2,2) \thicklines
+  \thicklines
+  \put(0,0){\line(1,1){2}}
+  \put(0,2){\line(1,-1){2}}
+\end{picture}
+\end{LTXexample} 
+
+\medskip
+
+\begin{LTXexample}[caption={[The \texttt{varwidth} parameter]%
+  Width of the result reduced to the ``natural'' 
+  width (\texttt{varwidth=true})},varwidth,captionpos=b]
+\setlength{\unitlength}{1cm}
+\begin{picture}(2,2) \thicklines
+  \put(0,0){\line(1,1){2}}
+  \put(0,2){\line(1,-1){2}}
+\end{picture}
+\end{LTXexample}
+
+\medskip
+
+\begin{LTXexample}[caption={Fix width of the result 
+  (default: \texttt{\textbackslash linewidth})},%
+  pos=t,captionpos=b]
+\setlength{\unitlength}{1cm}
+\begin{picture}(2,2) \thicklines
+  \put(0,0){\line(1,1){2}}
+  \put(0,2){\line(1,-1){2}}
+\end{picture}
+\end{LTXexample}
+
+\medskip
+
+\begin{LTXexample}[caption={[The \texttt{justification} parameter]%
+  Result is centered  (\texttt{varwidth=true})},%
+  varwidth,captionpos=b,pos=t,justification=\centering]
+\setlength{\unitlength}{1cm}
+\begin{picture}(2,2)
+  \thicklines
+  \put(0,0){\line(1,1){2}}
+  \put(0,2){\line(1,-1){2}}
+\end{picture}
+\end{LTXexample}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/showexpl/showexpl.cfg b/Master/texmf-dist/doc/latex/showexpl/showexpl.cfg
new file mode 100644
index 00000000000..4712d03eec7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/showexpl/showexpl.cfg
@@ -0,0 +1,50 @@
+% config file for showexpl.sty
+%
+% Copyright Herbert Voss, 2005
+% Licence: LPPL.
+
+\ProvidesFile{showexpl.cfg}
+  [2005/08/28 v0.03 Definitions for the showexpl package (hv)]
+%
+\RequirePackage{xcolor}
+\definecolor{hellgelb}{rgb}{1,1,0.85}
+\definecolor{colKeys}{rgb}{0,0,1}
+\definecolor{colIdentifier}{rgb}{0,0,0}
+\definecolor{colComments}{rgb}{1,0,0}
+\definecolor{colString}{rgb}{0,0.5,0}
+
+\lstset{%
+     preset=\centering,%
+     rframe={},%
+     language=PSTricks,%
+%     language=TeX,%
+     float=hbp,%
+     basicstyle=\footnotesize\ttfamily,%
+     identifierstyle=\color{colIdentifier},%
+     keywordstyle=\color{colKeys},%
+     stringstyle=\color{colString},%
+     commentstyle=\itshape\color{colComments},%
+%    columns=flexible,%
+%    columns=fullflexible,%
+     columns=fixed,
+     tabsize=4,%
+     frame=single,%
+     extendedchars=true,%
+     showspaces=false,%
+     showstringspaces=false,%
+     numbers=left,%
+     numberstyle=\tiny\ttfamily,%
+     numbersep=1em,%
+     breaklines=true,%
+     breakindent=10pt,%
+     backgroundcolor=\color{hellgelb},%
+     breakautoindent=true,%
+     captionpos=t,%
+     xleftmargin=1em,%
+     xrightmargin=\fboxsep,%
+     numbersep=1em,%
+%     xrightmargin=-1cm,% 
+%     relwidth=0.5,%
+%     columnsep=10pt%
+}
+\renewcommand*\SX@Info{}%
diff --git a/Master/texmf-dist/source/latex/showexpl/showexpl.dtx b/Master/texmf-dist/source/latex/showexpl/showexpl.dtx
new file mode 100644
index 00000000000..de5e77937b7
--- /dev/null
+++ b/Master/texmf-dist/source/latex/showexpl/showexpl.dtx
@@ -0,0 +1,607 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2004, 2005 by Rolf Niepraschk <Rolf.Niepraschk@ptb.de>
+% --------------------------------------------------------------------
+% 
+% This file 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.
+% The latest version of this license is in:
+%
+%    http://www.latex-project.org/lppl.txt
+%
+% and version 1.2 or later is part of all distributions of LaTeX 
+% version 1999/12/01 or later.
+%
+% \fi
+%
+% \iffalse
+%<*driver>
+\ProvidesFile{showexpl.dtx}
+%</driver>
+%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
+%<package>\ProvidesPackage{showexpl}
+%<*package>
+    [2005/12/06 v0.3d Typesetting example code (RN)]
+%</package>
+%
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage{showexpl}
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+\begin{document}
+  \DocInput{showexpl.dtx}
+  \PrintChanges
+  \PrintIndex
+\end{document}
+%</driver>
+% \fi
+%
+% \CheckSum{797}
+%
+% \CharacterTable
+%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%   Digits        \0\1\2\3\4\5\6\7\8\9
+%   Exclamation   \!     Double quote  \"     Hash (number) \#
+%   Dollar        \$     Percent       \%     Ampersand     \&
+%   Acute accent  \'     Left paren    \(     Right paren   \)
+%   Asterisk      \*     Plus          \+     Comma         \,
+%   Minus         \-     Point         \.     Solidus       \/
+%   Colon         \:     Semicolon     \;     Less than     \<
+%   Equals        \=     Greater than  \>     Question mark \?
+%   Commercial at \@     Left bracket  \[     Backslash     \\
+%   Right bracket \]     Circumflex    \^     Underscore    \_
+%   Grave accent  \`     Left brace    \{     Vertical bar  \|
+%   Right brace   \}     Tilde         \~}
+%
+%
+% \changes{v0.1a}{2004/11/14}{Initial version}
+%
+% \GetFileInfo{showexpl.dtx}
+%
+% \DoNotIndex{\newcommand,\renewcommand,\newenvironment,\renewenvironment}
+% \DoNotIndex{\usepackage,\documentclass,\nofiles,\bibliogaphy}
+% \DoNotIndex{\tiny,\tableofcontens}
+% \DoNotIndex{\newif,\newcounter,\linewidth,\listfiles}
+% \DoNotIndex{\providecommand,\def,\edef,\let,\gdef,\xdef,\global,\newtoks}
+% \DoNotIndex{\RequirePackage,\DeclareOption,\ProcessOptions,\ExecuteOptions}
+% \DoNotIndex{\@nameuse,\value,\input,\InputIfFileExists}
+% \DoNotIndex{\@ifdefinable,\@ifundefined,\@percentchar}
+% \DoNotIndex{\AtBeginDocument,\AtEndOfPackage,\PassOptionsToPackage}
+% \DoNotIndex{\CurrentOption,\jobname}
+% \DoNotIndex{\PackageError,\PackageWarning,\PackageWarningNoLine,\PackageInfo}
+% \DoNotIndex{\MessageBreak,\typeout}
+% \DoNotIndex{\z@,\z@skip,\p@,\@ne,\tw@,\thr@@,\@iv,\two@fourteen,\strip@pt}
+% \DoNotIndex{\the,\if,\else,\or,\fi,\ifnum,\ifdim,\ifcase,\ifodd}
+% \DoNotIndex{\advance,\multiply,\divide,\ht,\dp,\wd,\catcode}
+% \DoNotIndex{\@tfor,\do,\bgroup,\egroup,\ifx,\iftrue,\iffalse}
+% \DoNotIndex{\csname,\endcsname,\begingroup,\endgroup}
+% \DoNotIndex{\expandafter,\afterassignment,\noexpand}
+% \DoNotIndex{\@tempdima,\@tempdimb,\@tempdimc,\@tempcnta,\@tempcntb}
+% \DoNotIndex{\@halfwidth,\@wholewidth,\unitlength}
+% \DoNotIndex{\@clnwd,\@clnht,\@ovdx,\@ovdy,\@ovro,\@ovri,\@ovxx,\@ovyy}
+% \DoNotIndex{\@xarg,\@xdim,\@yarg,\@ydim,\@linelen,\@dashdim,\dimen@}
+% \DoNotIndex{\reserved@a,\relax,\protect,\long,\space}
+% \DoNotIndex{\if@tempswa,\@tempswatrue,\@tempswafalse,\@tempa}
+% \DoNotIndex{\@tempboxa,\@tempboxb,\show}
+% \DoNotIndex{\@empty,\%,\typeout,\vspace,\vskip,\the,\hbox,\par}
+% \DoNotIndex{\minipage,\endminipage,\trivlist,\endtrivlist}
+% \DoNotIndex{\parbox,\setbox,\setlength,\hfill,\item,\number}
+% \DoNotIndex{\x}
+% \DoNotIndex{\SX@put@a,\SX@put@b,\SX@put@l,\SX@put@r,\SX@put@o,\SX@put@i}
+% 
+% ^^A\DoNotIndex{\usepackage,\documentclass,\tableofcontens,\printindex}
+%
+% \title{The \textsf{showexpl} package\thanks{This document
+%   corresponds to \textsf{showexpl}~\fileversion, dated \filedate.}}
+% \author{Rolf Niepraschk\thanks{\texttt{Rolf.Niepraschk@ptb.de}}}
+% \date{\filedate}
+%
+% \maketitle
+%
+% \section{Introduction}
+%
+% Put text here.
+%
+% \section{Usage}
+%
+% Put text here.
+%
+%
+% \StopEventually{}
+%
+% \section{Implementation}
+% \changes{v0.1e}{2004/11/24}{Loading of |showexpl.cfg| added (RN).}
+%    \begin{macrocode}
+\DeclareOption{final}{%
+  \PassOptionsToPackage{\CurrentOption}{graphicx}%
+  \PassOptionsToPackage{\CurrentOption}{listings}%
+}%
+\DeclareOption{draft}{%
+  \PassOptionsToPackage{\CurrentOption}{graphicx}%
+  \PassOptionsToPackage{\CurrentOption}{listings}%
+}%
+\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{listings}}
+\ProcessOptions\relax
+\RequirePackage{listings,calc,ifthen,graphicx,varwidth}
+\AtEndOfPackage{\IfFileExists{attachfile.sty}%
+  {\RequirePackage{attachfile}}{\def\SX@attachfile{}}}
+%    \end{macrocode}
+% We must aktivate code from package \textsf{listings} for writing files.
+%    \begin{macrocode}
+\lst@RequireAspects{writefile}
+%    \end{macrocode}
+% \begin{macro}{\SX@defaultWD}
+% Parameter |#2| is a length or a number. Parameter |#1| is a
+% macro. After a call of \cmd{\SX@defaultWD} this macro contains the value
+% of the length or the value of the number multiplied by \cmd{\linewidth}.
+%    \begin{macrocode}
+\newcommand*\SX@defaultWD[2]{%
+  \afterassignment\SX@def@WD\dimen@#2\linewidth\relax{#1}}
+\newcommand*\SX@def@WD{}
+\def\SX@def@WD#1\relax#2{\edef#2{\the\dimen@}} 
+%    \end{macrocode}
+% \end{macro}
+% Additional keys.
+% \changes{v0.1a}{2004/11/14}{``hpos'' and ``vpos'' added, 
+% ``pos'' removed (RN).}
+% \changes{v0.1f}{2004/12/06}{``lstpreset'' added. (RN).}
+% \changes{v0.1h}{2005/06/03}{``codefile'' added. (RN).}
+%    \begin{macrocode}
+\lst@Key{pos}\relax{\def\SX@pos{#1}}
+\lst@Key{width}\relax{\def\SX@width{#1}}
+\lst@Key{hsep}\relax{\@tempdima=#1\relax\edef\SX@hsep{\the\@tempdima}}
+\lst@Key{vsep}\relax{\@tempdima=#1\relax\edef\SX@vsep{\the\@tempdima}}
+\lst@Key{overhang}\relax{\def\SX@overhang{#1}}
+\lst@Key{wide}f[t]{\lstKV@SetIf{#1}\if@SX@wide}
+\lst@Key{rframe}\relax{\def\SX@rframe{#1}}
+\lst@Key{preset}\relax{\def\SX@preset{#1}}
+%    \end{macrocode}
+% \changes{v0.1h}{2005/06/03}{``lstpreset'' renamed to ``explpreset'' (RN).}
+%    \begin{macrocode}
+\lst@Key{explpreset}\relax{\def\SX@explpreset{#1}}
+\lst@Key{codefile}\relax{\def\SX@codefile{#1}}
+\newif\if@SX@rangeaccept \@SX@rangeacceptfalse
+\newif\if@SX@varwidth \@SX@varwidthfalse
+\newif\if@SX@wide \@SX@widefalse
+\newif\if@SX@attachfile \@SX@attachfilefalse
+%    \end{macrocode}
+% \changes{v0.1j}{2005/06/12}{``rangeaccept'' added (RN).}
+% \changes{v0.1k}{2005/06/13}{Some bug corrections (RN).}
+%    \begin{macrocode}
+\lst@Key{rangeaccept}f[t]{\lstKV@SetIf{#1}\if@SX@rangeaccept}
+%    \end{macrocode}
+% \changes{v0.2a}{2005/07/16}{``varwidth'' and ``justification'' added (RN).}
+% \changes{v0.1l}{2005/06/19}{``graphic'' added (RN).}
+% \changes{v0.3a}{2005/08/20}{``attachfile'' added (RN).}
+%    \begin{macrocode}
+\lst@Key{varwidth}f[t]{\lstKV@SetIf{#1}\if@SX@varwidth}
+\lst@Key{justification}\relax{\def\SX@justification{#1}}
+\lst@Key{attachfile}f[t]{\lstKV@SetIf{#1}\if@SX@attachfile}
+\newcommand*\SX@graphicname{}%
+\newcommand*\SX@graphicparam{}%
+\lst@Key{graphic}{}[]{%
+  \lstKV@OptArg[width=\linewidth]{#1}{%
+    \edef\SX@graphicparam{##1}\edef\SX@graphicname{##2}%
+  }%
+}%
+\newbox\SX@ResBox
+\newcommand*\SX@pos{}
+\newcommand*\SX@width{}
+\newcommand*\SX@hsep{}
+\newcommand*\SX@vsep{}
+\newcommand*\SX@overhang{}
+\newcommand*\SX@rframe{}
+\newcommand\SX@preset{}
+\newcommand*\SX@explpreset{}
+\newcommand*\SX@codefile{}\edef\SX@codefile{\jobname.tmp}
+\newcommand*\SX@justification{\raggedright}
+%    \end{macrocode}
+% \begin{macro}{\SX@@preset}
+% Contains some redefinitions of \LaTeX\ macros and environments to do
+% nothing. \cmd{\SX@@preset} will be called just before 
+% typesetting the result of the example code. More can be added with 
+% the user key ``|preset=...|''.
+%    \begin{macrocode}  
+\newcommand*\SX@@preset{%
+  \renewcommand\documentclass[2][]{\SX@eat@version}%
+  \renewcommand\usepackage[2][]{\SX@eat@version}%
+  \renewenvironment{document}{}{}%
+  \renewenvironment{figure}[1][]{\def\@captype{figure}}{}%
+  \renewenvironment{table}[1][]{\def\@captype{table}}{}%
+  \renewcommand\cite[1][]{}%
+  \let\tableofcontens\relax
+  \let\listoffigures\relax
+  \let\listoftables\relax
+  \let\printindex\relax
+  \let\listfiles\relax
+  \let\nofiles\relax
+  \let\index\@gobble
+  \let\label\@gobble
+  \let\bibliography\@gobble
+}
+\newcommand*\SX@eat@version[1][]{}
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\isSX@odd}
+%  Parameter |#1| is executed on odd pages, parameter |#2| on 
+%  even pages. 
+%    \begin{macrocode}
+\newif\ifSX@wasodd
+\if@twoside
+  \newcommand*{\isSX@odd}[2]{%
+    \ifthenelse{\isodd{\pageref{\SX@IDENT}}}%
+      {\SX@wasoddtrue #1}{\SX@wasoddfalse #2}}
+\else
+  \newcommand*{\isSX@odd}[2]{#1}\SX@wasoddtrue
+\fi
+%    \end{macrocode}
+%  The call of \cmd{\isSX@odd} sets also \cmd{\ifSX@wasodd} to true or 
+%  false. If it's clear that no page break occurs, \cmd{\ifSX@wasodd}
+%  can be used.
+%    \begin{macrocode}
+\newcounter{ltxexample}
+\newcommand*{\SX@IDENT}{SX@\number\value{ltxexample}}
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\SX@attachfile}
+% \changes{v0.3a}{2005/08/20}{Attach file functionality (with pdf\TeX) 
+%   added (RN).}
+%    \begin{macrocode}
+\newcommand*\SX@attachfile{%
+  \if@SX@attachfile
+    \attachfile[mimetype=text/plain,subject={example \theltxexample}]%
+      {\SX@codefile}{}%
+  \fi
+}
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\SX@put@t/b/l/r/o/i}
+% Six macros for positioning |#2| (result) and |#3| (code). The result
+% can be 
+% \underline{a}bove, \underline{b}elow, \underline{l}eft or 
+% \underline{r}ight of the code area or on the \underline{o}uter or 
+% \underline{i}nner side. Parameter |#1| is the width of the result.
+% \changes{v0.1b}{2004/11/18}{Positioning the captions more independend 
+%   of the result and code area (RN).}
+% \changes{v0.1c}{2004/11/19}{Commands \cmd{\SX@KillAboveCaptionskip} and 
+%   \cmd{\SX@KillBelowCaptionskip} added (RN).}
+% \changes{v0.1k}{2005/06/13}{Change [a]bove to [t]op (RN).}
+%    \begin{macrocode}
+\newcommand*\SX@put@t[3]{%
+  \SX@ResultArea{\linewidth}{#2}\endgraf\pagebreak[2]%
+  \setlength\@tempdima{\SX@vsep}\vskip\@tempdima
+  \SX@CodeArea{\linewidth}{#3}%
+}
+\newcommand*\SX@put@b[3]{%
+  \SX@CodeArea{\linewidth}{#3}\endgraf\pagebreak[2]%
+  \setlength\@tempdima{\SX@vsep}\vskip\@tempdima
+  \SX@ResultArea{\linewidth}{#2}%
+}
+\newcommand*\SX@put@l[3]{%
+  \setlength\@tempdimc{\linewidth-#1-\SX@hsep}%
+  \SX@ResultArea{#1}{#2}\hfill\SX@CodeArea{\@tempdimc}{#3}%
+}
+\newcommand*\SX@put@r[3]{%
+  \setlength\@tempdimc{\linewidth-#1-\SX@hsep}%
+  \SX@CodeArea{\@tempdimc}{#3}\hfill\SX@ResultArea{#1}{#2}%
+}
+\newcommand*\SX@put@o[3]{%
+  \@nameuse{SX@put@\ifSX@wasodd r\else l\fi}{#1}{#2}{#3}%
+}
+\newcommand*\SX@put@i[3]{%
+  \@nameuse{SX@put@\ifSX@wasodd l\else r\fi}{#1}{#2}{#3}%
+}
+\newcommand\SX@ResultArea[2]{%
+  \SX@justification\setlength\@tempdima{#1}%
+  %\minipage\@tempdima#2\endminipage
+  \parbox\@tempdima{#2}%
+}
+\newcommand\SX@CodeArea[2]{%
+  \setlength\@tempdima{#1}%
+  \sbox\@tempboxa{\parbox\@tempdima{#2}}%
+  \@tempdima=\dp\@tempboxa\usebox\@tempboxa
+  \rlap{\raisebox{-\@tempdima}[0pt][0pt]{\SX@attachfile}}%
+}
+\newcommand*\SX@KillAboveCaptionskip{%
+  \ifx\lst@caption\@empty\else
+    \lst@IfSubstring t\lst@captionpos
+      {\vskip-\abovecaptionskip}{}%
+  \fi
+}
+\newcommand*\SX@KillBelowCaptionskip{%
+  \ifx\lst@caption\@empty\else
+    \lst@IfSubstring b\lst@captionpos
+      {\vskip-\belowcaptionskip}{}%
+  \fi
+}
+%    \end{macrocode}
+% \end{macro}
+% 
+% \begin{environment}{LTXexample}
+% \changes{v0.1h}{2005/06/03}{Renamed from ``example'' to ``LTXexample' (RN).}
+%    \begin{macrocode}
+\lstnewenvironment{LTXexample}[1][]
+{%
+  \@temptokena{#1}%
+  \begingroup
+%    \end{macrocode}
+% For "codefile=..."/"graphic=..." if \cmd{\theltxexample} or 
+% \cmd{\thelstlisting} is part of the filename.
+%    \begin{macrocode}
+    \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}%
+}
+{%
+  \lst@EndWriteFile\egroup
+  \SX@put@code@result
+}
+%    \end{macrocode}
+% \end{environment}
+% \changes{v0.1i}{2005/06/07}{Better caption positioning and 
+%   correct distance between the parts (RN).}
+% \changes{v0.1m}{2005/06/25}{Problem related to \cmd{\label}/\cmd{\ref}
+%   solved (RN).}
+% \changes{v0.2a}{2005/07/16}{``varwidth'' package used (RN).}
+% \changes{v0.2b}{2005/07/30}{Check if \cmd{\SX@put@}\texttt{?} 
+%   is defined (RN).}
+%    \begin{macrocode}
+\newcommand*\SX@put@code@result{%
+  \begingroup
+    \expandafter\lstset\expandafter{\SX@explpreset}%
+    \let\lst@float=\relax\let\SX@float=\relax
+%    \end{macrocode}
+% Without the following call \cmd{\lst@beginfloat} is undefined.
+%    \begin{macrocode}
+    \expandafter\lstset\expandafter{\SX@@explpreset}%
+    \ifx\lst@float\relax\else
+%    \end{macrocode}
+% \cmd{\lst@float} must be \cmd{\relax} because the whole ``example'' 
+% should float but not the listings part in addition.
+%    \begin{macrocode}
+      \let\SX@float=\lst@float\let\lst@float=\relax
+      \g@addto@macro\SX@@explpreset{,float=false}%
+      \edef\@tempa{\noexpand\lst@beginfloat{lstlisting}[\SX@float]}%
+      \expandafter\@tempa
+    \fi
+    \ifx\lst@caption\@empty
+      \lstset{nolol=true}%
+    \fi
+    \if@SX@wide\def\SX@overhang{\marginparwidth+\marginparsep}\fi
+    \trivlist\item\relax
+      \stepcounter{ltxexample}\label{\SX@IDENT}%
+%    \end{macrocode}
+% Make \cmd{\SX@width} a real dimension if the unit is missing. 
+%    \begin{macrocode}
+      \SX@defaultWD\SX@width{\SX@width}%
+%    \end{macrocode}
+% Set the default width if necessary. 
+%    \begin{macrocode}
+      \ifdim\SX@width<\z@
+        \@tempswatrue
+        \def\@tempa{t}%
+        \ifx\@tempa\SX@pos\@tempswafalse\fi
+        \def\@tempa{b}%
+        \ifx\@tempa\SX@pos\@tempswafalse\fi
+        \setlength\@tempdima{\linewidth+\SX@overhang}%
+        \if@tempswa\@tempdima=.5\@tempdima\fi%
+        \edef\SX@width{\the\@tempdima}%
+      \fi
+%    \end{macrocode}
+% Correct \cmd{\SX@width} if a frame is requested. 
+%    \begin{macrocode}
+      \ifx\SX@rframe\@empty
+        \long\def\SX@frame##1{##1}%
+      \else
+        \let\SX@frame\fbox
+        \setlength\@tempdima{\SX@width-2\fboxsep-2\fboxrule}%
+        \edef\SX@width{\the\@tempdima}%
+      \fi
+      \isSX@odd{\def\@tempa{l}}{\def\@tempa{r}}%
+      \makebox[\linewidth][\@tempa]{%
+        \parbox{\linewidth+\SX@overhang}{%
+%    \end{macrocode}
+% \cmd{\SX@codefile} (|\jobname.tmp|) is not nessesary for the filelist.
+%    \begin{macrocode}        
+          \let\@addtofilelist\@gobble
+          \let\lst@ifdisplaystyle=\iftrue
+          \SX@KillAboveCaptionskip\lst@MakeCaption{t}%
+          \lst@belowskip=\z@
+          \let\SX@MakeCaption\lst@MakeCaption
+          \let\lst@MakeCaption\@gobble
+%    \end{macrocode}
+% Use the ``natural'' width of the result code if ``varwidth'' is 
+% true. 
+%    \begin{macrocode}
+          \setbox\SX@ResBox\hbox{%
+            \SX@frame{%
+              \@nameuse{\if@SX@varwidth varwidth\else minipage\fi}%
+                \SX@width\relax\SX@resultInput%
+              \@nameuse{end\if@SX@varwidth varwidth\else minipage\fi}}}%
+          \edef\SX@width{\the\wd\SX@ResBox}%
+          \@ifundefined{SX@put@\SX@pos}%
+            {\@latex@error{Parameter `\SX@pos' undefined}\@ehd}%
+          {\@nameuse{SX@put@\SX@pos}%
+            {\SX@width}{\box\SX@ResBox}{\SX@codeInput}}%
+          \let\lst@MakeCaption\SX@MakeCaption
+          \lst@MakeCaption{b}\SX@KillBelowCaptionskip
+        }%
+      }%
+    \endtrivlist
+    \ifx\SX@float\relax\else\expandafter\lst@endfloat\fi
+    \gdef\SX@@explpreset{}%
+  \endgroup
+}
+\newcommand\SX@SkipToFirst{%
+  \ifeof\@inputcheck\else
+    \ifnum \lst@lineno=\lst@firstline\else
+      \read\@inputcheck to\SX@tempa
+      \typeout{IGNORE (\the\lst@lineno)}%
+      \global\advance\lst@lineno\@ne
+      \SX@SkipToFirst
+    \fi
+  \fi
+}
+\newcommand\SX@ProcessResult{%
+  \ifeof\@inputcheck\else
+    \let\SX@tempb\SX@ProcessResult
+    \ifnum \lst@lineno>\lst@lastline
+      \ifx\lst@linerange\@empty
+        \let\SX@tempb\relax
+      \else
+        \lst@GetLineInterval
+        \SX@SkipToFirst
+      \fi
+    \else
+      \read\@inputcheck to\SX@tempa
+      \typeout{READ (\the\lst@lineno)}%
+      \expandafter\g@addto@macro\expandafter\SX@lines\expandafter{\SX@tempa}%
+      \global\advance\lst@lineno\@ne
+    \fi
+    \expandafter\SX@tempb
+  \fi
+}
+%    \end{macrocode}
+% \begin{macro}{\SX@input}
+% \changes{v0.1j}{2005/06/12}{For ranges of lines (RN).}
+%    \begin{macrocode} 
+\newcommand\SX@input[1]{%
+  \begingroup
+    \IfFileExists{#1}{}%
+    {%
+      \filename@parse{#1}%
+      \ifx\filename@ext\relax \def\filename@ext{tex}\fi
+      \@latexerr{File 
+        `\filename@area\filename@base.\filename@ext' not found.^^J^^J}\@ehd%
+    }%
+    \openin\@inputcheck#1
+    \lsthk@PreSet\let\lst@linerange\@empty\global\lst@lineno\@ne
+    \expandafter\lstset\expandafter{\SX@@explpreset}%
+    \ifx\lst@linerange\@empty
+      \edef\lst@linerange{{\lst@firstline}-{\lst@lastline},}%
+    \fi
+    \lst@GetLineInterval
+    \SX@Info
+    \SX@SkipToFirst\let\SX@lines\@empty
+    \SX@ProcessResult
+    \closein\@inputcheck
+    \SX@lines
+  \endgroup
+}
+%    \end{macrocode}
+% \end{macro} 
+%    \begin{macrocode}   
+\newcommand*\SX@Info{%
+  \typeout{--------------------------------}%
+  \typeout{pos=\SX@pos}%
+  \typeout{width=\SX@width}%
+  \typeout{hsep=\SX@hsep}%
+  \typeout{vsep=\SX@vsep}%
+  \typeout{overhang=\SX@overhang}%
+  \typeout{rframe=\SX@rframe}%
+  \typeout{codefile=\SX@codefile}%
+  \@ifundefined{lst@firstline}{}%
+    {\typeout{\string\lst@firstline=\lst@firstline}}%
+  \@ifundefined{lst@lastline}{}%
+    {\typeout{\string\lst@lastline=\lst@lastline}}%
+  \@ifundefined{lst@linerange}{}%
+    {\typeout{\string\lst@linerange=\lst@linerange}}%
+  \typeout{\string\if@SX@wide=\if@SX@wide TRUE\else FALSE\fi}%
+  \typeout{\string\if@SX@rangeaccept=\if@SX@rangeaccept TRUE\else FALSE\fi}%
+  \typeout{\string\if@SX@varwidth=\if@SX@varwidth TRUE\else FALSE\fi}%
+  \typeout{graphicfile=\SX@graphicname, graphicparameter=[\SX@graphicparam]}%
+  \typeout{--------------------------------}%
+}
+\providecommand*\MakePercentIgnore{\catcode`\%9\relax}
+\providecommand*\MakePercentComment{\catcode`\%14\relax}
+%    \end{macrocode}
+% \begin{macro}{\SX@resultInput}
+% \changes{v0.3b}{2005/10/15}{Input of result code now inside a group; 
+% \cmd{\makeatother} added (RN).}
+% \changes{v0.3c}{2005/10/15}{Wrong catcode for newline char corrected (RN).}
+% \changes{v0.3d}{2005/12/06}{Missing \cs{par} added (RN).}
+%    \begin{macrocode}
+\newcommand*\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
+    \expandafter\includegraphics\expandafter[\SX@graphicparam]%
+      {\SX@graphicname}%
+  \fi
+}
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\SX@codeInput}
+%    \begin{macrocode}
+\newcommand*\SX@codeInput{%
+%    \end{macrocode}
+% Without a caption entry the command \cmd{\lstinputlisting} adds the 
+% filename to the ``list of listings'' (lol). This should be avoided. 
+% \changes{v0.1d}{2004/11/20}{\cmd{\lstset}|{nolol}| and
+%   \cmd{\lstset}|{float=false}| added (RN).}
+% \changes{v0.1h}{2005/06/03}{\cmd{\lstset}|{float=false}| removed (RN).}
+%    \begin{macrocode}
+  \begingroup
+%    \end{macrocode}
+% The default parameters for all examples. 
+%    \begin{macrocode}  
+  \expandafter\lstset\expandafter{\SX@explpreset}%
+%    \end{macrocode}
+% If "numbers=none" then margin dimensions should be zero. 
+%    \begin{macrocode}
+    \expandafter\lstset\expandafter{\SX@@explpreset}%
+    \ifx\lst@PlaceNumber\@empty
+      \g@addto@macro\SX@@explpreset{,xleftmargin=0pt,xrightmargin=0pt}%
+    \fi
+    \SX@Info
+    \expandafter\lstinputlisting\expandafter%
+      [\SX@@explpreset,nolol=true,caption={}]{\SX@codefile}%
+  \endgroup
+}%
+%    \end{macrocode}
+% \end{macro}
+% \changes{v0.1h}{2005/06/03}{New macro \cmd{\LTXinputExample} (RN).}
+%    \begin{macrocode}
+\newcommand*\LTXinputExample[2][]{% 
+  \g@addto@macro\SX@@explpreset{#1,codefile=#2}%
+  \SX@put@code@result}%
+%    \end{macrocode}
+% All the default values.
+%    \begin{macrocode}
+\lstset{explpreset={numbers=left,numberstyle=\tiny,numbersep=.3em,
+%    \end{macrocode}
+% Negative width means defaults.
+%    \begin{macrocode}
+  xleftmargin=1em,columns=flexible,language=[LaTeX]TEX},pos=l,width=-99pt,
+  overhang=0pt,hsep=\columnsep,vsep=\bigskipamount,rframe=single}
+%    \end{macrocode}
+% \changes{v0.1g}{2004/12/10}{Loading of |showexpl.cfg| now at end of 
+%   package (RN).}
+% Changing the defaults possible in |showexpl.cfg|.
+%    \begin{macrocode}
+\InputIfFileExists{showexpl.cfg}{}{}
+%    \end{macrocode}
+%
+% \Finale
+\endinput
diff --git a/Master/texmf-dist/source/latex/showexpl/showexpl.ins b/Master/texmf-dist/source/latex/showexpl/showexpl.ins
new file mode 100644
index 00000000000..37e454e7d8c
--- /dev/null
+++ b/Master/texmf-dist/source/latex/showexpl/showexpl.ins
@@ -0,0 +1,57 @@
+%%
+%% Copyright (C) 2004 by Rolf Niepraschk <Rolf.Niepraschk@ptb.de>
+%%
+%% This file 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.  The latest version of this
+%% license is in:
+%% 
+%%    http://www.latex-project.org/lppl.txt
+%% 
+%% and version 1.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+%%
+
+\input docstrip.tex
+\keepsilent
+
+\usedir{tex/latex/showexpl}
+
+\preamble
+
+This is a generated file.
+
+Copyright (C) 2004 by Rolf Niepraschk <Rolf.Niepraschk@ptb.de>
+
+This file 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.  The latest version of this
+license is in:
+
+   http://www.latex-project.org/lppl.txt
+
+and version 1.2 or later is part of all distributions of LaTeX version
+1999/12/01 or later.
+
+\endpreamble
+
+\askforoverwritefalse
+
+\generate{\file{showexpl.sty}{\from{showexpl.dtx}{package}}}
+
+\obeyspaces
+\Msg{*************************************************************}
+\Msg{*                                                           *}
+\Msg{* To finish the installation you have to move the following *}
+\Msg{* file into a directory searched by TeX:                    *}
+\Msg{*                                                           *}
+\Msg{*     showexpl.sty                                          *}
+\Msg{*                                                           *}
+\Msg{* To produce the documentation run the file showexpl.dtx    *}
+\Msg{* through LaTeX.                                            *}
+\Msg{*                                                           *}
+\Msg{* Happy TeXing!                                             *}
+\Msg{*                                                           *}
+\Msg{*************************************************************}
+
+\endbatchfile
diff --git a/Master/texmf-dist/tex/latex/showexpl/showexpl.sty b/Master/texmf-dist/tex/latex/showexpl/showexpl.sty
new file mode 100644
index 00000000000..084f29dca06
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/showexpl/showexpl.sty
@@ -0,0 +1,357 @@
+%%
+%% This is file `showexpl.sty',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% showexpl.dtx  (with options: `package')
+%% 
+%% This is a generated file.
+%% 
+%% Copyright (C) 2004 by Rolf Niepraschk <Rolf.Niepraschk@ptb.de>
+%% 
+%% This file 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.  The latest version of this
+%% license is in:
+%% 
+%%    http://www.latex-project.org/lppl.txt
+%% 
+%% and version 1.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+%% 
+\NeedsTeXFormat{LaTeX2e}[1999/12/01]
+\ProvidesPackage{showexpl}
+    [2005/12/06 v0.3d Typesetting example code (RN)]
+\DeclareOption{final}{%
+  \PassOptionsToPackage{\CurrentOption}{graphicx}%
+  \PassOptionsToPackage{\CurrentOption}{listings}%
+}%
+\DeclareOption{draft}{%
+  \PassOptionsToPackage{\CurrentOption}{graphicx}%
+  \PassOptionsToPackage{\CurrentOption}{listings}%
+}%
+\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{listings}}
+\ProcessOptions\relax
+\RequirePackage{listings,calc,ifthen,graphicx,varwidth}
+\AtEndOfPackage{\IfFileExists{attachfile.sty}%
+  {\RequirePackage{attachfile}}{\def\SX@attachfile{}}}
+\lst@RequireAspects{writefile}
+\newcommand*\SX@defaultWD[2]{%
+  \afterassignment\SX@def@WD\dimen@#2\linewidth\relax{#1}}
+\newcommand*\SX@def@WD{}
+\def\SX@def@WD#1\relax#2{\edef#2{\the\dimen@}}
+\lst@Key{pos}\relax{\def\SX@pos{#1}}
+\lst@Key{width}\relax{\def\SX@width{#1}}
+\lst@Key{hsep}\relax{\@tempdima=#1\relax\edef\SX@hsep{\the\@tempdima}}
+\lst@Key{vsep}\relax{\@tempdima=#1\relax\edef\SX@vsep{\the\@tempdima}}
+\lst@Key{overhang}\relax{\def\SX@overhang{#1}}
+\lst@Key{wide}f[t]{\lstKV@SetIf{#1}\if@SX@wide}
+\lst@Key{rframe}\relax{\def\SX@rframe{#1}}
+\lst@Key{preset}\relax{\def\SX@preset{#1}}
+\lst@Key{explpreset}\relax{\def\SX@explpreset{#1}}
+\lst@Key{codefile}\relax{\def\SX@codefile{#1}}
+\newif\if@SX@rangeaccept \@SX@rangeacceptfalse
+\newif\if@SX@varwidth \@SX@varwidthfalse
+\newif\if@SX@wide \@SX@widefalse
+\newif\if@SX@attachfile \@SX@attachfilefalse
+\lst@Key{rangeaccept}f[t]{\lstKV@SetIf{#1}\if@SX@rangeaccept}
+\lst@Key{varwidth}f[t]{\lstKV@SetIf{#1}\if@SX@varwidth}
+\lst@Key{justification}\relax{\def\SX@justification{#1}}
+\lst@Key{attachfile}f[t]{\lstKV@SetIf{#1}\if@SX@attachfile}
+\newcommand*\SX@graphicname{}%
+\newcommand*\SX@graphicparam{}%
+\lst@Key{graphic}{}[]{%
+  \lstKV@OptArg[width=\linewidth]{#1}{%
+    \edef\SX@graphicparam{##1}\edef\SX@graphicname{##2}%
+  }%
+}%
+\newbox\SX@ResBox
+\newcommand*\SX@pos{}
+\newcommand*\SX@width{}
+\newcommand*\SX@hsep{}
+\newcommand*\SX@vsep{}
+\newcommand*\SX@overhang{}
+\newcommand*\SX@rframe{}
+\newcommand\SX@preset{}
+\newcommand*\SX@explpreset{}
+\newcommand*\SX@codefile{}\edef\SX@codefile{\jobname.tmp}
+\newcommand*\SX@justification{\raggedright}
+\newcommand*\SX@@preset{%
+  \renewcommand\documentclass[2][]{\SX@eat@version}%
+  \renewcommand\usepackage[2][]{\SX@eat@version}%
+  \renewenvironment{document}{}{}%
+  \renewenvironment{figure}[1][]{\def\@captype{figure}}{}%
+  \renewenvironment{table}[1][]{\def\@captype{table}}{}%
+  \renewcommand\cite[1][]{}%
+  \let\tableofcontens\relax
+  \let\listoffigures\relax
+  \let\listoftables\relax
+  \let\printindex\relax
+  \let\listfiles\relax
+  \let\nofiles\relax
+  \let\index\@gobble
+  \let\label\@gobble
+  \let\bibliography\@gobble
+}
+\newcommand*\SX@eat@version[1][]{}
+\newif\ifSX@wasodd
+\if@twoside
+  \newcommand*{\isSX@odd}[2]{%
+    \ifthenelse{\isodd{\pageref{\SX@IDENT}}}%
+      {\SX@wasoddtrue #1}{\SX@wasoddfalse #2}}
+\else
+  \newcommand*{\isSX@odd}[2]{#1}\SX@wasoddtrue
+\fi
+\newcounter{ltxexample}
+\newcommand*{\SX@IDENT}{SX@\number\value{ltxexample}}
+\newcommand*\SX@attachfile{%
+  \if@SX@attachfile
+    \attachfile[mimetype=text/plain,subject={example \theltxexample}]%
+      {\SX@codefile}{}%
+  \fi
+}
+\newcommand*\SX@put@t[3]{%
+  \SX@ResultArea{\linewidth}{#2}\endgraf\pagebreak[2]%
+  \setlength\@tempdima{\SX@vsep}\vskip\@tempdima
+  \SX@CodeArea{\linewidth}{#3}%
+}
+\newcommand*\SX@put@b[3]{%
+  \SX@CodeArea{\linewidth}{#3}\endgraf\pagebreak[2]%
+  \setlength\@tempdima{\SX@vsep}\vskip\@tempdima
+  \SX@ResultArea{\linewidth}{#2}%
+}
+\newcommand*\SX@put@l[3]{%
+  \setlength\@tempdimc{\linewidth-#1-\SX@hsep}%
+  \SX@ResultArea{#1}{#2}\hfill\SX@CodeArea{\@tempdimc}{#3}%
+}
+\newcommand*\SX@put@r[3]{%
+  \setlength\@tempdimc{\linewidth-#1-\SX@hsep}%
+  \SX@CodeArea{\@tempdimc}{#3}\hfill\SX@ResultArea{#1}{#2}%
+}
+\newcommand*\SX@put@o[3]{%
+  \@nameuse{SX@put@\ifSX@wasodd r\else l\fi}{#1}{#2}{#3}%
+}
+\newcommand*\SX@put@i[3]{%
+  \@nameuse{SX@put@\ifSX@wasodd l\else r\fi}{#1}{#2}{#3}%
+}
+\newcommand\SX@ResultArea[2]{%
+  \SX@justification\setlength\@tempdima{#1}%
+  %\minipage\@tempdima#2\endminipage
+  \parbox\@tempdima{#2}%
+}
+\newcommand\SX@CodeArea[2]{%
+  \setlength\@tempdima{#1}%
+  \sbox\@tempboxa{\parbox\@tempdima{#2}}%
+  \@tempdima=\dp\@tempboxa\usebox\@tempboxa
+  \rlap{\raisebox{-\@tempdima}[0pt][0pt]{\SX@attachfile}}%
+}
+\newcommand*\SX@KillAboveCaptionskip{%
+  \ifx\lst@caption\@empty\else
+    \lst@IfSubstring t\lst@captionpos
+      {\vskip-\abovecaptionskip}{}%
+  \fi
+}
+\newcommand*\SX@KillBelowCaptionskip{%
+  \ifx\lst@caption\@empty\else
+    \lst@IfSubstring b\lst@captionpos
+      {\vskip-\belowcaptionskip}{}%
+  \fi
+}
+\lstnewenvironment{LTXexample}[1][]
+{%
+  \@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}%
+}
+{%
+  \lst@EndWriteFile\egroup
+  \SX@put@code@result
+}
+\newcommand*\SX@put@code@result{%
+  \begingroup
+    \expandafter\lstset\expandafter{\SX@explpreset}%
+    \let\lst@float=\relax\let\SX@float=\relax
+    \expandafter\lstset\expandafter{\SX@@explpreset}%
+    \ifx\lst@float\relax\else
+      \let\SX@float=\lst@float\let\lst@float=\relax
+      \g@addto@macro\SX@@explpreset{,float=false}%
+      \edef\@tempa{\noexpand\lst@beginfloat{lstlisting}[\SX@float]}%
+      \expandafter\@tempa
+    \fi
+    \ifx\lst@caption\@empty
+      \lstset{nolol=true}%
+    \fi
+    \if@SX@wide\def\SX@overhang{\marginparwidth+\marginparsep}\fi
+    \trivlist\item\relax
+      \stepcounter{ltxexample}\label{\SX@IDENT}%
+      \SX@defaultWD\SX@width{\SX@width}%
+      \ifdim\SX@width<\z@
+        \@tempswatrue
+        \def\@tempa{t}%
+        \ifx\@tempa\SX@pos\@tempswafalse\fi
+        \def\@tempa{b}%
+        \ifx\@tempa\SX@pos\@tempswafalse\fi
+        \setlength\@tempdima{\linewidth+\SX@overhang}%
+        \if@tempswa\@tempdima=.5\@tempdima\fi%
+        \edef\SX@width{\the\@tempdima}%
+      \fi
+      \ifx\SX@rframe\@empty
+        \long\def\SX@frame##1{##1}%
+      \else
+        \let\SX@frame\fbox
+        \setlength\@tempdima{\SX@width-2\fboxsep-2\fboxrule}%
+        \edef\SX@width{\the\@tempdima}%
+      \fi
+      \isSX@odd{\def\@tempa{l}}{\def\@tempa{r}}%
+      \makebox[\linewidth][\@tempa]{%
+        \parbox{\linewidth+\SX@overhang}{%
+          \let\@addtofilelist\@gobble
+          \let\lst@ifdisplaystyle=\iftrue
+          \SX@KillAboveCaptionskip\lst@MakeCaption{t}%
+          \lst@belowskip=\z@
+          \let\SX@MakeCaption\lst@MakeCaption
+          \let\lst@MakeCaption\@gobble
+          \setbox\SX@ResBox\hbox{%
+            \SX@frame{%
+              \@nameuse{\if@SX@varwidth varwidth\else minipage\fi}%
+                \SX@width\relax\SX@resultInput%
+              \@nameuse{end\if@SX@varwidth varwidth\else minipage\fi}}}%
+          \edef\SX@width{\the\wd\SX@ResBox}%
+          \@ifundefined{SX@put@\SX@pos}%
+            {\@latex@error{Parameter `\SX@pos' undefined}\@ehd}%
+          {\@nameuse{SX@put@\SX@pos}%
+            {\SX@width}{\box\SX@ResBox}{\SX@codeInput}}%
+          \let\lst@MakeCaption\SX@MakeCaption
+          \lst@MakeCaption{b}\SX@KillBelowCaptionskip
+        }%
+      }%
+    \endtrivlist
+    \ifx\SX@float\relax\else\expandafter\lst@endfloat\fi
+    \gdef\SX@@explpreset{}%
+  \endgroup
+}
+\newcommand\SX@SkipToFirst{%
+  \ifeof\@inputcheck\else
+    \ifnum \lst@lineno=\lst@firstline\else
+      \read\@inputcheck to\SX@tempa
+      \typeout{IGNORE (\the\lst@lineno)}%
+      \global\advance\lst@lineno\@ne
+      \SX@SkipToFirst
+    \fi
+  \fi
+}
+\newcommand\SX@ProcessResult{%
+  \ifeof\@inputcheck\else
+    \let\SX@tempb\SX@ProcessResult
+    \ifnum \lst@lineno>\lst@lastline
+      \ifx\lst@linerange\@empty
+        \let\SX@tempb\relax
+      \else
+        \lst@GetLineInterval
+        \SX@SkipToFirst
+      \fi
+    \else
+      \read\@inputcheck to\SX@tempa
+      \typeout{READ (\the\lst@lineno)}%
+      \expandafter\g@addto@macro\expandafter\SX@lines\expandafter{\SX@tempa}%
+      \global\advance\lst@lineno\@ne
+    \fi
+    \expandafter\SX@tempb
+  \fi
+}
+\newcommand\SX@input[1]{%
+  \begingroup
+    \IfFileExists{#1}{}%
+    {%
+      \filename@parse{#1}%
+      \ifx\filename@ext\relax \def\filename@ext{tex}\fi
+      \@latexerr{File
+        `\filename@area\filename@base.\filename@ext' not found.^^J^^J}\@ehd%
+    }%
+    \openin\@inputcheck#1
+    \lsthk@PreSet\let\lst@linerange\@empty\global\lst@lineno\@ne
+    \expandafter\lstset\expandafter{\SX@@explpreset}%
+    \ifx\lst@linerange\@empty
+      \edef\lst@linerange{{\lst@firstline}-{\lst@lastline},}%
+    \fi
+    \lst@GetLineInterval
+    \SX@Info
+    \SX@SkipToFirst\let\SX@lines\@empty
+    \SX@ProcessResult
+    \closein\@inputcheck
+    \SX@lines
+  \endgroup
+}
+\newcommand*\SX@Info{%
+  \typeout{--------------------------------}%
+  \typeout{pos=\SX@pos}%
+  \typeout{width=\SX@width}%
+  \typeout{hsep=\SX@hsep}%
+  \typeout{vsep=\SX@vsep}%
+  \typeout{overhang=\SX@overhang}%
+  \typeout{rframe=\SX@rframe}%
+  \typeout{codefile=\SX@codefile}%
+  \@ifundefined{lst@firstline}{}%
+    {\typeout{\string\lst@firstline=\lst@firstline}}%
+  \@ifundefined{lst@lastline}{}%
+    {\typeout{\string\lst@lastline=\lst@lastline}}%
+  \@ifundefined{lst@linerange}{}%
+    {\typeout{\string\lst@linerange=\lst@linerange}}%
+  \typeout{\string\if@SX@wide=\if@SX@wide TRUE\else FALSE\fi}%
+  \typeout{\string\if@SX@rangeaccept=\if@SX@rangeaccept TRUE\else FALSE\fi}%
+  \typeout{\string\if@SX@varwidth=\if@SX@varwidth TRUE\else FALSE\fi}%
+  \typeout{graphicfile=\SX@graphicname, graphicparameter=[\SX@graphicparam]}%
+  \typeout{--------------------------------}%
+}
+\providecommand*\MakePercentIgnore{\catcode`\%9\relax}
+\providecommand*\MakePercentComment{\catcode`\%14\relax}
+\newcommand*\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
+    \expandafter\includegraphics\expandafter[\SX@graphicparam]%
+      {\SX@graphicname}%
+  \fi
+}
+\newcommand*\SX@codeInput{%
+  \begingroup
+  \expandafter\lstset\expandafter{\SX@explpreset}%
+    \expandafter\lstset\expandafter{\SX@@explpreset}%
+    \ifx\lst@PlaceNumber\@empty
+      \g@addto@macro\SX@@explpreset{,xleftmargin=0pt,xrightmargin=0pt}%
+    \fi
+    \SX@Info
+    \expandafter\lstinputlisting\expandafter%
+      [\SX@@explpreset,nolol=true,caption={}]{\SX@codefile}%
+  \endgroup
+}%
+\newcommand*\LTXinputExample[2][]{%
+  \g@addto@macro\SX@@explpreset{#1,codefile=#2}%
+  \SX@put@code@result}%
+\lstset{explpreset={numbers=left,numberstyle=\tiny,numbersep=.3em,
+  xleftmargin=1em,columns=flexible,language=[LaTeX]TEX},pos=l,width=-99pt,
+  overhang=0pt,hsep=\columnsep,vsep=\bigskipamount,rframe=single}
+\InputIfFileExists{showexpl.cfg}{}{}
+\endinput
+%%
+%% End of file `showexpl.sty'.
diff --git a/Master/texmf-dist/tpm/showexpl.tpm b/Master/texmf-dist/tpm/showexpl.tpm
new file mode 100644
index 00000000000..18429c0e66f
--- /dev/null
+++ b/Master/texmf-dist/tpm/showexpl.tpm
@@ -0,0 +1,32 @@
+<!DOCTYPE rdf:RDF SYSTEM "../../support/tpm.dtd">
+<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:TPM="http://texlive.dante.de/">
+  <rdf:Description about="http://texlive.dante.de/texlive/Package/showexpl.zip">
+    <TPM:Name>showexpl</TPM:Name>
+    <TPM:Type>Package</TPM:Type>
+    <TPM:Date>2006/03/26 19:25:00</TPM:Date>
+    <TPM:Version></TPM:Version>
+    <TPM:Creator>karl</TPM:Creator>
+    <TPM:Title>The showexpl package.</TPM:Title>
+    <TPM:Description></TPM:Description>
+    <TPM:Author></TPM:Author>
+    <TPM:Size>323845</TPM:Size>
+    <TPM:Build/>
+    <TPM:RunFiles size="13070">
+texmf-dist/tex/latex/showexpl/showexpl.sty
+texmf-dist/tpm/showexpl.tpm
+    </TPM:RunFiles>
+    <TPM:DocFiles size="288626">
+texmf-dist/doc/latex/showexpl/README
+texmf-dist/doc/latex/showexpl/result-picture.pdf
+texmf-dist/doc/latex/showexpl/showexpl-test.pdf
+texmf-dist/doc/latex/showexpl/showexpl-test.tex
+texmf-dist/doc/latex/showexpl/showexpl.cfg
+    </TPM:DocFiles>
+    <TPM:SourceFiles size="23328">
+texmf-dist/source/latex/showexpl/showexpl.dtx
+texmf-dist/source/latex/showexpl/showexpl.ins
+    </TPM:SourceFiles>
+    <TPM:Provides>Package/showexpl</TPM:Provides>
+  </rdf:Description>
+</rdf:RDF>
+
diff --git a/Master/texmf/lists/showexpl b/Master/texmf/lists/showexpl
new file mode 100644
index 00000000000..fd9fb30b73b
--- /dev/null
+++ b/Master/texmf/lists/showexpl
@@ -0,0 +1,11 @@
+texmf-dist/doc/latex/showexpl/README
+texmf-dist/doc/latex/showexpl/result-picture.pdf
+texmf-dist/doc/latex/showexpl/showexpl-test.pdf
+texmf-dist/doc/latex/showexpl/showexpl-test.tex
+texmf-dist/doc/latex/showexpl/showexpl.cfg
+texmf-dist/source/latex/showexpl/showexpl.dtx
+texmf-dist/source/latex/showexpl/showexpl.ins
+texmf-dist/tex/latex/showexpl/showexpl.sty
+texmf-dist/tpm/showexpl.tpm
+
+texmf/lists/showexpl
diff --git a/Master/texmf/tpm/collection-latexextra.tpm b/Master/texmf/tpm/collection-latexextra.tpm
index a246c665162..c92e4e89a42 100644
--- a/Master/texmf/tpm/collection-latexextra.tpm
+++ b/Master/texmf/tpm/collection-latexextra.tpm
@@ -413,6 +413,7 @@ A large collection of add-on packages for LaTeX.
       <TPM:Package name="shortlst"/>
       <TPM:Package name="shorttoc"/>
       <TPM:Package name="showdim"/>
+      <TPM:Package name="showexpl"/>
       <TPM:Package name="showlabels"/>
       <TPM:Package name="sidecap"/>
       <TPM:Package name="sides"/>