summaryrefslogtreecommitdiff
path: root/Master
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
parentca34dcaa4d8d279eeba2bb2725cbc695c55e1ae0 (diff)
new package pauldoc (11apr06)
git-svn-id: svn://tug.org/texlive/trunk@1803 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/latex/pauldoc/README169
-rw-r--r--Master/texmf-dist/doc/latex/pauldoc/pauldoc.pdfbin0 -> 153121 bytes
-rw-r--r--Master/texmf-dist/source/latex/pauldoc/pauldoc.dtx519
-rw-r--r--Master/texmf-dist/source/latex/pauldoc/pauldoc.ins60
-rw-r--r--Master/texmf-dist/tex/latex/pauldoc/pauldoc.sty112
-rw-r--r--Master/texmf-dist/tpm/pauldoc.tpm29
-rw-r--r--Master/texmf/lists/pauldoc8
-rw-r--r--Master/texmf/tpm/collection-latexextra.tpm1
8 files changed, 898 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/pauldoc/README b/Master/texmf-dist/doc/latex/pauldoc/README
new file mode 100644
index 00000000000..6c7fc4606bd
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pauldoc/README
@@ -0,0 +1,169 @@
+[en]
+LaTeX-package 'pauldoc' - some macros to facilate the creation of
+LaTeX package documentation in german language.
+
+Author: Paul Ebermann <Paul-Ebermann@gmx.de>
+License: LPPL 1.3b or later, author-maintained
+ (see http://www.latex-project.org/lppl/).
+
+All Documentation (other than this file) is in german.
+
+The package comes as .dtx + .ins.
+Run "latex pauldoc.ins" to create the style file (and maybe put
+it to texmf/tex/latex/paul/, if your docstrip is configured
+accordingly), run (after that and maybe updating your TeX hash)
+"latex pauldoc.dtx" to create the documentation.
+
+
+ Usage
+-------
+This package is used to create the documentation of the
+other packages from Paul Ebermann - so most times you
+won't need to use it directly.
+(And it is only of use for creating german language
+ package documentation, so preferably read the german
+ language documentation in pauldoc.pdf.)
+
+Use the package in your own .dtx-file in
+a the doc-driver-section:
+
+%<*driver>
+\nonstopmode
+\documentclass[draft,ngerman]{ltxdoc}
+\usepackage{pauldoc}
+\usepackage{myPackage}
+\begin{document}
+ \DocInput{myPackage.dtx}
+\end{document}
+%</driver>
+
+In the documentation you then can use some
+additional commands:
+
+ \pack{} - typesets package names.
+ \includeLicense - includes \lpplfilename (by
+ default 'lppl.tex') in the documentation,
+ if the file exists.
+ The catcodes are changed before and after
+ so there should be no problems.
+
+ \IfReferenceExists{refName}{yes}{no} - execute
+ some LaTeX code conditionally, dependent
+ of whether some label was defined (in
+ the previous LaTeX run), so a \ref or
+ \pageref would succeed.
+ Useful for references to the implementation
+ section or the licence, which may or may not
+ be included.
+
+ \cmd, \cs, \marg, \oarg, \parg - copied from ltxdoc,
+ so they can also be used if doc (and pauldoc)
+ are used with another document class.
+
+Additionally, 'pauldoc' loads babel with [ngerman],
+fontenc with [T1], inputenc with [latin1], defines
+"'" as verbatim character, enables indexing by
+codelines, recording of changes, and cross referencing.
+The change list title and the index prologue are
+translated to german, the index is typeset in two
+columns (instead of three).
+
+----------------
+[de]
+LaTeX-Paket 'pauldoc' - Einige Makros, um LaTeX-Pakete
+besser (auf deutsch) dokumentieren zu können.
+
+Autor: Paul Ebermann (Paul-Ebermann@gmx.de).
+Lizenz: LPPL 1.3b oder später, mit Maintenance-Status
+ "author-maintained". Siehe http://www.latex-project.org/lppl/.
+
+Geschrieben für den eigenen Gebrauch
+(d.h. die Dokumentation der LaTeX-Pakete von
+ Paul Ebermann), aber vielleicht ist es auch
+für andere von Nutzen.
+
+Das Paket kommt als .dtx + .ins.
+Mit "latex pauldoc.ins" wird die .sty-Datei erstellt (und
+eventuell gleich nach texmf/tex/latex/paul/ installiert,
+wenn docstrip entsprechend eingerichtet ist), mit
+"latex pauldoc.dtx" kann (danach und eventuell nach einer
+Aktualisierung der TeX-Dateidatenbank) die Dokumentation neu
+erstellt werden.
+
+Zur Verwendung siehe pauldoc.pdf.
+----------------
+[eo-h]
+LaTeX-pakajho 'pauldoc' - Kelkaj iloj por helpi la
+dokumentadon de LaTeX-pakajhoj en la germana lingvo.
+
+Autoro: Paulo Ebermann (Paul-Ebermann@gmx.de).
+Licenzo: LPPL 1.3, 'author-maintained'
+ (-> http://www.latex-project.org/lppl/).
+
+Kreitaj por propra uzo, sed eble iom de ghi ankau
+uzeblas por aliaj.
+
+La dokumentaro (escepte tiu chi dosiero) estas nur en la germana
+lingvo.
+
+La pakajho venas en .dtx + .ins.
+Voku "latex pauldoc.ins" por krei la .sty-dosieron (kaj
+eble meti ghin al texmf/tex/latex/paul/, se via docstrip estis
+konfigurita laue), voku "latex pauldoc.dtx" por rekrei
+la dokumentaron.
+
+ Uzado
+-------
+La pakajho estas uzata por krei la dokumentajhon por
+la aliaj pakajhoj de Paul Ebermann, do kutime vi ne
+devos uzi ghin rekte.
+(Kaj ghi nur taugas por dokumenti germanlingve
+ LaTeX-pakajhojn, do prefere vi legu la germanlingvan
+ dokumentajhon en pauldoc.pdf.)
+
+
+Uzu la pakajhon en via propra .dtx-dosiero en
+la sekcio, kiu enhavas la dokumentajh-kreilon:
+
+%<*driver>
+\nonstopmode
+\documentclass[draft,ngerman]{ltxdoc}
+\usepackage{pauldoc}
+\usepackage{miaPakajho}
+\begin{document}
+ \DocInput{miaPakajho.dtx}
+\end{document}
+%</driver>
+
+En la dokumentajho vi nun povas uzu kelkajn
+aldonajn komandojn:
+
+ \pack{} - belprintas pakajhnomojn.
+ \includeLicense - enmetas la dosieron \lpplfilename
+ (kutime 'lppl.tex') en la dokumentajon,
+ se la dosiero ekzistas.
+ La kategoriaj kodoj estas shanghitaj antaue
+ kaj poste, por eviti problemojn.
+
+ \IfReferenceExists{refNomo}{jes}{ne} - kondicha uzo
+ de iu teksto, depende chu iu 'label' estis
+ difinita (en la antaua voko de LaTeX), do
+ chu nun uzo de \ref{refNomo} kaj \pageref{refNomo}
+ estus sukcesaj.
+ Tio estas tauga por referencoj al la implementa
+ parto au al la licenco, kiuj povus au ne povus
+ enesti la dokumenton.
+
+ \cmd, \cs, \marg, \oarg, \parg - tiuj komandoj estas
+ simple kopiitaj el ltxdoc, por ke oni povu
+ uzi ilin ankau kun alia dokumentklaso kaj
+ 'doc' (kaj pauldoc').
+
+Aldone, pauldoc vokas 'babel' kun opcio [ngerman],
+'fontenc' kun [T1], 'inputenc' kun [latin1].
+Ghi difinas "'" kiel "verbatim"-shaltilo, enshaltas
+linnumerojn, indeksadon lau tiuj, kolektadon de
+shanghlisto kaj krucreferencadon.
+Ghi tradukas la titolon de la shanghlisto kaj la
+prologon de la indekso al la germana. Krome la
+indekso uzas nur du kolumnojn (anstatau tri).
diff --git a/Master/texmf-dist/doc/latex/pauldoc/pauldoc.pdf b/Master/texmf-dist/doc/latex/pauldoc/pauldoc.pdf
new file mode 100644
index 00000000000..dbf8ca30b50
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pauldoc/pauldoc.pdf
Binary files differ
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:
diff --git a/Master/texmf-dist/tex/latex/pauldoc/pauldoc.sty b/Master/texmf-dist/tex/latex/pauldoc/pauldoc.sty
new file mode 100644
index 00000000000..4524e726b43
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/pauldoc/pauldoc.sty
@@ -0,0 +1,112 @@
+%%
+%% This is file `pauldoc.sty',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% pauldoc.dtx (with options: `package')
+%%
+%% ,--------------------------------------------------.
+%% | Das ist eine generierte Datei. |
+%% | |
+%% | (c) 2005-2006 Paul Ebermann. |
+%% '--------------------------------------------------'
+%%
+%% (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.
+%%
+\NeedsTeXFormat{LaTeX2e}[2003/12/01]
+\ProvidesPackage{pauldoc}
+ [2006/04/05 v0.4a Pauls Anpassungen fuer doc (PE)]
+\DeclareOption{chapter}{
+ \let\pauldoc@indexsec=\chapter
+}
+\DeclareOption{section}{
+ \let\pauldoc@indexsec=\section
+}
+\newcommand*{\pauldoc@indexsec}{}
+\ExecuteOptions{section}
+\ProcessOptions\relax
+\RequirePackage[latin1]{inputenc}
+\RequirePackage[ngerman]{babel}
+\RequirePackage[T1]{fontenc}
+\EnableCrossrefs
+\RecordChanges
+\CodelineIndex
+\AtBeginDocument{\MakeShortVerb{\'}\selectlanguage{ngerman}}
+\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.}
+ \setcounter{IndexColumns}{2}
+\newcommand*{\ifReferenceExists}[3]
+{%
+ \@ifundefined{r@#1}{#3}{#2}%
+}
+ \newcommand*{\pack}{\textsf}
+\newcommand*\eTeX{$\m@th\varepsilon$-\TeX}
+ \newcommand*{\includeLicense} {
+ \IfFileExists{\lpplfilename}{%
+ \begin{otherlanguage*}{english}
+\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
+ \DeleteShortVerb{\'}%
+ \MakePercentComment\input{\lpplfilename}\MakePercentIgnore%
+ \MakeShortVerb{\'}%
+ \end{otherlanguage*}
+ }{%
+ \typeout{^^J%
+ ^^J%
+ Die Datei \lpplfilename{} wurde nicht gefunden.^^J%
+ Schade, da wird die Lizenz eben nicht eingebunden.^^J%
+ ^^J%
+ }%
+ }%
+ }
+\AtBeginDocument{
+ \providecommand{\lpplfilename}{lppl.tex}
+}
+\@ifundefined{cs}
+{%
+ \providecommand*{\cmd}[1]{\cs{\expandafter\cmd@to@cs\string#1}}
+ \def\cmd@to@cs#1#2{\char\number`#2\relax}
+ \DeclareRobustCommand*\cs[1]{\texttt{\char`\\#1}}%
+}
+{}
+\providecommand\marg[1]{%
+ {\ttfamily\char`\{}\meta{#1}{\ttfamily\char`\}}}
+\providecommand\oarg[1]{%
+ {\ttfamily[}\meta{#1}{\ttfamily]}}
+\providecommand\parg[1]{%
+ {\ttfamily(}\meta{#1}{\ttfamily)}}
+\endinput
+%%
+%% End of file `pauldoc.sty'.
diff --git a/Master/texmf-dist/tpm/pauldoc.tpm b/Master/texmf-dist/tpm/pauldoc.tpm
new file mode 100644
index 00000000000..26a0a3b18fb
--- /dev/null
+++ b/Master/texmf-dist/tpm/pauldoc.tpm
@@ -0,0 +1,29 @@
+<!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/pauldoc.zip">
+ <TPM:Name>pauldoc</TPM:Name>
+ <TPM:Type>Package</TPM:Type>
+ <TPM:Date>2006/04/11 16:06:00</TPM:Date>
+ <TPM:Version></TPM:Version>
+ <TPM:Creator>karl</TPM:Creator>
+ <TPM:Title>The pauldoc package.</TPM:Title>
+ <TPM:Description></TPM:Description>
+ <TPM:Author></TPM:Author>
+ <TPM:Size>182538</TPM:Size>
+ <TPM:Build/>
+ <TPM:RunFiles size="4642">
+texmf-dist/tex/latex/pauldoc/pauldoc.sty
+texmf-dist/tpm/pauldoc.tpm
+ </TPM:RunFiles>
+ <TPM:DocFiles size="158694">
+texmf-dist/doc/latex/pauldoc/README
+texmf-dist/doc/latex/pauldoc/pauldoc.pdf
+ </TPM:DocFiles>
+ <TPM:SourceFiles size="20222">
+texmf-dist/source/latex/pauldoc/pauldoc.dtx
+texmf-dist/source/latex/pauldoc/pauldoc.ins
+ </TPM:SourceFiles>
+ <TPM:Provides>Package/pauldoc</TPM:Provides>
+ </rdf:Description>
+</rdf:RDF>
+
diff --git a/Master/texmf/lists/pauldoc b/Master/texmf/lists/pauldoc
new file mode 100644
index 00000000000..806910a6e42
--- /dev/null
+++ b/Master/texmf/lists/pauldoc
@@ -0,0 +1,8 @@
+texmf-dist/doc/latex/pauldoc/README
+texmf-dist/doc/latex/pauldoc/pauldoc.pdf
+texmf-dist/source/latex/pauldoc/pauldoc.dtx
+texmf-dist/source/latex/pauldoc/pauldoc.ins
+texmf-dist/tex/latex/pauldoc/pauldoc.sty
+texmf-dist/tpm/pauldoc.tpm
+
+texmf/lists/pauldoc
diff --git a/Master/texmf/tpm/collection-latexextra.tpm b/Master/texmf/tpm/collection-latexextra.tpm
index 0f457161aec..bcf151495a1 100644
--- a/Master/texmf/tpm/collection-latexextra.tpm
+++ b/Master/texmf/tpm/collection-latexextra.tpm
@@ -327,6 +327,7 @@ A large collection of add-on packages for LaTeX.
<TPM:Package name="parrun"/>
<TPM:Package name="patch"/>
<TPM:Package name="patchcmd"/>
+ <TPM:Package name="pauldoc"/>
<TPM:Package name="pawpict"/>
<TPM:Package name="pbox"/>
<TPM:Package name="pbsheet"/>