From e6fe5410448082a7cb0017c5bf8eceee71112b86 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 9 Jul 2006 22:21:50 +0000 Subject: new package dateiliste git-svn-id: svn://tug.org/texlive/trunk@1790 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/dateiliste/README | 240 +++++++++++++++++++++ Master/texmf-dist/doc/latex/dateiliste/README-de | 25 +++ Master/texmf-dist/doc/latex/dateiliste/README-en | 105 +++++++++ Master/texmf-dist/doc/latex/dateiliste/README-eo | 109 ++++++++++ .../texmf-dist/doc/latex/dateiliste/dateiliste.pdf | Bin 0 -> 189194 bytes 5 files changed, 479 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/dateiliste/README create mode 100644 Master/texmf-dist/doc/latex/dateiliste/README-de create mode 100644 Master/texmf-dist/doc/latex/dateiliste/README-en create mode 100644 Master/texmf-dist/doc/latex/dateiliste/README-eo create mode 100644 Master/texmf-dist/doc/latex/dateiliste/dateiliste.pdf (limited to 'Master/texmf-dist/doc/latex/dateiliste') diff --git a/Master/texmf-dist/doc/latex/dateiliste/README b/Master/texmf-dist/doc/latex/dateiliste/README new file mode 100644 index 00000000000..4879757e352 --- /dev/null +++ b/Master/texmf-dist/doc/latex/dateiliste/README @@ -0,0 +1,240 @@ +This README is for version: + 2006/04/19 v0.2 % +---------------- +([de] unten - [eo] sube) +---------------- +[en] +LaTeX-package 'dateiliste' - include list of used files +(like \listfiles) in the document, and related features. + +Author: Paul Ebermann +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 typesetting of the documentation needs 'pauldoc' (from the +same author). +Additionally you'll need the packages 'ltxtable', 'tabularx', +'longtable' and 'rcsinfo'. + +The package comes as .dtx + .ins. +Run "latex dateiliste.ins" to create the style file and the +README-files (and maybe put them to texmf/tex/latex/paul/, if +your docstrip is configured accordingly), (after that and +maybe updating your TeX hash) run "latex dateiliste.dtx" +(some times) to create the documentation. + + Usage +------- +The package has three main features, which can +be used independently, but together are specially +useful. + +(1) automatic version infos: + + If you have your LaTeX source files in a CVS, + you may use the ID tag to generate the date and + version number for the version string in \listfiles. + Use + + \ProvideFileInfos{$Id: $} + {short description} + + in your file, and do a CVS commit. + +(2) include main file: + + Normally the "main" file (given on the command + line to LaTeX) does not appear in the list given + by \listfiles. This is changed by the package for + the case that the file has the name \jobname.tex. + + (More precisely, the package adds \jobname.tex + iff this file exists and it not can be determinded[1] + to be already in the file list [2].) + + This is enabled by default and may be disabled + using the package option 'noaddmain'. + The macro + \mainFileToList + may also be invoked manually to add the main file. + +(3) include file list also in the (dvi) result + + You can use the command + + \printFileList[
] + + to include a pretty-printed version of the + file list as a section (by default \section*, + any sectioning command may be given as an + optional argument). + + You also have to use \listfiles in the + document preamble (otherwise you'll only get + an error message). + + The table only appears from the second LaTeX-run, + from the third one is complete, and may need some + more runs to align correctly. + + The title, preamble and table headers may be localized + with babel - translations for 'english', 'german', + 'ngerman' and 'esperanto' are included. + If you need something else or don't use babel, you have + to redefine the following macros: + + \fileListName - title ("List of Files") + \fileListPreamble - preamble (typeset before the table) + \fileNameName - table header "file name" + \dateName - table header "date" + \verName - table header "version" + \descriptionName - table header "description" + +----- +[1] this determination can be configured with + the package options + nocat12 - does only work with eTeX, else + may give double entry + cat12 - works also without eTeX, but may + have some side effects to other macro + packages, since it converts \@filelist + to cat 12. + The default setting works like cat12 on non-eTeX + and like nocat12 on eTeX. + +[2] this may occur when you invoke + LaTeX with "\input{mainfile.tex}". +---------------- +[de] +LaTeX-Paket 'dateiliste' - Liste der verwendeten Dateien im Dokument + +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 +(-> http://www.math.hu-berlin.de/~ebermann/alg-script/), +aber vielleicht ist es auch für andere von Nutzen. + +Zum Setzen der Dokumentation wird das Paket 'pauldoc' +(vom selben Autor) benötigt. + +Das Paket kommt als .dtx + .ins. +Mit "latex dateiliste.ins" wird die .sty-Datei erstellt (und +eventuell gleich nach texmf/tex/latex/paul/ installiert, +wenn docstrip entsprechend eingerichtet ist), mit +latex dateiliste.dtx kann (danach und eventuell nach einer +Aktualisierung der TeX-Dateidatenbank) die Dokumentation neu +erstellt werden. + +Zur Verwendung siehe dateiliste.pdf. +---------------- +[eo-h] +LaTeX-pakajho 'dateiliste' - Variajho de \DeclareRobustCommand, +kiu antaue elprovas, chu la nomo jam ekzistas. + +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 bezonas la pakajhojn 'ltxtable', 'longtable', +'tabularx' kaj 'rcsinfo'. +Por krei la dokumentadon vi krome bezonas 'pauldoc' (de la sama autoro). + +La pakajho venas en .dtx + .ins. +Voku "latex dateiliste.ins" por krei la .sty-dosieron (kaj +eble meti ghin al texmf/tex/latex/paul/, se via docstrip estis +konfigurita laue), voku "latex dateiliste.dtx" por rekrei +la dokumentaron. + + Uzado +------- + +La pakajho konsistas el tri chefaj bonajhoj, kiujn +oni povas uzi sendepende, sed kune ili estas speciale +utile. + +(1) automataj versio-informoj. + + Se via LaTeX-dosieroj estas ene de CVS, vi povas + uzi tion por automate generi la daton kaj + versi-numeron por la listo kreita de \listfiles + (kaj la listo de (3).) + Uzu + + \ProvideFileInfos{$Id: dateiliste.dtx,v 1.7 2006/04/19 14:57:24 ebermann Exp $} + {mallonga priskribo} + + en via dosiero, kaj faru 'cvs commit'. (CVS enmetos + informojn, kiun \ProvideFileInfos uzas.) + +(2) aldono de chefa dosiero + + Kutime la chefa dosiero (kiun vi donis en la + latex-voko) ne aperas en la listo kreita de + \listfiles. Tiun la pakajho shanghas, se tiu + dosiero havas la nomfinajhon .tex + + (Pli precize, la pakajho aldonas '\jobname.tex', + se tiu dosiero ekzistas, kaj se ne eblas eltrovi[1], + ke la dosiero estas jam en la listo[2].) + + Tiu aldonado estas kutime shaltita, sed eblas + malshalti ghin per la pakajh-opcio 'noaddmain'. + Tiam ankau eblas voki + \mainFileToList + por fari tion. + +(3) enmetu la dosierliston en la rezulton + + Vi povas uzi la komandon + + \printFileList[
] + + por enmeti bele formatitan version de la + dosierlisto kiel sekcio (kutime '\section*', + sed vi povas uzi iun ajn sekci-komandon kiel + opcia argumento) en la dokumenton. + + Vi krome devas uzi \listfiles en la komenca + parto de la dokumento (antau \begin{document}), + alikaze vi nur ricevos erarmesaghon. + + La tabelo nur aperos ekde la dua LaTeX-voko, kaj + eble bezonos kelkajn pliajn por aspekti ghuste. + + Eblas traduki la titolon de la sekcio, la antautekston + kaj la tabelkapoj helpe de la babel-pakajho - tradukojn + por 'english', 'german', 'ngerman' kaj 'esperanto' estas + la pakajho jam enhavas. + Se vi bezonas aliajn lingvojn au ne uzas 'babel', + redifinu la sekvajn makroojn: + + \fileListName - titolo ("Listo de dosieroj") + \fileListPreamble - antauteksto (printita inter titolo + kaj tabelo) + \fileNameName - table header "dosiernomo" + \dateName - table header "dato" + \verName - table header "versio" + \descriptionName - table header "priskribo" + +----- +[1] Tiun determinadon vi povas konfiguri per la + pakajh-opcioj: + nocat12 - nur funkcias se vi uzas eTeX, alikaze + eble la cxef-dosiero aperos dufoje. + cat12 - funkcias kun aux sen eTeX, koncertante + la enhavon de \@filelist al kategorio 12. + Se vi neniun de tiuj opcioj donas, gxi laboras + kiel 'nocat12' en eTeX kaj kiel 'cat12' en ne-eTeX. + +[2] Tio povas okazi ekzemple, se vi invokas + LaTeX kun "\input{mainfile.tex}". diff --git a/Master/texmf-dist/doc/latex/dateiliste/README-de b/Master/texmf-dist/doc/latex/dateiliste/README-de new file mode 100644 index 00000000000..dcb7d1410b6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/dateiliste/README-de @@ -0,0 +1,25 @@ +Dieses README ist für Version: + 2006/04/19 v0.2 % +---------------- +LaTeX-Paket 'dateiliste' - Liste der verwendeten Dateien im Dokument + +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 +(-> http://www.math.hu-berlin.de/~ebermann/alg-script/), +aber vielleicht ist es auch für andere von Nutzen. + +Zum Setzen der Dokumentation wird das Paket 'pauldoc' +(vom selben Autor) benötigt. + +Das Paket kommt als .dtx + .ins. +Mit "latex dateiliste.ins" wird die .sty-Datei erstellt (und +eventuell gleich nach texmf/tex/latex/paul/ installiert, +wenn docstrip entsprechend eingerichtet ist), mit +latex dateiliste.dtx kann (danach und eventuell nach einer +Aktualisierung der TeX-Dateidatenbank) die Dokumentation neu +erstellt werden. + +Zur Verwendung siehe dateiliste.pdf. diff --git a/Master/texmf-dist/doc/latex/dateiliste/README-en b/Master/texmf-dist/doc/latex/dateiliste/README-en new file mode 100644 index 00000000000..dab41ef9ef4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/dateiliste/README-en @@ -0,0 +1,105 @@ +This README is for version: + 2006/04/19 v0.2 % +---------------- +LaTeX-package 'dateiliste' - include list of used files +(like \listfiles) in the document, and related features. + +Author: Paul Ebermann +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 typesetting of the documentation needs 'pauldoc' (from the +same author). +Additionally you'll need the packages 'ltxtable', 'tabularx', +'longtable' and 'rcsinfo'. + +The package comes as .dtx + .ins. +Run "latex dateiliste.ins" to create the style file and the +README-files (and maybe put them to texmf/tex/latex/paul/, if +your docstrip is configured accordingly), (after that and +maybe updating your TeX hash) run "latex dateiliste.dtx" +(some times) to create the documentation. + + Usage +------- +The package has three main features, which can +be used independently, but together are specially +useful. + +(1) automatic version infos: + + If you have your LaTeX source files in a CVS, + you may use the ID tag to generate the date and + version number for the version string in \listfiles. + Use + + \ProvideFileInfos{$Id: $} + {short description} + + in your file, and do a CVS commit. + +(2) include main file: + + Normally the "main" file (given on the command + line to LaTeX) does not appear in the list given + by \listfiles. This is changed by the package for + the case that the file has the name \jobname.tex. + + (More precisely, the package adds \jobname.tex + iff this file exists and it not can be determinded[1] + to be already in the file list [2].) + + This is enabled by default and may be disabled + using the package option 'noaddmain'. + The macro + \mainFileToList + may also be invoked manually to add the main file. + +(3) include file list also in the (dvi) result + + You can use the command + + \printFileList[
] + + to include a pretty-printed version of the + file list as a section (by default \section*, + any sectioning command may be given as an + optional argument). + + You also have to use \listfiles in the + document preamble (otherwise you'll only get + an error message). + + The table only appears from the second LaTeX-run, + from the third one is complete, and may need some + more runs to align correctly. + + The title, preamble and table headers may be localized + with babel - translations for 'english', 'german', + 'ngerman' and 'esperanto' are included. + If you need something else or don't use babel, you have + to redefine the following macros: + + \fileListName - title ("List of Files") + \fileListPreamble - preamble (typeset before the table) + \fileNameName - table header "file name" + \dateName - table header "date" + \verName - table header "version" + \descriptionName - table header "description" + +----- +[1] this determination can be configured with + the package options + nocat12 - does only work with eTeX, else + may give double entry + cat12 - works also without eTeX, but may + have some side effects to other macro + packages, since it converts \@filelist + to cat 12. + The default setting works like cat12 on non-eTeX + and like nocat12 on eTeX. + +[2] this may occur when you invoke + LaTeX with "\input{mainfile.tex}". diff --git a/Master/texmf-dist/doc/latex/dateiliste/README-eo b/Master/texmf-dist/doc/latex/dateiliste/README-eo new file mode 100644 index 00000000000..6227f0c98c3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/dateiliste/README-eo @@ -0,0 +1,109 @@ +Tiu README (legumin) estas por versio: + 2006/04/19 v0.2 % +---------------- +LaTeX-pakajho 'dateiliste' - Variajho de \DeclareRobustCommand, +kiu antaue elprovas, chu la nomo jam ekzistas. + +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 bezonas la pakajhojn 'ltxtable', 'longtable', +'tabularx' kaj 'rcsinfo'. +Por krei la dokumentadon vi krome bezonas 'pauldoc' (de la sama autoro). + +La pakajho venas en .dtx + .ins. +Voku "latex dateiliste.ins" por krei la .sty-dosieron (kaj +eble meti ghin al texmf/tex/latex/paul/, se via docstrip estis +konfigurita laue), voku "latex dateiliste.dtx" por rekrei +la dokumentaron. + + Uzado +------- + +La pakajho konsistas el tri chefaj bonajhoj, kiujn +oni povas uzi sendepende, sed kune ili estas speciale +utile. + +(1) automataj versio-informoj. + + Se via LaTeX-dosieroj estas ene de CVS, vi povas + uzi tion por automate generi la daton kaj + versi-numeron por la listo kreita de \listfiles + (kaj la listo de (3).) + Uzu + + \ProvideFileInfos{$Id: dateiliste.dtx,v 1.7 2006/04/19 14:57:24 ebermann Exp $} + {mallonga priskribo} + + en via dosiero, kaj faru 'cvs commit'. (CVS enmetos + informojn, kiun \ProvideFileInfos uzas.) + +(2) aldono de chefa dosiero + + Kutime la chefa dosiero (kiun vi donis en la + latex-voko) ne aperas en la listo kreita de + \listfiles. Tiun la pakajho shanghas, se tiu + dosiero havas la nomfinajhon .tex + + (Pli precize, la pakajho aldonas '\jobname.tex', + se tiu dosiero ekzistas, kaj se ne eblas eltrovi[1], + ke la dosiero estas jam en la listo[2].) + + Tiu aldonado estas kutime shaltita, sed eblas + malshalti ghin per la pakajh-opcio 'noaddmain'. + Tiam ankau eblas voki + \mainFileToList + por fari tion. + +(3) enmetu la dosierliston en la rezulton + + Vi povas uzi la komandon + + \printFileList[
] + + por enmeti bele formatitan version de la + dosierlisto kiel sekcio (kutime '\section*', + sed vi povas uzi iun ajn sekci-komandon kiel + opcia argumento) en la dokumenton. + + Vi krome devas uzi \listfiles en la komenca + parto de la dokumento (antau \begin{document}), + alikaze vi nur ricevos erarmesaghon. + + La tabelo nur aperos ekde la dua LaTeX-voko, kaj + eble bezonos kelkajn pliajn por aspekti ghuste. + + Eblas traduki la titolon de la sekcio, la antautekston + kaj la tabelkapoj helpe de la babel-pakajho - tradukojn + por 'english', 'german', 'ngerman' kaj 'esperanto' estas + la pakajho jam enhavas. + Se vi bezonas aliajn lingvojn au ne uzas 'babel', + redifinu la sekvajn makroojn: + + \fileListName - titolo ("Listo de dosieroj") + \fileListPreamble - antauteksto (printita inter titolo + kaj tabelo) + \fileNameName - table header "dosiernomo" + \dateName - table header "dato" + \verName - table header "versio" + \descriptionName - table header "priskribo" + +----- +[1] Tiun determinadon vi povas konfiguri per la + pakajh-opcioj: + nocat12 - nur funkcias se vi uzas eTeX, alikaze + eble la cxef-dosiero aperos dufoje. + cat12 - funkcias kun aux sen eTeX, koncertante + la enhavon de \@filelist al kategorio 12. + Se vi neniun de tiuj opcioj donas, gxi laboras + kiel 'nocat12' en eTeX kaj kiel 'cat12' en ne-eTeX. + +[2] Tio povas okazi ekzemple, se vi invokas + LaTeX kun "\input{mainfile.tex}". diff --git a/Master/texmf-dist/doc/latex/dateiliste/dateiliste.pdf b/Master/texmf-dist/doc/latex/dateiliste/dateiliste.pdf new file mode 100644 index 00000000000..b44f77b7c7d Binary files /dev/null and b/Master/texmf-dist/doc/latex/dateiliste/dateiliste.pdf differ -- cgit v1.2.3