summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/showexpl
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/showexpl
Initial commit
Diffstat (limited to 'macros/latex/contrib/showexpl')
-rw-r--r--macros/latex/contrib/showexpl/README16
-rw-r--r--macros/latex/contrib/showexpl/doc/result-picture.pdfbin0 -> 19256 bytes
-rw-r--r--macros/latex/contrib/showexpl/doc/showexpl-test.pdfbin0 -> 332458 bytes
-rw-r--r--macros/latex/contrib/showexpl/doc/showexpl-test.tex290
-rw-r--r--macros/latex/contrib/showexpl/doc/showexpl.pdfbin0 -> 243219 bytes
-rw-r--r--macros/latex/contrib/showexpl/showexpl.dtx764
-rw-r--r--macros/latex/contrib/showexpl/showexpl.ins57
7 files changed, 1127 insertions, 0 deletions
diff --git a/macros/latex/contrib/showexpl/README b/macros/latex/contrib/showexpl/README
new file mode 100644
index 0000000000..f16e1bc655
--- /dev/null
+++ b/macros/latex/contrib/showexpl/README
@@ -0,0 +1,16 @@
+showexpl
+========
+
+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.
+
+Recommended TDS locations:
+
+ showexpl.sty: tex/latex/showexpl
+ README, showexpl.pdf, showexpl-test.pdf,
+ showexpl-test.tex, result-picture.pdf: doc/latex/showexpl
+
+For general installation advice, see
+http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages
+
diff --git a/macros/latex/contrib/showexpl/doc/result-picture.pdf b/macros/latex/contrib/showexpl/doc/result-picture.pdf
new file mode 100644
index 0000000000..6b17a10fd6
--- /dev/null
+++ b/macros/latex/contrib/showexpl/doc/result-picture.pdf
Binary files differ
diff --git a/macros/latex/contrib/showexpl/doc/showexpl-test.pdf b/macros/latex/contrib/showexpl/doc/showexpl-test.pdf
new file mode 100644
index 0000000000..ed08ca09e9
--- /dev/null
+++ b/macros/latex/contrib/showexpl/doc/showexpl-test.pdf
Binary files differ
diff --git a/macros/latex/contrib/showexpl/doc/showexpl-test.tex b/macros/latex/contrib/showexpl/doc/showexpl-test.tex
new file mode 100644
index 0000000000..316049f555
--- /dev/null
+++ b/macros/latex/contrib/showexpl/doc/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/macros/latex/contrib/showexpl/doc/showexpl.pdf b/macros/latex/contrib/showexpl/doc/showexpl.pdf
new file mode 100644
index 0000000000..31c82aad6d
--- /dev/null
+++ b/macros/latex/contrib/showexpl/doc/showexpl.pdf
Binary files differ
diff --git a/macros/latex/contrib/showexpl/showexpl.dtx b/macros/latex/contrib/showexpl/showexpl.dtx
new file mode 100644
index 0000000000..a7c3c96677
--- /dev/null
+++ b/macros/latex/contrib/showexpl/showexpl.dtx
@@ -0,0 +1,764 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2004 -- 2016 by Rolf Niepraschk <Rolf.Niepraschk@gmx.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>
+ [2016/12/11 v0.3o Typesetting example code (RN)]
+%</package>
+%
+%<*driver>
+\documentclass[a4paper]{ltxdoc}
+\usepackage{showexpl}
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+\begin{document}
+ \DocInput{showexpl.dtx}
+ \PrintChanges
+ \PrintIndex
+\end{document}
+%</driver>
+% \fi
+%
+% \CheckSum{887}
+%
+% \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 (\texttt{Rolf.Niepraschk@gmx.de})}
+% \date{\filedate}
+%
+% \maketitle
+%
+% \section{Introduction}
+%
+% The documentation of a \LaTeX{} package is by far more readable if there
+% are examples of the commands' and environments' usage. The best way to do
+% that is to give a comparison of the \LaTeX{} code and the formatted
+% output. \textsf{showexpl} is a package for doing that comparison, it is
+% based on the package \textsf{listings} which provides a good typesetted
+% source code with emphasised keywords and so on.
+%
+% \section{Usage}
+%
+% You can use \textsf{showexpl} like every other package by putting the
+% line
+% \begin{verbatim}
+% \usepackage{showexpl}
+% \end{verbatim}
+% \vspace{-\baselineskip}
+% in your source code. \textsf{showexpl} doesn't know any options by
+% itself, but all options for the underlying packages
+% (\textsf{listings} and \textsf{graphicx}) will be passed to the
+% respective packages.
+%
+% \textsf{showexpl} provides one command and one environment:
+% \begin{itemize}
+% \item |\LTXinputExample| and
+% \item \textsf{LTXexample}
+% \end{itemize}
+%
+% \DescribeMacro{\LTXinputExample}
+% The syntax of |\LTXinputExample| is given by
+% \begin{quote}
+% |\LTXinputExample[|\meta{key val list}|]{|\meta{file}|}|
+% \end{quote}
+%
+% \DescribeEnv{LTXexample}
+% The syntax of the environment \textsf{LTXexample} is given by
+% \begin{quote}
+% |\begin{LTXexample}[|\meta{key val list}|]|\ldots|\end{LTXexample}|
+% \end{quote}
+%
+% The set of options represented by \meta{key val list} is the same for
+% both the command and the environment, the options are described in the
+% following:
+% \begin{description}
+% \item[attachfile] Boolean valued key, default value: false. If set to
+% true the sourcecode will be attached to the \textsf{.pdf}
+% file---presumed that the document is processed by |pdflatex|.
+% \item[codefile] Name of the (temporary) file that contains the code
+% which will be formatted as source code. The default value is |\jobname.tmp|.
+% \item[explpreset] A \meta{key val list} which serves for presetting the
+% properties of the formatting of the source code, for values see the
+% documentation of the \textsf{listings} package. The default value is
+%
+% \item[graphic] Name of a (graphic) file. This file---if present---will
+% be included and displayed instead of the formatted code. The default value is empty.
+% \item[hsep] Defines the horizontal distance between the source code and the
+% formatted text.
+% \item[justification] Defines the justification of the formatted text:
+% reasonable values are |\raggedleft|, |\raggedright|, |\centering|. The
+% default value is |\raggedright|.
+% \item[overhang] A \textit{dimen}-value that defines the amount by which
+% the formatted text and the source code can overlap the print space. The
+% default value is 0\,pt.
+% \item[pos:] Defines the relative position of the formatted text
+% relating to the source code. Allowed values are |t|, |b|, |l|, |r|,
+% |o|, and |i| for top, bottom, left, right, outer, and inner. The last
+% values give sense only for two-sided printing, where there are outer
+% and inner margins of a page. The default value is |l|.
+% \item[preset] Any \TeX\ code executed before the sample code but
+% not visible in the listings area.
+% \item[rangeaccept] Boolean valued key, default value is false. If set
+% to true, one can define ranges of lines that will be excerpted from
+% the source code.
+% \item[rframe] Defines the form of the frame around the formatted
+% text. With a non-empty value (e.\,g. ``single'') a simple frame
+% will be drawn. In the future more kinds of frames will be supported.
+% The default value is empty (no frame).
+% \item[varwidth] Boolean valued key, default value is false. If set to
+% true, the formatted text is set with its ``natural'' width instead of a
+% fixed width as given by the value of the option |width|.
+% \item[vsep] Defines the vertical distance between the source code and the
+% formatted text.
+% \item[wide] Boolean valued key, default value is false. If set to
+% true, the source code and the formatted text overlap the print space
+% and the margin area.
+% \item[width] A \meta{dimen} value that defines the width of the
+% formatted text. The default value depends of the relative positions of
+% the source code and the formatted text.
+% \item[scaled] Without a value the formatted text will be scaled to fit
+% the given width of the result area. With a number as value the formatted
+% text will be scaled by this number.
+% \end{description}
+% In addition to these options the kind of the result box (default: |\fbox|)
+% can be changed. For example:
+% \begin{verbatim}
+% \renewcommand\ResultBox{\fcolorbox{green}{lightgray}}
+% \setlength\ResultBoxSep{5mm}% default: \fboxsep
+% \setlength\ResultBoxRule{2mm}% default: \fboxrule
+% \end{verbatim}
+%
+% \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}%
+}%
+% \end{macrocode}
+% \changes{v0.3h}{2007/02/03}{New Option `attachfiles' (RN).}
+% \begin{macrocode}
+\DeclareOption{attachfiles}{%
+ \AtBeginDocument{\IfFileExists{attachfile.sty}%
+ {\RequirePackage{attachfile}}{\def\SX@attachfile{}}}
+}%
+\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{listings}}
+\ProcessOptions\relax
+\RequirePackage{listings,calc,ifthen,graphicx,varwidth}
+% \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}}
+\newcommand*\SX@scaled{}
+\lst@Key{scaled}{?}[!]{\def\SX@scaled{#1}}
+% \end{macrocode}
+% \changes{v0.1h}{2005/06/03}{``lstpreset'' renamed to ``explpreset''
+% (RN).}
+% \changes{v0.3l}{2014/01/19}{Option ``scaled'' and \cmd{\SX@scaled}
+% added (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).}
+% \changes{v0.3n}{2016/11/20}{Define \cmd{\ResultBox} etc.}
+% \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\ResultBox{} \let\ResultBox=\fbox
+\newdimen\ResultBoxSep \ResultBoxSep=\fboxsep
+\newdimen\ResultBoxRule \ResultBoxRule=\fboxrule
+\newcommand*\SX@pos{}
+\newcommand*\SX@width{}
+\newcommand*\SX@hsep{}
+\newcommand*\SX@vsep{}
+\newcommand*\SX@overhang{}
+\newcommand*\SX@rframe{}
+\newcommand\SX@preset{}
+\newcommand*\SX@explpreset{}
+% \end{macrocode}
+% \changes{v0.3g}{2006/09/05}{Missing \cmd{\newcommand} for
+% \cmd{\SX@@explpreset} added (RN).}
+% \begin{macrocode}
+\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=...|''.
+% \changes{v0.3e}{2006/04/05}{More redefinitions added (RN).}
+% \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
+ \let\pagestyle\@gobble \let\thispagestyle\@gobble
+ %%\let\immediate\relax \let\write\@gobbletwo
+ %%\let\closeout\@gobble \let\@@input\@gobble
+ \renewcommand\marginpar[2][]{}%
+ \renewcommand\footnote[2][]{}%
+ \let\@footnotetext\@gobble
+ %%\abovedisplayskip=\z@
+ %%\abovedisplayshortskip=\z@
+}
+\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}
+%
+% \changes{v0.1h}{2005/06/03}{Renamed from ``example'' to ``LTXexample' (RN).}
+% \changes{v0.3n}{2016/11/20}{Prevent utf8 encoding errors}
+% \begin{environment}{LTXexample}
+% \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
+ \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{macro}{\SX@put@code@result}
+% \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.
+% \changes{v0.3n}{2016/11/20}{Use \cmd{\ResultBox}}
+% \begin{macrocode}
+ \ifx\SX@rframe\@empty
+ \long\def\SX@frame##1{##1}%
+ \else
+ \let\SX@frame\ResultBox
+ \setlength\@tempdima{\SX@width-2\ResultBoxSep-2\ResultBoxRule}%
+ \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.
+% \changes{v0.3m}{2016/08/05}{Wrong assignement for \cmd{\lst@belowskip} (RN).}
+% \begin{macrocode}
+ \let\@addtofilelist\@gobble
+ \let\lst@ifdisplaystyle=\iftrue
+ \SX@KillAboveCaptionskip\lst@MakeCaption{t}%
+% \end{macrocode}
+% Use the ``natural'' width of the result code if ``varwidth'' is
+% true.
+% \changes{v0.3k}{2013/03/21}{Setting \cmd{\lst@MakeCaption} to \cmd{\@gobble}
+% again (prevent multiply defined labels; label key)}.
+% \begin{macrocode}
+ \let\SX@MakeCaption\lst@MakeCaption
+ \let\lst@MakeCaption\@gobble{}
+% \end{macrocode}
+% \changes{v0.3j}{2012/09/22}{Setting \cmd{\lst@MakeCaption} to
+% was a bad idea for hyperlinks. Group added to
+% varwidth environment. (Suggestions by Ulrike Fischer.).}
+% \begin{macrocode}
+ \setbox\SX@ResBox\hbox{%
+ \fboxsep=\ResultBoxSep
+ \fboxrule=\ResultBoxRule
+ \SX@frame{%
+ \@nameuse{\if@SX@varwidth varwidth\else minipage\fi}%
+ \SX@width\relax
+ \begingroup
+ \SX@resultInput
+ \endgroup
+ \@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
+}
+% \end{macrocode}
+% \end{macro}
+% \changes{v0.3g}{2006/09/05}{\cmd{\SX@ProcessResult} is now working
+% correctly
+% using \cmd{\readline} and \cmd{\scantokens}. Thanks to Ulrich Diez
+% for help (RN).}
+% \begin{macrocode}
+\newcommand\SX@SkipToFirst{%
+ \ifeof\@inputcheck\else
+ \ifnum \lst@lineno=\lst@firstline\else
+ \readline\@inputcheck to\SX@tempa
+ \typeout{IGNORE (\the\lst@lineno)}%
+ \global\advance\lst@lineno\@ne
+ \SX@SkipToFirst
+ \fi
+ \fi
+}
+\newcommand\SX@ProcessResult{%
+ \ifeof\@inputcheck
+ \let\SX@tempb\relax
+ \else
+ \let\SX@tempb\SX@ProcessResult
+ \ifnum \lst@lineno>\lst@lastline\relax
+ \ifx\lst@linerange\@empty
+ \let\SX@tempb\relax
+ \else
+ \lst@GetLineInterval
+ \SX@SkipToFirst
+ \fi
+ \else
+ \readline\@inputcheck to\SX@tempa
+ \typeout{READ (\the\lst@lineno)}%
+ \expandafter\g@addto@macro
+ \expandafter\SX@lines\expandafter{\SX@tempa^^J}%
+ \global\advance\lst@lineno\@ne
+ \fi
+ \fi
+ \SX@tempb
+}
+% \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
+ \newlinechar=`\^^J\relax
+ \SX@SkipToFirst\let\SX@lines\@empty
+ \SX@ProcessResult
+ \closein\@inputcheck
+ \scantokens\expandafter{\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).}
+% \changes{v0.3l}{2014/01/19}{Code for ``scaled'' option (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
+ \if\SX@scaled ?%
+ \let\SX@tempb=\@firstofone
+ \else
+ \if\SX@scaled !%
+ \def\SX@tempb##1{\resizebox{\SX@width}{!}{##1}}%
+ \else
+ \def\SX@tempb##1{\scalebox{\SX@scaled}{##1}}%
+ \fi
+ \fi
+ \SX@tempb{\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={},belowskip=\z@,aboveskip=\z@]{\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.3k}{2013/03/21}{Definition for ``hyperref''
+% (suggested by Heiko Oberdiek)}.
+% \begin{macrocode}
+\AtBeginDocument{%
+ \def\theHlstnumber{\thelstlisting.\arabic{lstnumber}.\lst@neglisting}%
+}
+% \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/macros/latex/contrib/showexpl/showexpl.ins b/macros/latex/contrib/showexpl/showexpl.ins
new file mode 100644
index 0000000000..98548e0467
--- /dev/null
+++ b/macros/latex/contrib/showexpl/showexpl.ins
@@ -0,0 +1,57 @@
+%%
+%% Copyright (C) 2004 by Rolf Niepraschk <Rolf.Niepraschk@gmx.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@gmx.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