diff options
author | Karl Berry <karl@freefriends.org> | 2012-05-10 23:12:52 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-05-10 23:12:52 +0000 |
commit | 70b47686cb689d8c5e4c6eecb58e7cd43240e92c (patch) | |
tree | 3c2a75e7bf67f98e9c9ed965ecc1992db3951656 /Master/texmf-dist/doc/latex/latexfileinfo-pkgs | |
parent | 2b98282d58db23ce342019c8f3aacfa417eb61b1 (diff) |
new doc package latexfileinfo-pkgs (10may12)
git-svn-id: svn://tug.org/texlive/trunk@26293 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/latexfileinfo-pkgs')
-rw-r--r-- | Master/texmf-dist/doc/latex/latexfileinfo-pkgs/README | 49 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.htm | 582 |
2 files changed, 631 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/README b/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/README new file mode 100644 index 00000000000..98bf40f93f6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/README @@ -0,0 +1,49 @@ + + README for the `latexfileinfo-pkgs' package + Comparison of packages showing LaTeX file infos + (C) Uwe Lueck 2012/05/07 + + +This "package" in the first instance provides a file + + `latexfileinfo_pkgs.htm' + +to be viewed by a web browser. It is an HTML list and comparison +of CTAN packages displaying LaTeX source file informations +according to the commands \ProvidesClass, \ProvidesFile, +and \ProvidesPackage that LaTeX files should start with. +The document especially describes five packages of my own, +including interrelations and dependencies, and thus extends +their documentations. Among packages from different authers +mentioned or described as well are + + * `latexfileversion' and `ltxfileinfo' (rather) + for single files, as well as + + * `classlist' and `dateiliste' for listing inputted files. + +Support of revision control systems is mentioned briefly. + +The files can be redistributed and/or modified under the terms +of the LaTeX Project Public License; either version 1.3c of the +License, or any later version, see + + http://www.latex-project.org/lppl.txt + +We did our best to help you, but there is NO WARRANTY. + +The `latexfileinfo-pkgs' package is author-maintained in the sense +of this license. + +The latest public version of the package is available at + + http://mirror.ctan.org/info/latexfileinfo-pkgs/ + +A TDS version of the package is available as + + http://mirror.ctan.org/install/info/latexfileinfo-pkgs.tds.zip + +Please report mistakes, missing packages, and other suggestions via + + http://www.contact-ednotes.sty.de.vu + diff --git a/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.htm b/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.htm new file mode 100644 index 00000000000..c77a8b8bb47 --- /dev/null +++ b/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.htm @@ -0,0 +1,582 @@ +<!-- generated from + + finfpkgs.tex, 2012/05/06 v0.2 latex file info packages (UL), + + with blog.sty, 2012-05-07 --> +<html><head> <meta http-equiv="Content-Type" content="text/html; ISO-8859-1"> + <meta name="robots" content="index,follow,noarchive"> + <title>Display LaTeX file metadata (“info”)</title> + +</head><body> + +<a name="top-of-page"></a> + + +<h1><code>latexfileinfo-pkgs</code> — +<table width="" height="6" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> + +</tbody></table> + Displaying <a href="http://en.wikipedia.org/wiki/Metadata" target="_blank">Metadata</a> (“Info”) of <em>LaTeX</em> Source Files</h1> + + — a comparison of packages available from <acronym>CTAN</acronym> + +<p> +<small> +[ <a href="#intro">intro</a> | <a href="#table">table</a> | <a href="#single"><code>\GetFileInfo</code> etc.</a> | <a href="#several"><code>\listfiles</code> etc.</a> | <a href="#rcs">rcs/svn</a> | <a href="#thanks">thanks</a> ]  +[ <i><a href="latexfileinfo_pkgs.htm">reload</a></i> ] + +</small> +<p align="right"><a href="#intro">[→</a>|<a href="#top-of-page"> ↑ ]</a></p><hr><a name="intro"></a> +<h2>0 Introduction (with links to sections)</h2> +For <a href="http://en.wikipedia.org/wiki/LaTeX" target="_blank">LaTeX</a> source files, +it is recommended to start them with LaTeX command +<ul> + </li> + <li><code>\ProvidesClass</code><code> </code> (for <code>.cls</code> files) + </li> + <li><code>\ProvidesPackage</code> (for <code>.sty</code> files) + </li> + <li><code>\ProvidesFile</code><code> </code> (for all other files) +</li> +</ul> +(after <code>\NeedsTeXFormat</code>). +Their trailing optional argument can provide the most recent +<ul> + </li> + <li><a href="http://en.wikipedia.org/wiki/Revision control" target="_blank">revision</a> <strong>date</strong><br> +(expected as <em>“first word”</em> in trailing optional argument) + </li> + <li>the corresponding <strong>version</strong> string<br> +(expected as <em>“second word”</em> +in trailing optional argument) — and + </li> + <li>and a brief <strong>description</strong> of the file (“caption”)<br> +(expected as anything <em>else</em> in trailing optional argument). +</li> +</ul> +Here we are listing and comparing TeX packages available from +<a href="http://ctan.org" target="_blank"><acronym>CTAN</acronym></a> that make use of this information. +<p> +The document especially describes five packages of my own, +including interrelations and dependencies, and thus extends +their documentations; see <a href="#table">table below</a> for them. +An <em>asterisk</em>* near a package name indicates that the package +is <em>not mine</em>; so what I tell about it may be wrong or bad … +(please let me know via <a href="http://www.webdesign-bu.de/uwe_lueck/contact.html" target="_blank">form</a>, +or should I add something?) ... +<p> +We have the <em>cases</em> of +<ol> + </li> + <li>displaying <a href="#single">single</a> file info (<strong><code>\GetFileInfo</code></strong> ...) + </li> + <li>listing infos of <a href="#several">several</a> files (<strong><code>\listfiles</code></strong> etc.) +</li> +</ol> +and for each +<ol type="a" + </li> + <li>access by <em>LaTeX</em> (<a href="#sing-ltx">1 </a>·<a href="#sev-ltx"> 2</a>) + </li> + <li>access by <em>external</em> program (<a href="#sing-ext">1 </a>·<a href="#sev-ext"> 2</a>). +</ol> +<em>Related</em> subjects are using +<ol type="i" + </li> + <li><a href="#rcs">revision control systems</a> and + </li> + <li>modification time according to <a href="#filemod">pdfTeX</a>. +</ol> +<a name="table"></a>A <em>tabular overview</em> of the first two case distinctions: +<p> +<table cellpadding="6" width="" frame="box" rules="all"> + <tbody> + <!-- standard all-rules table --> + <tr bgcolor="#EEEEEE" style="font-weight:bold"> + <td> +</td><td>just using <em>LaTeX</em>  </td><td>using <em>external</em> program + </td> + </tr> + <tr> + <td> +<b><a href="#single">single</a> file</b></td><td> +• <a href="#doc">doc</a>*     +(Frank <a href="http://ctan.org/author/id/mittelbach" target="_blank">Mittelbach</a>)<br> +• <a href="#zwgetfdate">zwgetfdate</a>*         +(Zdeněk <a href="http://ctan.org/author/id/wagner" target="_blank">Wagner</a>)<br> +• <a href="#readprov">readprov</a> +</td><td> +• <a href="#lfv">latexfileversion</a>* + (Harald <a href="http://ctan.org/author/id/harders" target="_blank">Harders</a>) <br> +• <a href="#lfi">ltxfileinfo</a>*           + (Wybo <a href="http://ctan.org/author/id/dekker" target="_blank">Dekker</a>) <br> +• <a href="#tofi">typeoutfileinfo</a> + </td> + </tr> + <tr> + <td> +<b>file <a href="#several">list</a></b></td><td> +• <a href="#cl">classlist</a>*      +(Heiko <a href="http://ctan.org/author/id/oberdiek" target="_blank">Oberdiek</a>) <br> +• <a href="#dl">dateiliste</a>*   + (Paul <a href="http://ctan.org/author/id/ebermann" target="_blank">Ebermann</a>) <br> +• <a href="#lnfl">longnamefilelist</a> <br> +• <a href="#nfl">nicefilelist</a> <br> +• <a href="#mfl">myfilist</a> <br> +</td><td> +• [<a href="#ltxinput">ltxinput</a>*        +(Jim <a href="http://ctan.org/author/id/green" target="_blank">Green</a>)] <br> +• [<a href="#tle">texlog-extract</a>*     +(Wybo <a href="http://ctan.org/author/id/dekker" target="_blank">Dekker</a>)] <br> +<br> +[ don’t really belong here … ] <br> +<br> + </td> + </tr> + +</tbody> +</table> + +<p align="right"><a href="#single">[→</a>|<a href="#top-of-page"> ↑ ]</a></p><hr><a name="single"></a> +<h2>1 Access Single File Info</h2> + +<small> +[ <a href="#sing-ltx">a:</a>  +<a href="#doc">doc</a> | <a href="#readprov">readprov</a> | <a href="#zwgetfdate">zwgetfdate</a> ]  +[ <a href="#sing-ext">b:</a>  +<a href="#lfv">latexfileversion</a> | <a href="#lfi">ltxfileinfo</a> | <a href="#tofi">typeoutfileinfo</a> ]  +[ <a href="#filemod">c: filemod</a> ] + +</small> +<h3><a name="sing-ltx"></a>a. Access in <em>LaTeX</em> Run</h3> + +—originally for <em>automatic</em> inclusion of <em>current</em> +revision date and version of a package +in <em>typesetting</em> the latter’s documentation +(<i>“This document describes version … as of …”</i>), but then … +<dl> + <dt><strong><a name="doc"></a><a href="http://ctan.org/pkg/doc" target="_blank">doc</a>*</strong><dd> +<ul> + </li> + <li>Belongs to LaTeX <a href="http://ctan.org/pkg/latex-base" target="_blank">base</a> distribution. + </li> + <li>Provides <strong><code>\GetFileInfo</code></strong><code>{⟨<i>file</i>⟩}</code>; after using this, +you have <code>\filedate</code>, <code>\fileversion</code>, <code>\fileinfo</code> of ⟨<i>file</i>⟩. + </li> + <li>⟨<i>file</i>⟩ must have been <em>loaded</em> in the LaTeX run. + </li> + <li><code>\GetFileInfo</code> is <em>fragile</em>. +</li> +</ul> + <dt><strong><a name="zwgetfdate"></a><a href="http://ctan.org/pkg/zwgetfdate" target="_blank">zwgetfdate</a>*</strong><dd> +<ul> + </li> + <li>Provides <strong><code>\DateOfFile</code></strong><code>{⟨<i>file</i>⟩}</code> +and <strong><code>\DateOfPackage</code></strong><code>{⟨<i>file</i>⟩}</code>. + </li> + <li>⟨<i>file</i>⟩ must have been <em>loaded</em>. +</li> +</ul> + <dt><strong><a name="readprov"></a><a href="http://ctan.org/pkg/readprov" target="_blank">readprov</a></strong><dd> +<ul> + </li> + <li> +Provides +<strong><code>\UseDateOf</code></strong><code>{⟨<i>file</i>⟩}</code> and <strong><code>\UseVersionOf</code></strong><code>{⟨<i>file</i>⟩}</code>. + </li> + <li> +Steals <a href="#doc">doc</a>’s <strong><code>\GetFileInfo</code></strong> so doc is not +needed, in case ... + </li> + <li>Provides +<ul> + </li> + <li><strong><code>\ReadFileInfos</code></strong><code>{⟨<i>files</i>⟩}</code> + </li> + <li><strong><code>\ReadPackageInfos</code></strong><code>{⟨<i>files</i>⟩}</code> + </li> + <li><strong><code>\ReadClassInfo</code></strong><code>{⟨<i>file</i>⟩}</code> +</li> +</ul> +as <em>alternatives</em> to <code>\GetFileInfo</code>. +<ul> + </li> + <li>They do <em>not</em> really <em>load</em> ⟨<i>file</i>⟩/⟨<i>files</i>⟩ ... + </li> + <li>... so can be used with incompatible packages and +classes (multiple latter by <code>\ReadFileInfos{⟨<i>base</i>⟩.cls}</code>). + </li> + <li>This allows <strong>adding arbitrary</strong> LaTeX source files +to the list of files that LaTeX manages for +<a href="#latex"><strong><code>\listfiles</code></strong></a> — this is used for +<a href="#myfilist">myfilist</a>. +</li> +</ul> +</li> +</ul> + +</dl> +<h3><a name="sing-ext"></a>b. <em>Screen</em> Display Using <em>External</em> Program</h3> +—when you wonder whether the most recent version of a package +or a chapter file is present … +<dl> + <dt><strong><a name="lfv"></a><a href="http://ctan.org/pkg/latexfileversion" target="_blank">latexfileversion</a>*</strong><dd> +<ul> + </li> + <li><a href="http://en.wikipedia.org/wiki/Bash (Unix shell)" target="_blank">Bash (Unix shell)</a> script. + </li> + <li><em>Nice</em> screen display. + </li> + <li>Invokes <code>latex</code> run using a copy of +<a href="#doc">doc</a>’s <code>\GetFileInfo</code>. +</li> +</ul> + <dt><strong><a name="lfi"></a><a href="http://ctan.org/pkg/ltxfileinfo" target="_blank">ltxfileinfo</a>*</strong><dd> +<ul> + </li> + <li><a href="http://en.wikipedia.org/wiki/Ruby (programming language)" target="_blank">Ruby</a> script. + </li> + <li>Displays nice +<a href="http://mirror.ctan.org/support/ltxfileinfo/doc/ltxfileinfo.html" target="_blank">table</a> +of infos (including <em>location</em> in file system) on screen. +</li> +</ul> + <dt><strong><a name="tofi"></a><a href="http://ctan.org/pkg/typeoutfileinfo" target="_blank">typeoutfileinfo</a></strong><dd> +<ul> + </li> + <li>5-lines <a href="http://en.wikipedia.org/wiki/Bash (Unix shell)" target="_blank">Bash (Unix shell)</a> script. + </li> + <li>Expects <code>latex</code> won’t append too many screen lines after +1-line <strong><code>\typeout</code></strong><br> +(<em>tolerable</em> screen display as compared with +<a href="#lfv">latexfileversion</a>). + </li> + <li>Invokes <code>latex</code> run using <a href="#readprov">readprov</a>. +</li> +</ul> + +</dl> +<h3><a name="filemod"></a>c. Related, while different …</h3> +<dl> + <dt><strong><a href="http://ctan.org/pkg/filemod" target="_blank">filemod</a>*</strong><dd> +<ul> + </li> + <li>Uses <a href="http://tug.org/applications/pdftex/NEWS" target="_blank">pdfTeX</a>’s +<code>\pdffilemoddate{⟨<i>file</i>⟩}</code> primitive. + </li> + <li>Compares modification dates of files. + </li> + <li>Files include images. + </li> + <li>Also works with <code>pdflatex</code> in <acronym>DVI</acronym> mode. +</li> +</ul> + +</dl> + +<p align="right"><a href="#several">[→</a>|<a href="#top-of-page"> ↑ ]</a></p><hr><a name="several"></a> +<h2>2 File Info List</h2> +This is about listing <em>all</em> files input in a LaTeX run, <em>or</em> ... +<h3><a name="sev-ltx"></a>a. Create in LaTeX Run</h3> +<small> +[ <a href="#latex">LaTeX</a> | <a href="#cl">classlist</a> | <a href="#dl">dateiliste</a> | <a href="#lnfl">longnamefilelist</a> | <a href="#mfl">myfilist</a> | <a href="#nfl">nicefilelist</a> ] + +</small> +<dl> + <dt><strong><a name="latex"></a><a href="http://ctan.org/pkg/latex" target="_blank">latex</a>*</strong><dd> +<ul> + </li> + <li>LaTeX provides <strong><code>\listfiles</code></strong> for the document preamble. + </li> + <li><code>\listfiles</code> issues a list of <strong>all</strong> files input in the <code>latex</code> run +near end of <code>.log</code> file, together with their infos according +to <code>\Provide...</code> commands. + </li> + <li>The list is a <strong>two-column</strong> “table” (plain text), <em>base</em> filenames +flush right, <em>info</em> (maybe date, maybe version, maybe anything) flush left. + </li> + <li>Any file whose base <a href="http://en.wikipedia.org/wiki/filename" target="_blank">filename</a> has <strong>more than 8</strong> characters +or whose filename extension does <em>not</em> have 3 characters <strong>corrupts</strong> alignment. +</li> +</ul> + <dt><strong><a name="cl"></a><a href="http://ctan.org/pkg/classlist" target="_blank">classlist</a>*</strong><dd> +<ul> + </li> + <li>Remembers (separately) files input by (a) <strong><code>\documentclass</code></strong> +and what was input by (b) <strong><code>\LoadClass</code></strong>. + </li> + <li>On <strong><code>\PrintClassList</code></strong>, the list of loaded class files appears on screen. + </li> + <li>Configurable by <strong><code>\PrintClassListEntry</code></strong> and <strong><code>\PrintClassListTitle</code></strong>. +</li> +</ul> + <dt><strong><a name="dl"></a><a href="http://ctan.org/pkg/dateiliste" target="_blank">dateiliste</a>*</strong><dd> +<ul> + </li> + <li>Lists anything that the <a href="#latex">original</a> <code>\listfiles</code> would list. + </li> + <li><strong>Typesets</strong> the list as a LaTeX table, using package <a href="http://ctan.org/pkg/longtable" target="_blank">longtable</a>. + </li> + <li>Separate <strong>columns</strong> for +<ul> + </li> + <li>filename + </li> + <li><em>page</em> where input (optionally) + </li> + <li>date + </li> + <li>version + </li> + <li>description (“caption”) +</li> +</ul> + </li> + <li>Supports <strong><acronym>RCS</acronym></strong>, +<a href="http://en.wikipedia.org/wiki/Concurrent Versions System" target="_blank"><acronym>CVS</acronym></a>, +and <acronym>SVN</acronym> (cf. <a href="#rcs">section below</a>). + </li> + <li>Highly configurable. + </li> + <li>E.g., you can replace info for a file by what you want to see in the list +(cf. <a href="#myfilist">myfilist</a>). + </li> + <li>I haven’t seen what happens with <em>plain text</em> (<code>.log</code>) output. +</li> +</ul> + <dt><strong><a name="lnfl"></a><a href="http://ctan.org/pkg/longnamefilelist" target="_blank">longnamefilelist</a></strong><dd> +<ul> + </li> + <li>Overcomes <a href="#latex">LaTeX</a>’s “8-character limit” +by a new <strong>optional argument</strong> for <code>\listfiles</code>, +indicating number of characters to be reserved for +base filenames, e.g. accounting for “<code>longnamefilelist.sty</code>”: +<blockquote> +<code>\listfiles[16]</code> + +</blockquote> + — view +<a href="http://mirror.ctan.org/macros/latex/contrib/longnamefilelist/SrcFILEs.txt" target="_blank">example outcome</a> + </li> + <li>—showing combination with <a href="#mfl">myfilist</a> + </li> + <li>—while also working as single addition to +LaTeX <a href="http://ctan.org/pkg/latex-base" target="_blank">base</a>, +<em>no</em> need of <a href="#mfl">myfilist</a> or <a href="http://ctan.org/pkg/monofill" target="_blank">monofill</a>. + </li> + <li>Still, filename <strong>extension</strong>s with number of characters +differing from 3 break alignment. Martin Münch mentions +<code>t1cmtt.fd</code> (standard LaTeX font definition) and +<code>supp-pdf.mkii</code> (<a href="http://en.wikipedia.org/wiki/ConTeXt" target="_blank">ConTeXt</a>). +</li> +</ul> + <dt><strong><a name="nfl"></a><a href="http://ctan.org/pkg/nicefilelist" target="_blank">nicefilelist</a></strong><dd> +<ul> + </li> + <li>Uses separate <strong>columns</strong> for <strong>date</strong> and <strong>time</strong> +(like <a href="#dl">dateiliste</a>). + </li> + <li>(Picky) recognition of “date” and “version” — if not present, +left <strong>empty</strong> or gets “missing” display: +<blockquote><code> +nicefilelist.sty 2012/03/29 v0.2 more file list alignment (UL)<br> +nicefilelist.tex 2012/03/23 -- documenting nicefilelist.sty +</code> +</blockquote> +(Martin Münch’s idea). + </li> + <li>Problem of varying filename <strong>extension</strong> lengths overcome +by actually keeping a separate flush-left column for them. + </li> + <li>Column widths configurable by <strong>templates</strong> — replace +pre-configuration (<a href="http://ctan.org/pkg/monofill" target="_blank">monofill</a> commands): +<blockquote><code> + +\MFfieldtemplate{f-base} {nicefilelist} %% base name <br> +\MFfieldtemplate{f-ext} {tex} %% name extension <br> +\MFfieldtemplate{f-version}{v0.11a} %% version +</code> +</blockquote> + </li> + <li>First code line above shows <strong>difference</strong> to <a href="http://ctan.org/pkg/longnamefilelist" target="_blank">longnamefilelist</a>, +equivalent there would be <code>\listfiles[12]</code>. +nicefilelist does <em>not</em> provide an optional argument +for <code>\listfiles</code>. + </li> + <li>Column <strong>distances</strong> and “<strong>missing</strong>” display configurable too. + </li> + <li>Can be combined with <a href="#mfl">myfilist</a> — view +<a href="http://mirror.ctan.org/macros/latex/contrib/nicefilelist/SrcFILEs.txt" target="_blank">output sample</a>. + </li> + <li>Needs just <a href="http://ctan.org/pkg/monofill" target="_blank">monofill</a>, additionally to +LaTeX <a href="http://ctan.org/pkg/latex-base" target="_blank">base</a>. +</li> +</ul> + <dt><strong><a name="mfl"></a><a name="myfilist"></a><a href="http://ctan.org/pkg/myfilist" target="_blank">myfilist</a></strong><dd> +<ul> + </li> + <li>Allows <strong>removing</strong> all entries that LaTeX has collected +for <a href="#latex"><code>\listfiles</code></a> at a certain point. + </li> + <li>Then, by commands from <a href="#readprov">readprov</a>, +you can <strong>add arbitrary</strong> files to the list +(as they are <em>not</em> really <em>loaded</em>), +in the order you want to have them in the list. + </li> + <li>Thus actually, you can set up a list of files you want to have +<em>independently</em> of a typesetting run ... + </li> + <li>... and actually, the <strong>intended</strong> application is generating the +list <strong>without</strong> any <strong>typesetting</strong>, +by running <code>latex</code> on a “<strong>script</strong>” file +just loading readprov and myfilist +and using only commands from <em>them</em>. +(No <code>\documentclass</code>, no <code>{document}</code> environment.) + </li> + <li>View +<a href="http://mirror.ctan.org/macros/latex/contrib/longnamefilelist/docsrc/srcfiles.tex" target="_blank">input example</a> +for <a href="#lnfl">longnamefilelist</a>. + </li> + <li>Besides <code>.log</code> output, the list can be written into a <strong>separate</strong> +plain text <strong>file</strong> — view +<a href="http://mirror.ctan.org/macros/latex/contrib/longnamefilelist/SrcFILEs.txt" target="_blank">output example</a> +for <a href="#lnfl">longnamefilelist</a>. + </li> + <li><strong>Main applications</strong> in my mind and actual work: +<ol> + </li> + <li>List of <code>.sty</code> and <code>.tex</code> files for <em>my</em> +<strong><acronym>CTAN</acronym> packages</strong> and <strong>bundles</strong> +(instead of the <code>.dtx</code>/<a href="http://ctan.org/pkg/docstrip" target="_blank">docstrip</a> system, I use <a href="http://ctan.org/pkg/nicetext" target="_blank">nicetext</a>). + </li> + <li>List of <strong>package</strong> files specific to some <strong>project</strong> +that often change — manual replacement for a +“concurrent versions” system with single author. +E.g.: +<ul> + </li> + <li><a href="http://ctan.org/pkg/nicetext" target="_blank">nicetext</a> packages underlying <strong>documentation</strong> +of a certain different package. + </li> + <li><strong>style</strong> files underlying a <strong>book</strong> project +at which authors and programmers work on changing computers. +</li> +</ul> + </li> + <li>List of <strong>chapter</strong> <code>\include</code> files for a <strong>book</strong> project, +edited at changing computers (by a number of authors). + </li> + <li>Often, one <strong>forgets</strong> to <strong>update</strong> version information +in the <code>\Provides...</code> command — the myfilist +helps you to check this +(e.g., right before a release; +<a href="#filemod">filemod</a> might automate this check, +perhaps together with <a href="#readprov">readprov</a>, +<em>without</em> myfilist). +</li> +</ol> + </li> + <li>My actual <strong>workflow</strong> with <a href="http://en.wikipedia.org/wiki/Bash (Unix shell)" target="_blank">Bash (Unix shell)</a>: +<ul> + </li> + <li><strong><code>upsfl</code></strong> with +<blockquote><code> +alias upsfl='latex srcfiles' +</code> +</blockquote> +updates the list of source files, +and actually displays the updated list on screen. + </li> + <li><strong><code>shsfl</code></strong> with +<blockquote><code> +<code>alias shsfl='more SrcFILEs.txt'</code> +</code> +</blockquote> +displays the source file list without updating, +and waits when the list is too long for your (netbook) screen. +</li> +</ul> + </li> + <li>Combinable with <a href="#dl">dateiliste</a>? +</li> +</ul> + +</dl> +<h3><a name="sev-ext"></a>b. Create by External Program</h3> +Hm, not so related, <em>no</em> infos (it seems), lists only; +so, just <em>“most related I could find”</em> for this section ... +<dl> + <dt><strong><a name="ltxinput"></a><a href="http://ctan.org/pkg/ltxinput" target="_blank">ltxinput</a>*</strong><dd> +<ul> + </li> + <li><a href="http://en.wikipedia.org/wiki/MS-DOS" target="_blank"><acronym>MS-DOS</acronym></a> utility +(compiled from <a href="http://en.wikipedia.org/wiki/C (programming language)" target="_blank"><acronym>C</acronym></a>). + </li> + <li>Lists files that <em>would</em> be input (recursively). +</li> +</ul> + <dt><strong><a name="tle"></a><a href="http://ctan.org/pkg/texlog-extract" target="_blank">texlog-extract</a>*</strong><dd> +<ul> + </li> + <li><a href="http://en.wikipedia.org/wiki/Ruby (programming language)" target="_blank">Ruby</a> script. + </li> + <li>Lists files that issued errors and warnings (colored). +</li> +</ul> + +</dl> + +<p align="right"><a href="#rcs">[→</a>|<a href="#top-of-page"> ↑ ]</a></p><hr><a name="rcs"></a> +<h2><a name="rcs"></a>3 <acronym>RCS</acronym>/<acronym>SVN</acronym></h2> +For <a href="http://en.wikipedia.org/wiki/Revision control" target="_blank">revision control systems</a> +<a href="http://en.wikipedia.org/wiki/Revision control system" target="_blank"><acronym>RCS</acronym></a> and +<a href="http://en.wikipedia.org/wiki/Apache Subversion" target="_blank"><acronym>SVN</acronym></a>, there are +<ul> + </li> + <li><a href="http://ctan.org/pkg/rcs" target="_blank">rcs</a>* · <a href="http://ctan.org/pkg/rcsinfo" target="_blank">rcsinfo</a>* · <a href="http://ctan.org/pkg/rcs-multi" target="_blank">rcs-multi</a>* + </li> + <li><a href="http://ctan.org/pkg/svn" target="_blank">svn</a>* · <a href="http://ctan.org/pkg/svninfo" target="_blank">svninfo</a>* · <a href="http://ctan.org/pkg/svn-multi" target="_blank">svn-multi</a>* + </li> + <li><a href="http://ctan.org/pkg/svn-prov" target="_blank">svn-prov</a>* provides <acronym>SVN</acronym> variants of +<code>\ProvidesClass</code>, <code>\ProvidesFile</code>, and <code>\ProvidesPackage</code>. +</li> +</ul> +—sorry, I can’t tell more about them right now … + +<p align="right"><a href="#thanks">[→</a>|<a href="#top-of-page"> ↑ ]</a></p><hr><a name="thanks"></a> +<h2>Acknowledgements</h2> +Thanks to Martin Münch, Moss +(I wrote this for his question), +and Rainer Schöpf! +<a href="#rcs"><acronym>RCS</acronym> stuff</a> mainly has been stolen from +<a href="http://mirror.ctan.org/help/Catalogue/bytopic.html#revision" target="_blank">Jürgen Fenn’s Topic Index</a> of the +<a href="http://mirror.ctan.org/help/Catalogue" target="_blank">TeX Catalogue</a>. +<p> +<hr> +<small>* not mine +</small> +<p align="right"><i>Last revised 2012-05-07 © <a href="http://www.webdesign-bu.de/uwe_lueck/contact.html" target="_blank">Uwe Lück</a> +<table width="" height="6" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> + +</tbody></table> + (using <a href="http://ctan.org/pkg/morehype" target="_blank">blog.sty</a> and <a href="http://ctan.org/pkg/monofill" target="_blank">monofill.sty</a>) +<table width="" height="6" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> + +</tbody></table> + License: <a href="http://www.latex-project.org/lppl/" target="_blank">LPPL 1.3c</a> or later, author-maintained.</i></p> +<p align="right"><a href="#top-of-page">[<i>→ top of page</i> ]</a></p> + +<table width="" height="550" border="0" cellpadding="0" cellspacing="0"><tbody> + <!-- HVspace --> + <tr valign="top"><td></td> </tr> + +</tbody></table> + +</body></html> + |