new package pauldoc (11apr06)

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

2 files changed, 169 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