summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/pauldoc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-07-10 21:06:31 +0000
committerKarl Berry <karl@freefriends.org>2006-07-10 21:06:31 +0000
commit23db475f582487681ec7a5ad803a127a775cb4e8 (patch)
tree71f8a1492388fcca75fb1e01fe0f4e46ce6645d8 /Master/texmf-dist/source/latex/pauldoc
parentca34dcaa4d8d279eeba2bb2725cbc695c55e1ae0 (diff)
new package pauldoc (11apr06)
git-svn-id: svn://tug.org/texlive/trunk@1803 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/pauldoc')
-rw-r--r--Master/texmf-dist/source/latex/pauldoc/pauldoc.dtx519
-rw-r--r--Master/texmf-dist/source/latex/pauldoc/pauldoc.ins60
2 files changed, 579 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/pauldoc/pauldoc.dtx b/Master/texmf-dist/source/latex/pauldoc/pauldoc.dtx
new file mode 100644
index 00000000000..b7fb595cc47
--- /dev/null
+++ b/Master/texmf-dist/source/latex/pauldoc/pauldoc.dtx
@@ -0,0 +1,519 @@
+% \iffalse meta-comment
+%
+%% (C) 2006 Paul Ebermann
+%%
+%% Package pauldoc - Anpassungen für doc für Pauls Package-Dokus.
+%% Die Datei pauldoc.dtx sowie die dazugehörige
+%% pauldoc.ins sowie die damit generierte
+%% pauldoc.sty stehen unter der
+%% "LaTeX Project Public License" (LPPL, zu finden
+%% unter http://www.latex-project.org/lppl/, sowie
+%% auch in den meisten TeX-Distributionen in
+%% texmf/docs/latex/base/lppl*.txt), Version 1.3b oder
+%% später (nach Wahl des Verwenders).
+%%
+%% Der 'maintenance-status' ist (zur Zeit) 'author-maintained'.
+%%
+%% Das heißt u.a., die Dateien dürfen frei vertrieben werden,
+%% bei Änderungen (durch andere Personen als Paul Ebermann)
+%% ist aber der Name der Datei zu ändern.
+%%
+% \fi
+%
+% \iffalse
+%<package>\NeedsTeXFormat{LaTeX2e}[2003/12/01]
+%<package>\ProvidesPackage{pauldoc}
+%<package> [2006/04/05 v0.4a Pauls Anpassungen fuer doc (PE)]
+%
+% \changes{v0.2a}{2006/02/23}{'ue' statt 'ü' im Identifikations-String - gibt schönere
+% Ausgabe bei \cs{listfiles}.}
+%
+%<*driver>
+\nonstopmode
+\documentclass[draft,ngerman]{ltxdoc}
+\usepackage{pauldoc}
+\setlength{\IndexMin}{2\IndexMin}
+\begin{document}
+ \DocInput{pauldoc.dtx}
+\end{document}
+%</driver>
+% \fi
+%
+% \CheckSum{127}
+%
+%
+% \changes{v0.0}{2006/01/31}{Erste Fassung}
+% \changes{v0.1}{2006/02/12}{Erste veröffentlichte Fassung}
+%
+% \GetFileInfo{pauldoc.sty}
+%
+%
+% \title{Das \pack{pauldoc}-Package -- Anpassungen für \pack{doc} für Pauls Package-Dokus\thanks{%
+% Dieses Dokument gehört zu \pack{pauldoc}~\fileversion,
+% vom~\filedate.}}
+% \author{Paul Ebermann\footnote{\texttt{Paul-Ebermann@gmx.de}}}
+%
+% \maketitle
+% \begin{abstract}
+% Dieses Package enthält einige Befehle, welche
+% die Funktion von \pack{doc} an meine Wünsche
+% anpassen.
+%
+% Außerdem werden noch einige gewünschte Pakete
+% geladen sowie einige neue Befehle definiert.
+% \end{abstract}
+% \tableofcontents
+%
+% \changes{v0.4a}{2006/04/05}{Kleinere Änderungen an der Dokumentation.}
+%
+% \section{Benutzerdoku}
+%
+%
+% \subsection{Package-Optionen}
+%
+% \DescribeMacro{chapter}
+% Diese Option legt fest, dass Index und Liste der Änderungen
+% in einem eigenen Kapitel (anstatt in einem Abschnitt) beginnen.
+% Dies ist nur in einer Dokumentenklasse sinnvoll, welche
+% überhaupt '\chapter' definiert, etwa den 'book'-artigen Klassen.
+%
+% \DescribeMacro{section}
+% Legt fest, dass Index und Änderungsliste in einem Abschnitt beginnen.
+% Dies ist der Vorgabewert.
+%
+% \subsection{Neue Makros}
+%
+% \DescribeMacro{\ifReferenceExists}\marg{refName}\marg{then}\marg{else}
+%
+% Mit diesem Makro kann man, abhängig davon, ob eine bestimmte Referenz mit
+% '\label{}' gesetzt wurde, bestimmten Text ausgeben.
+%
+% Falls ein '\ref'\marg{refName} Erfolg hätte, wird \meta{then} ausgewertet,
+% ansonsten \meta{else}.
+% Dies ist nützlich, wenn man im Beschreibungsteil verschiedenen Text aufnehmen
+% will, abhängig davon, ob auch der Implementationsteil mitgesetzt wird -- man
+% kann dann etwa auf einen bestimmten Abschnitt darin verweisen, und andernfalls
+% den Text im Konjunktiv formulieren ("`Wenn der Implementationsteil mit enthalten
+% wäre, könnte man dort jetzt \dots finden."').
+%
+% \noindent\DescribeMacro{\pack}\marg{name}
+%
+% In Paketbeschreibungen werden häufiger Paketnamen (der des eigenen
+% Paketes, gelegentlich auch andere Pakete) verwendet. Wie in
+% "`How to Package Your \LaTeX{} Package"' (Scott Pakin, dtxtut.pdf),
+% Abschnitt 3.2, erläutert, setzt man Package-Namen (sofern es dafür
+% nicht ein eigenes Logo gibt) üblicherweise in '\textsf{}' (die
+% serifenlose Schrift der Klasse). Ich bevorzuge einen sprechenderen
+% Namen, daher gibt es jetzt '\pack{pauldoc}' für \pack{pauldoc}.
+%
+% \DescribeMacro{\includeLicense}
+% '\includeLicense' bindet die eventuell im \TeX-Suchpfad zu findende
+% Lizenz ein. Dies ergibt -- je nach dem, ob 'section' oder 'chapter'
+% als Option gegeben wurde -- ein neues Kapitel oder einen neuen
+% Abschnitt. Durch Neudefinition von\DescribeMacro{\lpplfilename}
+% '\lpplfilename' kann festgelegt werden, welche Datei zu verwenden
+% ist -- als Vorbgabewert ist die bei \LaTeX{} mitgelieferte Datei
+% \texttt{\lpplfilename} im Package festgelegt.
+%
+%
+% \DescribeMacro{\cmd}\DescribeMacro{\cs}
+% \DescribeMacro{\marg}\DescribeMacro{\oarg}\DescribeMacro{\parg}
+% Diese fünf Makros habe ich aus \pack{ltxdoc} kopiert, damit man sie
+% auch verwenden kann, wenn eine Doku mit einer anderen Klasse formatiert
+% wird (wie bei meiner \pack{alg-script}-Klasse). (Sie sind so formatiert,
+% dass eine andere Definition immer vorgeht.)
+%
+% '\cmd'\marg{makro} formatiert einen Makronamen. '\cmd{\bla}' ergibt
+% \cmd{\bla}. (Sollte der erste Buchstabe kein '\' sein, wird er
+% damit ersetzt: '\cmd{abc}' ergibt \cmd{abc}.)
+% '\cs'\marg{makro} tut das gleiche -- hier wird allerdings der '\' noch
+% angefügt. Falls '\cmd' mal nicht geht, geht gelegentlich noch '\cs'.
+% '\cs{bla}' ergibt \cs{bla}.
+%
+% '\marg{text}' gibt \marg{text} aus. Die Abkürzung steht für
+% "`mandatory argument"'.
+% '\oarg{text}' ergibt \oarg{text} ("`optional argument"').
+% '\parg{te,xt}' ergibt \parg{te,xt} ("`picture mode argument"').
+%
+%
+% \StopEventually{\appendix\PrintChanges\PrintIndex}
+%
+% \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 \~}
+%
+% \section{Implementation}
+%
+% \begin{macrocode}
+%<*package>
+% \end{macrocode}
+%
+% \subsection{Package-Optionen}
+%
+% \begin{macro}{chapter}
+% '\chapter' als Trenner.
+% \begin{macrocode}
+\DeclareOption{chapter}{
+ \let\pauldoc@indexsec=\chapter
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{section}
+% '\section' als Trenner.
+% \begin{macrocode}
+\DeclareOption{section}{
+ \let\pauldoc@indexsec=\section
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\pauldoc@indexsec}
+% Wir definieren noch '\pauldoc@indexsec', rufen dann
+% die Vorgabeoption 'section' auf (welche das gleich neu definiert)
+% und verarbeiten die gegebenen Optionen.
+% \begin{macrocode}
+\newcommand*{\pauldoc@indexsec}{}
+\ExecuteOptions{section}
+\ProcessOptions\relax
+% \end{macrocode}
+% \end{macro}
+%
+% \subsection{geladene Pakete}
+%
+% Wir laden das Paket \pack{inputenc} mit Option 'latin1', um
+% Sonderzeichen auch so eingeben zu können. \pack{babel} sorgt
+% für vernünftige deutsche Bezeichnungen.
+% \begin{macrocode}
+\RequirePackage[latin1]{inputenc}
+\RequirePackage[ngerman]{babel}
+% \end{macrocode}
+%
+% \changes{v0.3}{2006/03/23}{Jetzt mit \cs{usepackage}\protect\linebreak[0]'[T1]{fontenc}'}
+% \pack{fontenc} mit Option 'T1' lädt das T1-Fontencoding, in dem
+% etwa Umlaute direkt aus der Schriftart genommen werden können,
+% anstatt sie mit \"{ } und den Vokalen a, o und u zusammenzusetzen. Dies führt
+% auch zu einer verbesserten Silbentrennung.
+% \begin{macrocode}
+\RequirePackage[T1]{fontenc}
+% \end{macrocode}
+%
+% \subsection{Diverse Einstellungen}
+%
+% Wir wollen natürlich in der Doku Querverweise haben,
+% die Änderungen registrieren (für eine entsprechende Liste)
+% und im Index mit Zeilennummern arbeiten. Codestellen
+% wollen wir mit \verb|'| markieren.
+% \begin{macrocode}
+\EnableCrossrefs
+\RecordChanges
+\CodelineIndex
+\AtBeginDocument{\MakeShortVerb{\'}\selectlanguage{ngerman}}
+% \end{macrocode}
+% Außerdem sollten Index und Änderungsliste auf deutsch beschriftet werden.
+% Wie benutzen hier '\@pauldoc@indexsec', was entweder '\section'
+% oder '\chapter' ist.
+% \begin{macrocode}
+\renewcommand{\generalname}{Allgemein}
+\GlossaryPrologue{\pauldoc@indexsec{Liste der Änderungen}}
+\IndexPrologue{\pauldoc@indexsec{Index}
+
+ Schräggedruckte Nummern verweisen auf die Seite, auf der der
+ Eintrag beschrieben ist, unterstrichene Nummern zeigen auf die
+ Zeilennummer der Definition, sonstige Zahlen auf die Zeilennummer
+ einer Verwendung.}
+% \end{macrocode}
+% Der Index bekommt nur zwei Spalten (wir haben einige ziemlich lange
+% Makronamen).
+% \begin{macrocode}
+ \setcounter{IndexColumns}{2}
+% \end{macrocode}
+%
+% \subsection{Neue oder geänderte Makros}
+%
+% \subsubsection{Bedingte Anweisungen}
+% \begin{macro}{\ifReferenceExists}\marg{label}\marg{then}\marg{else}
+%
+% '\ifReferenceExists' prüft einfach, ob das Makro '\r@'\meta{label}
+% (dort wird die Referenz auf das Label gespeichert), existiert, und
+% wertet entsprechend \meta{then} oder \meta{else} aus.
+% \begin{macrocode}
+\newcommand*{\ifReferenceExists}[3]
+{%
+ \@ifundefined{r@#1}{#3}{#2}%
+}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Packagenamen}
+% \begin{macro}{\pack}
+% Um Packagenamen wie \pack{pauldoc} vernünftig
+% auszeichnen zu können, dieser Befehl.
+% \begin{macrocode}
+ \newcommand*{\pack}{\textsf}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Logos}
+%
+% \begin{macro}{\eTeX}
+% \changes{v0.4}{2006/04/02}{Neu.}
+% Aus 'etex.sty' geklaut -- das \eTeX-Logo.
+% \begin{macrocode}
+\newcommand*\eTeX{$\m@th\varepsilon$-\TeX}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Lizenz}
+%
+% \begin{macro}{\includeLicense}
+% Die Lizenz wird nur eingelesen, wenn sie auch
+% gefunden wird. Dafür wird der Dateiname,
+% welcher in '\lpplfilename' steht, eingebunden.
+% \begin{macrocode}
+ \newcommand*{\includeLicense} {
+ \IfFileExists{\lpplfilename}{%
+% \end{macrocode}
+% Zunächst stellen wir die Sprache um (aber nur Silbentrennung etc.,
+% keine Namen), mit dem passenden \pack{babel}-Befehl.
+% \begin{macrocode}
+ \begin{otherlanguage*}{english}
+% \end{macrocode}
+% \changes{v0.2}{2006/02/14}{Verwendung einer neuen Version der
+% LPPL macht Workarounds unnötig.}
+% Um die Lizenz als '\chapter' einzubinden und dann Referenzen
+% darauf im Text verwenden zu können, waren mit der \LaTeX-Version
+% vom 13. Januar 2006 einige Verrenkungen notwendig -- siehe unten.
+%
+% Am 10. Februar habe ich einen Vorschlag zur Verbesserung
+% an die LaTeX-Bug-Liste geschickt, das wurde positiv aufgenommen.
+% \footnote{Siehe \texttt{http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/3839}.}
+% Ich habe jetzt von eine verbesserte Version von Frank Mittelbach bekommen,
+% die hoffentlich demnächst auch veröffentlicht wird.
+%
+% Wir wollen die Abschnitte der Lizenz auch nummeriert
+% (und im Inhaltsverzeichnis) haben, deswegen die Versionen
+% ohne '*'. Falls 'chapter'
+% als Package-Option angegeben wurde, schieben wir außerdem
+% alles eine Ebene höher.
+% \begin{macrocode}
+\ifx\pauldoc@indexsec\chapter
+ \providecommand*{\LPPLsection}{\chapter}
+ \providecommand*{\LPPLsubsection}{\section}
+ \providecommand*{\LPPLsubsubsection}{\subsection}
+ \providecommand*{\LPPLparagraph}{\subsubsection}
+\else
+ \providecommand*{\LPPLsection}{\section}
+ \providecommand*{\LPPLsubsection}{\subsection}
+ \providecommand*{\LPPLsubsubsection}{\subsubsection}
+ \providecommand*{\LPPLparagraph}{\paragraph}
+\fi
+% \end{macrocode}
+%
+% Der folgende (auskommentierte) Code sowie die eingerückte
+% Dokumentation dazu ist mit der neuen
+% Version der Lizenz-Datei nicht mehr notwendig -- ich lasse
+% ihn mal trotzdem hier drin, zu Dokumentationszwecken.
+% \begin{quotation}\slshape
+% Die Lizenz-Datei (zumindest die mir vorliegende
+% Version) verwendet Unterteilungen ab '\section' --
+% falls in unserer Dokumentation '\chapter' verwendet
+% werden soll (d.h. die entsprechende Option gegeben
+% wurde), stellen wir einen Kapitelbeginn davor.
+%\begin{verbatim}
+% \ifx\pauldoc@indexsec\chapter
+% \chapter{Lizenz}%
+% \fi
+%\end{verbatim}
+% \begin{macro}{\section*}
+% \begin{macro}{\lizenz@oldsection@}
+% Damit wir aus dem Dokument auf die Lizenz referieren
+% können, definieren wir den Befehl '\section', welcher
+% zu Beginn der Lizenz verwendet wird, so um, dass er
+% ein Label setzt. (Weil wir uns in einer Gruppe
+% befinden (durch die 'otherlanguage'-Umgebung), bleibt
+% die Änderung lokal.)
+%\begin{verbatim}
+% \newcommand{\lizenz@oldsection@}{}%
+% \let\lizenz@oldsection@\section\relax%
+% \def\section*{%
+% \label{lppl-chapter}%
+% \lizenz@oldsection@*%{##1}%
+% }%
+%\end{verbatim}
+% \end{macro}
+% \end{macro}
+% \begin{macro}{\emph}
+% Leider habe ich es nicht wirklich geschafft, den Befehl
+% so umzudefinieren, dass nach dem '\section*{}'-Befehl noch
+% ein Label kommt -- deswegen definiere ich stattdessen den
+% '\emph{}'-Befehl um, der zumindest in meiner Ausgabe der
+% LPPL direkt nach dem '\section*' kommt. Ein böser Hack,
+% ich weiß \dots
+%\begin{verbatim}
+% \newcommand{\lizenz@oldemph}{}%
+% \let\lizenz@oldemph\emph%
+% \def\emph{%
+% \label{lppl-section}%
+% \let\emph\lizenz@oldemph%
+% \emph%
+% }%
+%\end{verbatim}
+% \end{macro}
+% \end{quotation}
+% Einige Änderungen sind notwendig, um
+% die Lizenz einzulesen: '%' soll wieder
+% ein Kommentarzeichen sein, \verb|'| darf kein
+% Verbatim-Zeichen mehr sein, weil diese Zeichen
+% in der Lizenz-Datei natürlich nicht den
+% Doc-Konventionen entsprechend verwendet werden.
+% Dann lesen wir die Datei ein, und machen danach die Änderungen
+% wieder rückgängig.
+% \begin{macrocode}
+ \DeleteShortVerb{\'}%
+ \MakePercentComment\input{\lpplfilename}\MakePercentIgnore%
+ \MakeShortVerb{\'}%
+% \end{macrocode}
+% ... und jetzt setzen wir die Sprache wieder zurück.
+% \begin{macrocode}
+ \end{otherlanguage*}
+% \end{macrocode}
+% Falls die Lizenz-Datei nicht gefunden wurde, geben wir nur eine passende Meldung aus.
+% \begin{macrocode}
+ }{%
+ \typeout{^^J%
+ ^^J%
+ Die Datei \lpplfilename{} wurde nicht gefunden.^^J%
+ Schade, da wird die Lizenz eben nicht eingebunden.^^J%
+ ^^J%
+ }%
+ }%
+ }
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\lpplfilename}
+% \changes{v0.2}{2006/02/14}{Dateiname von
+% 'lppl-1-3b.tex' nach 'lppl.tex' geändert.}
+% Ich definiere noch den Dateinamen der Lizenz, unter
+% der die meisten meiner Pakete stehen, zur Zeit ist
+% das die unter dem Namen \texttt{\lpplfilename}
+% verbreitete LPPL.
+% \begin{macrocode}
+\AtBeginDocument{
+ \providecommand{\lpplfilename}{lppl.tex}
+}
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \subsubsection{Kopiert aus \pack{ltxdoc}}
+%
+% \changes{v0.1}{2006/02/04}{\cs{cs}, \cs{cmd}, \cs{marg}, \cs{oarg}, \cs{parg}
+% hinzugefügt aus
+% \pack{latxdoc}.}
+% Die folgenden vier Kommandos kopierte ich aus \pack{ltxdoc},
+% um sie auch verwenden zu können, wenn ich nicht diese Klasse
+% verwende. Durch die Verwendung von '\providecommand' gibt es
+% keine Konflikte, falls sie doch schon definiert sind.
+%
+% \begin{macro}{\cmd}
+% Formatiert einen Makronamen, '\cmd{\bla}' ergibt \cmd{\bla}.
+% (Sollte der erste Buchstabe kein '\' sein, wird er damit ersetzt.)
+% \begin{macrocode}
+\@ifundefined{cs}
+{%
+ \providecommand*{\cmd}[1]{\cs{\expandafter\cmd@to@cs\string#1}}
+ \def\cmd@to@cs#1#2{\char\number`#2\relax}
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\cs}
+% Implementiert wurde '\cmd' mit '\cs' -- '\cs{bla}' ergibt \cs{bla}.
+% Dies funktioniert auch an einigen Stellen, wo '\cmd{\bla}' nicht
+% funktioniert.\footnote{Das steht jedenfalls in der \pack{ltxdoc}-Doku,
+% auch wenn ich das nicht ganz verstanden habe.}
+% \begin{macrocode}
+ \DeclareRobustCommand*\cs[1]{\texttt{\char`\\#1}}%
+}
+{}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\marg}
+% |\marg{text}| gibt \marg{text} aus. Die Abkürzung steht für
+% "`mandatory argument"'.
+% \begin{macrocode}
+\providecommand\marg[1]{%
+ {\ttfamily\char`\{}\meta{#1}{\ttfamily\char`\}}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\oarg}
+% |\oarg{text}| ergibt \oarg{text} ("`optional argument"').
+% \begin{macrocode}
+\providecommand\oarg[1]{%
+ {\ttfamily[}\meta{#1}{\ttfamily]}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\parg}
+% |\parg{te,xt}| ergibt \parg{te,xt} ("`picture mode argument"').
+% \begin{macrocode}
+\providecommand\parg[1]{%
+ {\ttfamily(}\meta{#1}{\ttfamily)}}
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Bugfixes}
+% Inzwischen\footnote{mit dem \LaTeX-Beta-Release vom 3.Februar 2006 -- \pack{doc} hat das Datum 2006/02/02} ist der folgende Bug korrigiert, daher hier auskommentiert.
+% \begin{quote}
+% \begin{macro}{\SpecialEnvIndex}\slshape
+% \changes{v0.1}{2006/02/04}{Bugfix ist überflüssig}
+% Aufgrund eines Bugs in \pack{doc}\footnote{Siehe
+% \texttt{http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=tools/3834} --
+% das ist (laut einer E-Mail, die ich als Antwort auf meinen Bug-Report
+% (am 2006/01/30) bekam) schon bekannt und im Code korrigiert, ein
+% Release steht bevor.} definiere ich hier
+% '\SpecialEnvIndex' neu, damit die environment-Verwendungen
+% genauso wie die environment-Definitionen einsortiert werden,
+% nicht als eigener Eintrag namens "`environments:\meta{name}"'.
+%\begin{verbatim}
+%\renewcommand*{\SpecialEnvIndex}[1]{\@bsphack
+% \index{#1\actualchar{\protect\ttfamily#1}
+% (environment)\encapchar usage}%
+% \index{environments:\levelchar#1\actualchar{%
+% \protect\ttfamily#1}\encapchar
+% usage}\@esphack}
+%\end{verbatim}
+% \end{macro}
+% \end{quote}
+%
+% \subsection{Ende}
+% \ldots und Schluss.
+% \begin{macrocode}
+\endinput
+%</package>
+% \end{macrocode}
+%
+% \Finale
+%\endinput
+
+
+%%% Folgendes ist nur für meinen Editor.
+%%%
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: t
+%%% End:
diff --git a/Master/texmf-dist/source/latex/pauldoc/pauldoc.ins b/Master/texmf-dist/source/latex/pauldoc/pauldoc.ins
new file mode 100644
index 00000000000..acc03d261bb
--- /dev/null
+++ b/Master/texmf-dist/source/latex/pauldoc/pauldoc.ins
@@ -0,0 +1,60 @@
+%%
+%% (C) 2002-2006 Paul Ebermann - Installationsdatei zu pauldoc.dtx
+%%
+%% Der vollständige Urheberrechtshinweis befindet sich
+%% am Begin von pauldoc.dtx.
+%%
+%% Ich gebe keine Garantie irgendeiner Art.
+%%
+
+\input docstrip.tex
+\usedir{tex/latex/paul}
+
+\Msg{**********************************************************}
+\Msg{* Ich werde Dateien in \showdirectory{tex/latex/paul} }
+\Msg{* installieren. Bitte stellen Sie sicher, }
+\Msg{* dass dieses Verzeichnis vorhanden ist. }
+\Msg{* }
+
+%% der folgende Text wird in jeder generierten
+%% Datei am Anfang eingefügt.
+\preamble
+
+ ,--------------------------------------------------.
+ | Das ist eine generierte Datei. |
+ | |
+ | (c) 2005-2006 Paul Ebermann. |
+ '--------------------------------------------------'
+
+\endpreamble
+
+
+\generate{\file{pauldoc.sty}{\from{pauldoc.dtx}{package}}}
+
+\Msg{#######################}
+\Msg{# }
+\Msg{# Um die Installation zu beenden, }
+\Msg{# müssen Sie die folgenden Dateien }
+\Msg{# in Ihrem TeX-Suchbaum unterbringen: }
+\Msg{# }
+\Msg{# pauldoc.sty }
+\Msg{# }
+\Msg{# Um eine Dokumentation zu erzeugen, }
+\Msg{# benutzen Sie }
+\Msg{# }
+\Msg{# latex pauldoc.sty }
+\Msg{# }
+\Msg{# Viel Spaß }
+\Msg{# Paul Ebermann }
+\Msg{# }
+\Msg{#######################}
+
+\endbatchfile
+
+
+%%% Folgendes ist nur für meinen Editor.
+%%%
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: t
+%%% End: