summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/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/doc/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/doc/latex/pauldoc')
-rw-r--r--Master/texmf-dist/doc/latex/pauldoc/README169
-rw-r--r--Master/texmf-dist/doc/latex/pauldoc/pauldoc.pdfbin0 -> 153121 bytes
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
Binary files differ