[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/).
Version: v0.5

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] (or [utf8],
if you gave this as package parameter to pauldoc),
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-paka��o 'pauldoc' - Kelkaj iloj por helpi la
dokumentadon de LaTeX-paka��oj en la germana lingvo.

A��toro:  Pa��lo 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 ��i anka��
uzeblas por aliaj.

La dokumentaro (escepte tiu ��i dosiero) estas nur en la germana
lingvo.

La paka��o venas en .dtx + .ins.
Voku "latex pauldoc.ins" por krei la .sty-dosieron (kaj
eble meti ��in al texmf/tex/latex/paul/, se via docstrip estis
konfigurita la��e), voku "latex pauldoc.dtx" por rekrei
la dokumentaron.

 Uzado
-------
La paka��o estas uzata por krei la dokumenta��on por
la aliaj paka��oj de Pa��lo Ebermann, do kutime vi ne
devos uzi ��in rekte.
(Kaj ��i nur ta��gas por dokumenti germanlingve
 LaTeX-paka��ojn, do prefere vi legu la germanlingvan
 dokumenta��on en pauldoc.pdf.)


Uzu la paka��on en via propra .dtx-dosiero en
la sekcio, kiu enhavas la dokumenta��-kreilon:

%<*driver>
\nonstopmode
\documentclass[draft,ngerman]{ltxdoc}
\usepackage{pauldoc}
\usepackage{miaPakajho}
\begin{document}
   \DocInput{miaPakajho.dtx}
\end{document}
%</driver>

En la dokumenta��o vi nun povas uzu kelkajn
aldonajn komandojn:

  \pack{} - belprintas paka��nomojn.
  \includeLicense - enmetas la dosieron \lpplfilename
			(kutime 'lppl.tex') en la dokumentajon,
            se la dosiero ekzistas.
            La kategoriaj kodoj estas ��an��itaj anta��e
			kaj poste, por eviti problemojn.

  \IfReferenceExists{refNomo}{jes}{ne} - kondi��a uzo
			de iu teksto, depende ��u iu 'label' estis
			difinita (en la anta��a voko de LaTeX), do
			��u nun uzo de \ref{refNomo} kaj \pageref{refNomo}
			estus sukcesaj.
			Tio estas ta��ga por referencoj al la implementa
			parto a�� al la licenco, kiuj povus a�� ne povus
			enesti la dokumenton.

  \cmd, \cs, \marg, \oarg, \parg - tiuj komandoj estas
			simple kopiitaj el ltxdoc, por ke oni povu
			uzi ilin anka�� kun alia dokumentklaso kaj
			'doc' (kaj pauldoc').

Aldone, pauldoc vokas 'babel' kun opcio [ngerman],
'fontenc' kun [T1], 'inputenc' kun [latin1] (a��
[utf8], se vi donis [utf8] al pauldoc).
��i difinas "'" kiel "verbatim"-��altilo, en��altas
linnumerojn, indeksadon la�� tiuj, kolektadon de
��an��listo kaj krucreferencadon.
��i tradukas la titolon de la ��an��listo kaj la
prologon de la indekso al la germana. Krome la
indekso uzas nur du kolumnojn (anstata�� tri).