summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-10-21 00:05:13 +0000
committerKarl Berry <karl@freefriends.org>2012-10-21 00:05:13 +0000
commited7f9d1b31e010c54e353fd28da8a1fca34ee51f (patch)
tree7ef3bb80c3404ada413eecb65322736f9013cefc /Master/texmf-dist/doc/support
parent5ffb4c20aaabde2cc7f9444eda638193c26cc8e1 (diff)
new script adhocfilelist (20oct12), and handle both bin and nobin scripts in .tds.zip
git-svn-id: svn://tug.org/texlive/trunk@28038 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/RELEASE.txt30
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt19
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm524
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/makehtml.log142
4 files changed, 715 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/RELEASE.txt b/Master/texmf-dist/doc/support/adhocfilelist/RELEASE.txt
new file mode 100644
index 00000000000..49ce3f4a9cb
--- /dev/null
+++ b/Master/texmf-dist/doc/support/adhocfilelist/RELEASE.txt
@@ -0,0 +1,30 @@
+FIRST UPLOAD was v0.6 as of 2012-10-14.
+
+UPLOAD of v0.7 as of 2012-10-17 (2012-10-18):
+
+ * New option -c adds test of "date consistency" with the
+ `filedate' package and may thus be a way to check
+ "date consistency" with XeLaTeX (where \pdffilemoddate
+ is not available ... may be silly ...).
+ * Indeed new option -x uses `xelatex' rather than `latex'
+ (see manual `adhocfilelist.htm' for discussion of
+ possible silliness -- somewhat missing in `filedate'
+ discussion).
+ * Some documentation mistakes have been corrected.
+ * srcfiles.tex checks date consistency for scripts and
+ documentation and lists what is used indeed
+ (but cf. makehtml.log from recent makehtml.tex).
+ * `adhocfilelist.RLS' provides a release summary with
+ `typeoutfileinfo', appearing in SrcFILEs.txt too.
+
+v0.8 should allow -c with an explicit list of filenames ...
+
+UPLOAD r0.3 (2012-10-19):
+
+ * added present RELEASE.txt (started for v0.7)
+ * corrected adhocfilelist.tds.zip
+ * added `filedate' checks in makehtml.tex, additionally
+ to those in srcfiles.tex
+ * \listfiles in makehtml.tex (HTML driver) more careful,
+ using `nicefilelist', for comparison with SrcFILEs.txt
+
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt b/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt
new file mode 100644
index 00000000000..1678576985b
--- /dev/null
+++ b/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt
@@ -0,0 +1,19 @@
+
+ *File List*
+adhocfilelist.sh 2012/10/17 v0.7 command line -> \listfiles (UL)
+adhocfilelist.tex 2012/10/17 -- documenting adhocfilelist (UL)
+ makehtml.tex 2012/10/19 -- HTML driver
+ srcfiles.tex 2012/10/19 -- file infos -> SrcFILEs.txt
+ RELEASE.--- -- -- -- -- ----
+adhocfilelist.RLS 2012/10/18 r0.3 RELEASE.txt for v0.7 (-c, -x)
+HTML_packages.--- -- -- -- -- ----
+ blog.sty 2012/10/05 v0.8 simple fast HTML (UL)
+ blogexec.sty 2012/08/29 v0.2 assignments with blog.sty (UL)
+ domore.sty 2012/08/08 v0.2 dowith extended (UL)
+ fifinddo.sty 2012/08/27 v0.6 filtering TeX(t) files by TeX (UL)
+ texblog.fdf 2012/10/06 -- extra blog settings
+ ***********
+
+ List made at 2012/10/19, 19:54
+ from script file srcfiles.tex
+
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm b/Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm
new file mode 100644
index 00000000000..9bd63c2dc07
--- /dev/null
+++ b/Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm
@@ -0,0 +1,524 @@
+<!DOCTYPE html>
+<!-- generated from
+
+ adhocfilelist.tex, 2012/10/17 documenting adhocfilelist (UL),
+
+ with blog.sty, 2012-10-19 -->
+<html><head> <meta http-equiv="content-type" content="text/html; ISO-8859-1">
+ <meta name="robots" content="index,follow,noarchive">
+ <title>List LaTeX file infos according to command line</title>
+
+</head><body>
+<a name="top-of-page"></a>
+
+
+
+
+<h1><code>adhocfilelist</code> &mdash;
+<table width="" height="6" border="0" cellpadding="0" cellspacing="0"><tbody>
+ <!-- HVspace -->
+ <tr valign="top"><td></td> </tr>
+
+</tbody></table>
+ Listing LaTeX Source File Infos<br> According to Command Line</h1>
+
+<p>
+<small>
+[&#8239;<a href="#abstract">abstract</a>&nbsp;|
+<a href="#over">overview</a>&nbsp;|
+<a href="#required">requirements</a>&nbsp;|
+<a href="#install">installing</a>&nbsp;|
+<a href="#related">related</a>&nbsp;|
+<a href="#back">background</a>&nbsp;|
+<a href="#custom">customize</a>&nbsp;|
+<a href="#idea">idea/thanks</a>&#8239;]&emsp;
+[&#8239;<i><a href="adhocfilelist.htm">reload</a></i>&#8239;]
+
+</small>
+
+<h2><a name="abstract"></a>Abstract<a href="#abstract">.</a></h2>
+<span style="font-family:sans-serif">adhocfilelist.sh</span> is a shell script with command line options
+and parameters that displays &lang;<i>info</i>&rang; for files &lang;<i>file</i>&rang;
+on screen that (i)&nbsp;are indicated on the command line and
+(ii)&nbsp;contain <code>\ProvidesFile</code><code>{</code><code>&lang;<i>file</i>&rang;</code><code>}</code><code>[</code><code>&lang;<i>info</i>&rang;</code><code>]</code>,
+<code>\ProvidesPackage</code><code>{</code><code>&lang;<i>file</i>&rang;</code><code>}</code><code>[</code><code>&lang;<i>info</i>&rang;</code><code>]</code>,
+or <code>\ProvidesClass</code><code>{</code><code>&lang;<i>file</i>&rang;</code><code>}</code><code>[</code><code>&lang;<i>info</i>&rang;</code><code>]</code>.
+There is one line for each file, formatted about as with LaTeX&rsquo;s
+<code>\listfiles</code>. This formatting can be varied, and the output may
+additionally be saved in a plain text file. The files &lang;<i>file</i>&rang;
+are either (a)&nbsp;listed explicitly, separated by commas, or
+(b)&nbsp;they are gathered by the Unix <span style="font-family:sans-serif"><a href="http://en.wikipedia.org/wiki/find" target="_blank">find</a></span> utility.
+For the latter, <span style="font-family:sans-serif">adhocfilelist</span> provides a somewhat simplified
+interface, especially for restricting the list of files
+to those that have been modified &ldquo;today&rdquo; or a few days ago.
+So you/I can check whether version info was updated correctly,
+and it may allow <a href="http://ctan.org/pkg/filedate" target="_blank"><span style="font-family:sans-serif">filedate</span></a> &ldquo;consistency checks&rdquo;
+even with <a href="http://ctan.org/pkg/xetex" target="_blank"><span style="font-family:sans-serif">XeTeX</span></a> (where <code>\pdffilemoddate</code>
+is unavailable).
+<p>
+The package may thus be considered an extension of the
+<a href="http://ctan.org/pkg/latexfileversion" target="_blank"><span style="font-family:sans-serif">latexfileversion</span></a> (Harald <a href="http://ctan.org/author/id/harders" target="_blank">Harders</a>)
+and <a href="http://ctan.org/pkg/typeoutfileinfo" target="_blank"><span style="font-family:sans-serif">typeoutfileinfo</span></a> packages
+that display &lang;<i>info</i>&rang; for a <em>single</em> file &lang;<i>file</i>&rang;.
+Moreover, it is a somewhat simplified interface to the packages
+<a href="http://ctan.org/pkg/myfilist" target="_blank"><span style="font-family:sans-serif">myfilist</span></a>, <a href="http://ctan.org/pkg/longnamefilelist" target="_blank"><span style="font-family:sans-serif">longnamefilelist</span></a>,
+<a href="http://ctan.org/pkg/nicefilelist" target="_blank"><span style="font-family:sans-serif">nicefilelist</span></a>, and <a href="http://ctan.org/pkg/filedate" target="_blank"><span style="font-family:sans-serif">filedate</span></a>.
+
+<h2><a name="over"></a>Overview of command line contents<a href="#over">.</a></h2>
+The general structure of a command line using <span style="font-family:sans-serif">adhocfilelist</span> is
+<blockquote>
+<a href="#call">&lang;<i>call</i>&rang;</a>
+<a href="#opts">&lang;<i>options</i>&rang;</a>
+<a href="#files">&lang;<i>files</i>&rang;</a>
+
+</blockquote>
+The three parts are as follows:
+<dl>
+ <dt><strong>&lang;<i>call</i>&rang;<a name="call"></a></strong><dd>
+This is either
+<ul>
+ </li>
+ <li>&lang;<i>path</i>&rang;<span style="font-family:sans-serif">adhocfilelist.sh</span>
+where &lang;<i>path</i>&rang; is &ldquo;./&rdquo; or something,
+depending on where you place the file <span style="font-family:sans-serif">adhocfilelist.sh</span>,
+or on your use of <a href="http://en.wikipedia.org/wiki/symbolic link" target="_blank">symbolic link</a>s,
+the environment variable <code><a href="http://en.wikipedia.org/wiki/PATH (variable)" target="_blank">PATH</a></code>,
+or
+ </li>
+ <li>an <code><a href="http://en.wikipedia.org/wiki/alias (command)" target="_blank">alias</a></code> for
+&lang;<i>path</i>&rang;<span style="font-family:sans-serif">adhocfilelist.sh</span>.
+</li>
+</ul>
+ <dt><strong>&lang;<i>options</i>&rang;<a name="opts"></a></strong><dd>
+
+Some options &ldquo;switch into <strong><span style="font-family:sans-serif"><a href="http://en.wikipedia.org/wiki/find" target="_blank">find</a></span> mode</strong>&rdquo;,
+affecting the interpretation of <strong>&lang;<i>files</i>&rang;</strong>, marked by &ldquo;<strong>(f)</strong>&rdquo;.
+Their description may be inaccurate here,
+understanding the details may require some knowledge of <span style="font-family:sans-serif">find</span>
+(see &ldquo;<a href="#back">background</a>&rdquo; below).
+Some options have one parameter, some have none.
+<dl>
+ <dt><strong><code>-0</code></strong><dd> <strong>(f)</strong>
+List files modified &ldquo;<strong>today</strong>&rdquo; only (unless &hellip;)
+ <dt><strong><code>-a</code>&nbsp;<code>&lang;<i>integer</i>&rang;</code></strong><dd> <strong>(f)</strong>
+List files modified &lang;<i>integer</i>&rang; days <strong>ago</strong> only
+(unless &lang;<i>integer</i>&rang; starts with &ldquo;<code>-</code>&rdquo; or &ldquo;<code>+</code>&rdquo; &hellip;)
+ <dt><strong><code>-c</code></strong><dd> <strong>(f)</strong>
+Compare date according to <code>\Provides...</code> content with modification
+date using <a href="http://ctan.org/pkg/filedate" target="_blank"><span style="font-family:sans-serif">filedate</span></a> additionally.
+<p>
+<span style="color:red"><acronym>TODO</acronym></span>: The restriction to <span style="font-family:sans-serif">find</span> (v0.7) is temporary, removing it is
+straightforward, but I may have to postpone this for a while.
+ <dt><strong><code>-f</code></strong><dd> <strong>(f)</strong>
+Add &lang;<i>files</i>&rang; to other <strong><span style="font-family:sans-serif">find</span></strong> criteria,
+<strong>replacing</strong> internal default settings
+(as opposed to <code>-g</code>).
+For allowing certain file name extensions such as <code>.tex</code>,
+the star must be escaped and &lang;<i>files</i>&rang; best
+has outer single quotes, such as
+<blockquote>
+
+<code>'-follow ( -name <code>\*</code>.tex -o -name <code>\*</code>.sty )'</code>
+
+</blockquote>
+ <dt><strong><code>-F</code>&nbsp;<code>&lang;<i>find-file</i>&rang;</code></strong><dd> <strong>(f)</strong>
+Add content of the <strong>file</strong> &lang;<i>find-file</i>&rang; to other <strong><span style="font-family:sans-serif">find</span></strong> criteria.
+As compared with <code>-f</code>, stars must be escaped,
+while other quoting seems not to be needed in &lang;<i>files</i>&rang;.
+ <dt><strong><code>-g</code></strong><dd> <strong>(f)</strong>
+Add &lang;<i>files</i>&rang; to other <strong><span style="font-family:sans-serif">find</span></strong> criteria,
+among which some hopefully &ldquo;<strong>generally useful</strong>&rdquo;
+are added from within <span style="font-family:sans-serif">adhocfilelist.sh</span>.
+As to quoting/escaping in &lang;<i>files</i>&rang;,
+this is as with <code>-f</code>.
+ <dt><strong><code>-h</code></strong><dd>
+Display an overview (brief version of present one, &ldquo;<strong>help</strong>&rdquo;),
+and ignore everything else of the command line.
+ <dt><strong><code>-i</code>&nbsp;<code>&lang;<i>tex-file</i>&rang;</code></strong><dd>
+Prepend (&ldquo;<strong>input</strong>&rdquo;) contents of the file &lang;<i>tex-file</i>&rang;
+to the temporary <code>.tex</code> file that <span style="font-family:sans-serif">adhocfilelist.sh</span>
+generates internally&thinsp;&mdash;&thinsp;to get more individual settings
+than <span style="font-family:sans-serif">adhocfilelist.sh</span>&rsquo;s internal defaults
+(which are <strong>replaced</strong> by the content of &lang;<i>tex-file</i>&rang;)
+and than the options <code>-l</code> and <code>-n</code> provide.
+ <dt><strong><code>-l</code>&nbsp;<code>&lang;<i>integer</i>&rang;</code></strong><dd>
+Format list by the <strong><a href="http://ctan.org/pkg/longnamefilelist" target="_blank"><span style="font-family:sans-serif">longnamefilelist</span></a></strong> package
+where &lang;<i>integer</i>&rang; is the maximum length of base
+<a href="http://en.wikipedia.org/wiki/filename" target="_blank">filename</a>s in the list (about as &hellip;)
+ <dt><strong><code>-n</code>&nbsp;<code>&lang;<i>filename</i>&rang;</code></strong><dd>
+Format list by the <strong><a href="http://ctan.org/pkg/nicefilelist" target="_blank"><span style="font-family:sans-serif">nicefilelist</span></a></strong> package
+where &lang;<i>filename</i>&rang; is the longest base <a href="http://en.wikipedia.org/wiki/filename" target="_blank">filename</a> (or a template).
+
+If base filenames do <em>not</em> have more than eight characters,
+you can use &ldquo;<strong><code>-n&nbsp;.</code></strong>&rdquo; as a shorthand for
+&ldquo;<code>-n</code>&nbsp;<code>&lang;<i>filename</i>&rang;</code>&rdquo; with a &lang;<i>filename</i>&rang; of eight characters.
+ <dt><strong><code>-o</code>&nbsp;<code>&lang;<i>txt-file</i>&rang;</code></strong><dd>
+Save the displayed file info list (&ldquo;<strong>output</strong>&rdquo;)
+as plain text file &lang;<i>txt-file</i>&rang; also.
+ <dt><strong><code>-x</code></strong><dd>
+Use <code>xelatex</code> rather than <code>latex</code> (v0.7).&thinsp;&mdash;&thinsp;The
+idea for this has been that the script should provide
+&ldquo;date consistency&rdquo; checks (<strong>option&nbsp;<code>-c</code></strong>)
+&ldquo;even with <a href="http://ctan.org/pkg/xetex" target="_blank"><span style="font-family:sans-serif">XeTeX</span></a> where <code>\pdffilemoddate</code> is not available.&rdquo; However, the script has used <code>latex</code>
+before v0.7 which will run <a href="http://ctan.org/pkg/pdftex" target="_blank"><span style="font-family:sans-serif">pdfTeX</span></a> usually,
+even when the user prefers <em>typesetting</em> with XeTeX,
+and anyway it does not rely on <code>\pdffilemoddate</code>.
+The real problem with <a href="http://ctan.org/pkg/filedate" target="_blank"><span style="font-family:sans-serif">filedate</span></a> and XeTeX is that
+a reliable consistency check does not work
+<em>while typesetting with XeTeX</em>. But <span style="font-family:sans-serif">filedate</span> can be
+used for &ldquo;TeX scripts&rdquo; too, i.e., <em>without</em> typesetting,
+and that is what the present package does.
+The present package does <em>not</em> provide consistency checks
+<em>while typesetting with XeTeX</em>.
+It should not be make a difference whether the &ldquo;TeX script&rdquo;
+that <span style="font-family:sans-serif">adhocfilelist</span> generates is run with XeTeX or with pdfTeX.
+So the only &ldquo;special XeTeX support&rdquo; from here probably
+will be the present <strong><code>-x</code></strong> in case <code>latex</code>
+<em>does not work</em>, maybe because pdfTeX or anything implementing
+the <code>latex</code> command is missing on the user&rsquo;s (unusual) installation.
+
+</dl>
+Options can <em>not</em> be &ldquo;contracted&rdquo; like &ldquo;<code>-0f</code>&rdquo;
+(too difficult with processing [parts of] <span style="font-family:sans-serif">find</span>
+expressions&thinsp;&mdash;&thinsp;<code>-name</code> &hellip;).
+ <dt><strong>&lang;<i>files</i>&rang;<a name="files"></a></strong><dd>
+Whenever an option &ldquo;switches into <span style="font-family:sans-serif"><a href="http://en.wikipedia.org/wiki/find" target="_blank">find</a></span> mode&rdquo;,
+&lang;<i>files</i>&rang; is interpreted as part of a command line for the
+<span style="font-family:sans-serif">find</span> utility. Otherwise, &lang;<i>files</i>&rang; is expected to be a
+comma-separated list of filenames (for LaTeX source files),
+whose extension <code>.tex</code> (if so) may be omitted&thinsp;&mdash;&thinsp;unless <code>-h</code>&nbsp;&hellip;
+
+</dl>
+
+<h2><a name="required"></a>Requirements<a href="#required">.</a></h2>
+<dl>
+ <dt><strong>System</strong><dd>
+The package will work on a <a href="http://en.wikipedia.org/wiki/Unix-like" target="_blank">Unix-like</a> system only,
+but I am not expert enough to judge what additional restrictions hold.
+As I could not make work everything that should work according to
+documentation, I expect the other way round that what works on
+my installation may not work at other Unix-like installations.
+If something doesn&rsquo;t work at your installation, please tell me via
+<a href="http://contact-ednotes.sty.de.vu" target="_blank"><code>contact-ednotes.sty.de.vu</code></a>.
+<p>
+Actually the package was developed with the <a href="http://en.wikipedia.org/wiki/GNU bash" target="_blank">GNU bash</a>
+shell and the
+<a href="http://en.wikipedia.org/wiki/GNU Find Utilities" target="_blank"><abbr>GNU</abbr> <span style="font-family:sans-serif">find</span> utility</a> on
+<a href="http://en.wikipedia.org/wiki/Ubuntu (operating system)" target="_blank">Ubuntu</a>&nbsp;10.04.
+<p>
+My impression is in fact
+(looking at <a href="http://en.wikipedia.org/wiki/The Open Group" target="_blank">The Open Group</a>&rsquo;s
+<a href="http://pubs.opengroup.org/onlinepubs/9699919799/utilities/find.html" target="_blank">man page</a>
+for <span style="font-family:sans-serif">find</span>)
+that in order to use the <strong><span style="font-family:sans-serif">find</span></strong> options
+<strong><code>-0</code></strong>, <strong><code>-a</code></strong>, <strong><code>-f</code></strong>, <strong><code>-F</code></strong>,
+and <strong><code>-g</code></strong>, the <strong><abbr>GNU</abbr></strong> version of <span style="font-family:sans-serif">find</span> is required,
+because action <strong>-printf</strong> is used and essential (difficult without).
+ <dt><strong>LaTeX</strong><dd>
+The package requires that the <a href="http://ctan.org/pkg/fileinfo" target="_blank"><span style="font-family:sans-serif">fileinfo</span></a> bundle is installed.
+In order to use the <strong><code>-l</code></strong> option,
+<a href="http://ctan.org/pkg/longnamefilelist" target="_blank"><span style="font-family:sans-serif">longnamefilelist</span></a> must be installed additionally.
+In order to use the <strong><code>-n</code></strong> option,
+<a href="http://ctan.org/pkg/nicefilelist" target="_blank"><span style="font-family:sans-serif">nicefilelist</span></a> must be installed additionally.
+In order to use the <strong><code>-c</code></strong> option,
+<a href="http://ctan.org/pkg/filedate" target="_blank"><span style="font-family:sans-serif">filedate</span></a> must be installed additionally.
+
+</dl>
+
+<h2><a name="install"></a>Installing<a href="#install">.</a></h2>
+No more advice than implied by the section on &ldquo;<a href="#call">&lang;<i>call</i>&rang;</a>&rdquo;
+can be given right now.
+
+<h2><a name="related"></a>Related packages<a href="#related">.</a></h2>
+The file
+<a href="http://mirror.ctan.org/info/latexfileinfo-pkgs/latexfileinfo_pkgs.htm" target="_blank"><span style="font-family:sans-serif">latexfileinfo_pkgs.htm</span></a>
+describes related packages available on
+
+<abbr><a href="http://en.wikipedia.org/wiki/CTAN" target="_blank">CTAN</a></abbr>
+in some detail.
+The most obvious ones have been mentioned above already.
+
+<p>
+The <a href="#back">next section</a> indicates details that may be
+improve understanding the LaTeX-related command line options
+<code>-i</code>, <code>-l</code>, and <code>-n</code>.
+
+<h2><a name="back"></a>Background<a href="#back">.</a></h2>
+For understanding the options <strong><code>-0</code></strong>, <strong><code>-a</code></strong>,
+<strong><code>-f</code></strong>, <strong><code>-F</code></strong>, and <strong><code>-g</code></strong>,
+knowing something about the <span style="font-family:sans-serif"><a href="http://en.wikipedia.org/wiki/find" target="_blank">find</a></span> utility
+and the present <a href="#back-find">interface</a> to it may be helpful.
+The options <strong><code>-i</code></strong>, <strong><code>-l</code></strong>, <strong><code>-n</code></strong>,
+and <strong><code>-o</code></strong> refer to the <a href="http://ctan.org/pkg/myfilist" target="_blank"><span style="font-family:sans-serif">myfilist</span></a> package
+and its enhancements by the packages <a href="http://ctan.org/pkg/longnamefilelist" target="_blank"><span style="font-family:sans-serif">longnamefilelist</span></a>
+and <a href="http://ctan.org/pkg/nicefilelist" target="_blank"><span style="font-family:sans-serif">nicefilelist</span></a>, and it may be helpful to know
+what a &ldquo;<a href="#my-script"><span style="font-family:sans-serif">myfilist</span> script</a>&rdquo; is.
+<dl>
+ <dt><strong><span style="font-family:sans-serif">find</span><a name="back-find"></a></strong><dd>
+We are describing the <strong>interface</strong> to <span style="font-family:sans-serif"><a href="http://en.wikipedia.org/wiki/find" target="_blank">find</a></span>.
+To learn about the contents of a <span style="font-family:sans-serif">find</span> command line,
+the <a href="http://en.wikipedia.org/wiki/find" target="_blank">Wikipedia article</a> may be a good start,
+next enter &ldquo;<code>man find</code>&rdquo; in the terminal, finally see the
+<a href="http://gnu.org/software/findutils/manual/find.html" target="_blank"><abbr>GNU</abbr> manual</a>.
+<p>
+<span style="font-family:sans-serif">adhocfilelist.sh</span> forms the following <span style="font-family:sans-serif">find</span> command line
+in order to get a comma-separated list of files:
+<blockquote>
+<code>find</code>
+<a href="#back-f-prefix"><code>&lang;<i>prefix</i>&rang;</code></a>
+<a href="#back-f-files"><code>&lang;<i>files</i>&rang;</code></a>
+<a href="#back-f-day"><code>&lang;<i>day</i>&rang;</code></a>
+<code>-printf ,%f</code>
+
+</blockquote>
+These parts are as follows:
+<dl>
+ <dt><strong>&lang;<i>prefix</i>&rang;<a name="back-f-prefix"></a></strong><dd>
+is
+<blockquote>
+<code>-follow -maxdepth 1 ( -name <code>\*</code>.tex -o </code><code>&lang;<i>more</i>&rang;</code><code> )</code>
+
+</blockquote>
+where &lang;<i>more</i>&rang; in addition to files with extension <code>.tex</code> allows
+those with extensions <code>.sty</code>, <code>.cfg</code>, <code>.cls</code>, <code>.dtx</code>,
+<code>.def</code>, and <code>.fd</code>&thinsp;&mdash;&thinsp;<strong>unless</strong> with <strong>options</strong>
+<dl>
+ <dt><strong><code>-f</code></strong><dd>
+where &lang;<i>prefix</i>&rang; is empty
+ <dt><strong><code>-F</code>&nbsp;<code>&lang;<i>find-file</i>&rang;</code></strong><dd>
+where &lang;<i>prefix</i>&rang; is the content of the file &lang;<i>find-file</i>&rang;.
+
+</dl>
+Option <strong><code>-g</code></strong> is not required with options
+<strong><code>-0</code></strong> and <strong>-a</strong> that switch into &ldquo;<strong><span style="font-family:sans-serif">find</span> mode</strong>&rdquo;
+too without deleting &lang;<i>prefix</i>&rang;, it is just a way to switch
+into <span style="font-family:sans-serif">find</span> mode otherwise without deleting &lang;<i>prefix</i>&rang;.
+ <dt><strong>&lang;<i>files</i>&rang;<a name="back-f-files"></a></strong><dd>
+is as in the <a href="#files">overview</a>.
+ <dt><strong>&lang;<i>day</i>&rang;<a name="back-f-day"></a></strong><dd>
+is empty, unless <strong><code>-0</code></strong> sets it to
+<blockquote>
+<code>-daystart&nbsp;-mtime 0</code>
+
+</blockquote>
+or <strong><code>-a</code>&nbsp;<code>&lang;<i>integer</i>&rang;</code></strong> sets it to
+<blockquote>
+<code>-daystart&nbsp;-mtime&nbsp;</code><code>&lang;<i>integer</i>&rang;</code>
+
+</blockquote>
+It follows that
+<ul>
+ </li>
+ <li><strong><code>-0</code></strong> has the same effect as
+(is just a shorthand for) <strong><code>-a&nbsp;0</code></strong>
+ </li>
+ <li>if &lang;<i>integer</i>&rang; is &ldquo;<code>-&lang;<i>digits</i>&rang;</code>&rdquo;,
+files modified <em>since</em> &lang;<i>digits</i>&rang; days ago
+are allowed
+</li>
+</ul>
+&mdash;cf.&nbsp;<abbr>GNU</abbr> documentation on
+<a href="http://gnu.org/software/findutils/manual/html_node/find_html/Age-Ranges.html" target="_blank">age ranges.</a>
+<p>
+A <strong>tricky</strong> little thing here is that &lang;<i>day</i>&rang;
+may be <em>expected</em> to be a <em>restriction</em>,
+an <em>additional</em> criterion that a LaTeX source file
+must meet to be listed. However, if &lang;<i>files</i>&rang; ends on
+<strong><code>-o</code></strong> for &ldquo;or&rdquo;, &lang;<i>day</i>&rang; becomes an
+&ldquo;additional possibility&rdquo; for being listed &hellip;
+<p>
+<span style="color:red"><acronym>TODO</acronym></span>: This is different with <strong>option <code>-c</code></strong>
+(v0.7) whose functionality also may change soon.
+
+</dl>
+ <dt><strong><span style="font-family:sans-serif">myfilist</span><a name="my-script"></a></strong><dd>
+The LaTeX package <a href="http://ctan.org/pkg/myfilist" target="_blank"><span style="font-family:sans-serif">myfilist</span></a> provides some commands
+to control the input of LaTeX&rsquo;s <code>\listfiles</code> so that its
+output is not a list of files used for typesetting,
+but a list of arbitrary files that is determined by commands
+like
+<blockquote>
+<code>\ReadFileInfos</code><code>{</code><code>&lang;<i>comma-separated-list-of-filenames</i>&rang;</code><code>}</code>
+
+</blockquote>
+Essentially this is the command which the list of filenames that
+was &lang;<i>files</i>&rang; or that is produced by <span style="font-family:sans-serif">find</span> is passed to.
+The list is generated by running a <code>.tex</code> file that contains
+these commands. Such a file has been called a
+&ldquo;<strong><span style="font-family:sans-serif">myfilist</span> script</strong>&rdquo; here.
+More precisely, such a script is (mostly) structured as follows:
+<blockquote>
+<a href="#back-load-set">&lang;<i>loading-settings</i>&rang;</a><br>
+<a href="#back-coll-infos">&lang;<i>collecting-infos</i>&rang;</a><br>
+<a href="#back-write">&lang;<i>writing-to-screen+file</i>&rang;</a>
+
+</blockquote>
+These parts are as follows:
+<dl>
+ <dt><strong>&lang;<i>loading-settings</i>&rang;<a name="back-load-set"></a></strong><dd>
+at least issues <code>\RequirePackage</code><code>{</code><code>&lang;<i>myfilist</i>&rang;</code><code>}</code>.
+By default, <span style="font-family:sans-serif">adhocfilelist.sh</span> produces (roughly)
+<blockquote>
+<code>\RequirePackage</code><code>{myfilist}</code><code>\EmptyFileList</code>
+<code>&lang;<i>adhoc-adjust</i>&rang;</code>
+
+</blockquote>
+for &lang;<i>loading-settings</i>&rang; where &lang;<i>adhoc-adjust</i>&rang;
+adds technical details needed for use with <span style="font-family:sans-serif">adhocfilelist</span>.
+(Final warnings are suppressed by a command <code>\NoBottomLines</code>,
+this might be changed in the future.)
+<p>
+It has been a disadvantage of LaTeX&rsquo;s <code>\listfiles</code> functionality
+that the resulting plain text file list looked good with base filenames
+only that had up to eight characters. <a href="http://ctan.org/pkg/longnamefilelist" target="_blank"><span style="font-family:sans-serif">longnamefilelist</span></a>
+made up for this disadvantage, and <a href="http://ctan.org/pkg/nicefilelist" target="_blank"><span style="font-family:sans-serif">nicefilelist</span></a>
+has additional refinements of aligning the list, proposed by
+Martin <a href="http://ctan.org/author/id/muench-hm" target="_blank">M&uuml;nch</a>. To use them with
+<span style="font-family:sans-serif">myfilist</span>, they are loaded in &lang;<i>loading-settings</i>&rang;
+as well, and additional settings for column widths may be added there too.
+This is what <strong>options</strong> <strong><code>-l</code></strong> and <strong><code>-n</code></strong> do.
+Besides in their own <abbr>PDF</abbr> documentation (that you find by following the
+links), the packages are also briefly described in that file
+<a href="http://mirror.ctan.org/info/latexfileinfo-pkgs/latexfileinfo_pkgs.htm" target="_blank"><span style="font-family:sans-serif">latexfileinfo_pkgs.htm</span></a>
+to be read by a web browser.
+<p>
+However, more refined settings may be needed that cannot
+be controlled by <span style="font-family:sans-serif">adhocfilelist</span>&rsquo;s interface so far.
+The <strong>option</strong> <strong><code>-i</code>&nbsp;<code>&lang;<i>tex-file</i>&rang;</code></strong>
+has the effect that &lang;<i>loading-settings</i>&rang; becomes
+<blockquote>
+&lang;<i>tex-file-content</i>&rang;
+&lang;<i>adhoc-adjust</i>&rang;
+
+</blockquote>
+where &lang;<i>tex-file-content</i>&rang; is the content of the
+(<code>.tex</code> file) &lang;<i>tex-file</i>&rang; (before <code>\endinput</code>).
+ <dt><strong>&lang;<i>collecting-infos</i>&rang;<a name="back-coll-infos"></a></strong><dd>
+essentially is that
+<blockquote>
+<code>\ReadFileInfos</code><code>{</code><code>&lang;<i>comma-separated-list-of-filenames</i>&rang;</code><code>}</code>
+
+</blockquote>
+mentioned above.
+ <dt><strong>&lang;<i>writing-to-screen+file</i>&rang;<a name="back-write"></a></strong><dd>
+essentially is <code>\ListFileInfos</code> or
+<blockquote>
+<code>\ListFileInfos</code><code>[</code><code>&lang;<i>txt-file</i>&rang;</code><code>]</code>
+
+</blockquote>
+With <span style="font-family:sans-serif">adhocfilelist</span>, that &ldquo;<code>[</code><code>&lang;<i>txt-file</i>&rang;</code><code>]</code>&rdquo;
+is inserted on <strong>option</strong> <strong><code>-o</code>&nbsp;<code>&lang;<i>txt-file</i>&rang;</code></strong>.
+
+</dl>
+However, <span style="font-family:sans-serif">myfilist</span> has been extended at the occasion
+of preparing <span style="font-family:sans-serif">adhocfilelist</span> so that the sections
+&lang;<i>collecting-infos</i>&rang; and &lang;<i>writing-to-screen+file</i>&rang;
+may &ldquo;collapse&rdquo; into a single command starting with
+<code>\ReadListFileInfos</code>.
+
+</dl>
+
+<h2><a name="custom"></a>General customization<a href="#custom">.</a></h2>
+In general, options <strong><code>-F</code>&nbsp;<code>&lang;<i>find-file</i>&rang;</code></strong> and
+<strong><code>-i</code>&nbsp;<code>&lang;<i>tex-file</i>&rang;</code></strong> will be needed
+to deal with certain directories &lang;<i>dir</i>&rang;.
+Two ways come to my mind how to simplify this situation.
+<ol>
+ </li>
+ <li>&lang;<i>find-file</i>&rang; and &lang;<i>tex-file</i>&rang; may be
+in the same directory &lang;<i>dir</i>&rang;, and the latter may es well
+contain an executable (<code><a href="http://en.wikipedia.org/wiki/chmod" target="_blank">chmod</a></code>)
+script file &lang;<i>script-file</i>&rang;
+with the following content:
+<blockquote>
+<a href="#call"><code>&lang;<i>call</i>&rang;</code></a>
+<code>-F&nbsp;</code><code>&lang;<i>find-file</i>&rang;</code>
+<code>-i&nbsp;</code><code>&lang;<i>tex-file</i>&rang;</code>
+<code>&lang;<i>more</i>&rang;</code>
+<code>$@</code>
+
+</blockquote>
+Here &lang;<i>call</i>&rang; is as in the <a href="#call">overview</a>,
+and &lang;<i>more</i>&rang; may be empty or something else that you
+want to have fixed, such as <strong><code>-o</code>&nbsp;<code>&lang;<i>txt-file</i>&rang;</code></strong>.
+<p>
+<strong>Then</strong> you can <strong>vary</strong> additional options/parameters
+&lang;<i>add</i>&rang; by
+<blockquote>
+<code>./</code><code>&lang;<i>script-file</i>&rang;</code> <code>&lang;<i>add</i>&rang;</code>
+
+</blockquote>
+ </li>
+ <li>If you have <strong>several directories</strong> &lang;<i>dir</i>&rang; as before
+of a certain &ldquo;type&rdquo;,
+such that they can <strong>share</strong> the settings in
+&lang;<i>find-file</i>&rang; and &lang;<i>tex-file</i>&rang;,
+you can place the latter in some separate (&ldquo;central&rdquo;)
+directory &lang;<i>center</i>&rang; and define an <code><a href="http://en.wikipedia.org/wiki/alias" target="_blank">alias</a></code>
+as follows:
+<blockquote>
+
+<code>alias&nbsp;</code><code>&lang;<i>name</i>&rang;</code><code>='</code><a href="#call"><code>&lang;<i>call</i>&rang;</code></a>
+<code>-F&nbsp;</code><code>&lang;<i>center</i>&rang;</code><code>/</code><code>&lang;<i>find-file</i>&rang;</code>
+<code>-i&nbsp;</code><code>&lang;<i>center</i>&rang;</code><code>/</code><code>&lang;<i>tex-file</i>&rang;</code>
+<code>&lang;<i>more</i>&rang;</code><code>'</code>
+
+</blockquote>
+(Note that there is no &ldquo;<code>$@</code>&rdquo;.
+&ldquo;<code>&lang;<i>dir</i>&rang;</code><code>/</code><code>&lang;<i>tex-file</i>&rang;</code>&rdquo; could be replaced by
+mere &ldquo;<code>&lang;<i>tex-file</i>&rang;</code>&rdquo; if that &lang;<i>tex-file</i>&rang;
+is installed like a TeX&nbsp;package.)
+<p>
+<strong>Then</strong> you can <strong>vary</strong> additional options/parameters
+&lang;<i>add</i>&rang; by
+<blockquote>
+<code>&lang;<i>name</i>&rang;</code> <code>&lang;<i>add</i>&rang;</code>
+
+</blockquote>
+</li>
+</ol>
+
+<h2><a name="idea"></a>The idea/motivation; acknowledgements<a href="#idea">.</a></h2>
+One day (most probably 2012-09-27),
+I wanted to check the <code>\ProvideFile</code> contents of <em>two</em>
+files I knew I had edited that day.
+On 2012-09-26, I had thought about simplifying <a href="http://ctan.org/pkg/typeoutfileinfo" target="_blank"><span style="font-family:sans-serif">typeoutfileinfo</span></a>
+by using a single command line without any piping.
+I realized that LaTeX&nbsp;s <code>\typeout</code> could be replaced by
+<code>\ReadFileInfos</code> from <a href="http://ctan.org/pkg/myfilist" target="_blank"><span style="font-family:sans-serif">myfilist</span></a>.
+Therefore &ldquo;<a href="http://en.wikipedia.org/wiki/ad hoc" target="_blank">ad hoc</a>&rdquo;.
+<p>
+Maybe the same day later,
+I realized that I could no longer remember which files I changed that day.
+In July I had discovered <code>$(find ...)</code>. Now I thought that this
+could be used here. &ldquo;Ad hoc&rdquo; is less appropriate here, and first I thought
+that there will be different script files for explicitly specified files
+than for applying <span style="font-family:sans-serif">find</span>.
+<p>
+Only then I learnt real shell programming by googling, kind of chance,
+and most helpfully from Chapter&nbsp;3 of J&uuml;rgen Wolfs
+<a href="http://openbook.galileocomputing.de/shell_programmierung" target="_blank">OpenBook</a>
+from <a href="http://de.wikipedia.org/wiki/Galileo Press" target="_blank">Galileo Press</a>
+(<code><a href="http://en.wikipedia.org/wiki/getopts" target="_blank">getopts</a></code>&thinsp;&mdash;&thinsp;bad here, however)
+and Prof. J&uuml;rgen Plates
+<a href="http://netzmafia.de/skripten/unix/unix8.html" target="_blank">lecture notes</a>
+(&ldquo;Optionen ermitteln&rdquo;&thinsp;&mdash;&thinsp;&ldquo;by hand&rdquo;).
+<p>
+Then quoting/escaping for filename extensions with <span style="font-family:sans-serif"><a href="http://en.wikipedia.org/wiki/find" target="_blank">find</a></span> became difficult &hellip;
+Quotation marks and &ldquo;positional parameters&rdquo; with the shell are very
+difficult/<strong>painful</strong>&thinsp;&mdash;&thinsp;TeX is more straightforward &hellip;
+On the other hand it is nice that the entire command line with <em>all</em> the
+&ldquo;parameters&rdquo; is gobbled.
+
+<hr>
+<p align="right"><i>Last&nbsp;revised&nbsp;2012-10-19 &copy;&nbsp;<a href="http://www.webdesign-bu.de/uwe_lueck/contact.html" target="_blank">Uwe L&uuml;ck</a><br> (using <a href="http://ctan.org/pkg/morehype" target="_blank"><span style="font-family:sans-serif">blog.sty</span></a>)<br> License: <a href="http://www.latex-project.org/lppl/" target="_blank">LPPL&nbsp;1.3c</a> or later, author-maintained.</i></p>
+<p align="right"><a href="#top-of-page">[<i>&rarr;&nbsp;top&nbsp;of&nbsp;page</i>&nbsp;]</a></p>
+
+<table width="" height="240" border="0" cellpadding="0" cellspacing="0"><tbody>
+ <!-- HVspace -->
+ <tr valign="top"><td></td> </tr>
+
+</tbody></table>
+
+</body></html>
+
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/makehtml.log b/Master/texmf-dist/doc/support/adhocfilelist/makehtml.log
new file mode 100644
index 00000000000..bcbab821a91
--- /dev/null
+++ b/Master/texmf-dist/doc/support/adhocfilelist/makehtml.log
@@ -0,0 +1,142 @@
+This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian) (format=latex 2011.11.14) 19 OCT 2012 19:11
+entering extended mode
+ %&-line parsing enabled.
+**makehtml
+(./makehtml.tex
+LaTeX2e <2009/09/24>
+Babel <v3.8l> and hyphenation patterns for english, usenglishmax, dumylang, noh
+yphenation, ngerman, german, german-x-2009-06-19, ngerman-x-2009-06-19, loaded.
+
+File: makehtml.tex 2012/10/19 HTML driver
+(/usr/share/texmf-texlive/tex/latex/nicefilelist/nicefilelist.sty
+Package: nicefilelist 2012/10/03 v0.6 more file list alignment (UL)
+
+(/usr/share/texmf-texlive/tex/latex/monofill/monofill.sty
+Package: monofill 2012/03/19 v0.1a monospace alignment (UL)
+))
+(/usr/share/texmf-texlive/tex/latex/fileinfo/myfilist.sty
+Package: myfilist 2012/10/12 v0.6a \listfiles -- mine only (UL)
+
+(/usr/share/texmf-texlive/tex/latex/fileinfo/readprov.sty
+Package: readprov 2012/03/20 v0.3b file infos without loading (UL)
+)
+\file@of@filelist=\write3
+) (./blog.sty
+Package: blog 2012/10/05 v0.8 simple fast HTML (UL)
+
+(/usr/share/texmf-texlive/tex/latex/nicetext/fifinddo.sty
+Package: fifinddo 2012/08/27 v0.6 filtering TeX(t) files by TeX (UL)
+
+(/usr/share/texmf-texlive/tex/latex/nicetext/stacklet.sty
+(/usr/share/texmf-texlive/tex/generic/plainpkg/plainpkg.tex
+File: plainpkg.tex 2012/09/19 v0.4a plain package management
+)
+Package: stacklet 2012/08/27 v0.3 private letters (UL)
+)
+(/usr/share/texmf-texlive/tex/generic/catcodes/actcodes.sty
+(/usr/share/texmf-texlive/tex/generic/plainpkg/plainpkg.tex)
+Package: actcodes 2012/09/19 v0.2 active characters (UL)
+)
+\result_file=\write4
+\c@fdInputLine=\count79
+\c@fd_line_job=\count80
+)
+(/usr/share/texmf-texlive/tex/latex/nicetext/dowith.sty
+Package: dowith 2012/05/19 v0.21a simple list loop (UL)
+)
+
+Package blog Warning: Redefining \@width on input line 316.
+
+
+Package blog Warning: Redefining \@height on input line 320.
+
+(/usr/share/texmf-texlive/tex/latex/morehype/texlinks.sty
+Package: texlinks 2012/05/13 v0.6 TeX-related links (UL)
+)) (./blogexec.sty
+Package: blogexec 2012/08/29 v0.2 assignments with blog.sty (UL)
+)
+(/usr/share/texmf-texlive/tex/generic/catcodes/catchdq.sty
+(/usr/share/texmf-texlive/tex/generic/plainpkg/plainpkg.tex)
+Package: catchdq 2012/09/20 v0.2 simple typographic dqs (UL)
+)
+(/usr/share/texmf-texlive/tex/generic/langcode/langcode.sty
+(/usr/share/texmf-texlive/tex/generic/plainpkg/plainpkg.tex)
+Package: langcode 2012/09/20 v0.2 language adjustment (UL)
+)
+(/usr/share/texmf-texlive/tex/latex/morehype/atari_ht.fdf
+File: atari_ht.fdf 2012/05/13 Atari umlauts for blog.sty
+) (./texblog.fdf
+File: texblog.fdf 2012/10/06 extra blog settings
+
+(./domore.sty
+Package: domore 2012/08/08 v0.2 dowith extended (UL)
+))
+`fifinddo' generating `adhocfilelist.htm'
+\openout4 = `adhocfilelist.htm'.
+
+`fifinddo' processing `adhocfilelist.tex'
+`fifinddo' closing `adhocfilelist.htm'
+(./makehtml.tex
+File: makehtml.tex 2012/10/19 HTML driver
+) (./adhocfilelist.tex
+File: adhocfilelist.tex 2012/10/17 documenting adhocfilelist (UL)
+) (./filedate.sty
+Package: filedate 2012/10/19 v0.21 check file dates (UL)
+)
+ + makehtml.tex passed date check + + adhocfilelist.tex passed date check +
+(./adhocfilelist.sh
+File: adhocfilelist.sh 2012/10/17 v0.7 command line -> \listfiles (UL)
+) (./srcfiles.tex
+File: srcfiles.tex 2012/10/19 file infos -> SrcFILEs.txt
+) (./adhocfilelist.RLS
+File: adhocfilelist.RLS 2012/10/18 r0.3 RELEASE.txt for v0.7 (-c, -x)
+)
+ + adhocfilelist.sh passed date check + + srcfiles.tex passed date check +
+
+! Package filedate Error: adhocfilelist.RLS has \Provides... date 2012/10/18
+(filedate) vs. modification date 2012/10/19.
+
+See the filedate package documentation for explanation.
+Type H <return> for immediate help.
+ ...
+
+l.30 \CheckDateOfGiven{\htmljob.RLS}
+
+?
+
+ *File List*
+ nicefilelist.sty 2012/10/03 v0.6 more file list alignment (UL)
+ monofill.sty 2012/03/19 v0.1a monospace alignment (UL)
+ myfilist.sty 2012/10/12 v0.6a \listfiles -- mine only (UL)
+ readprov.sty 2012/03/20 v0.3b file infos without loading (UL)
+ blog.sty 2012/10/05 v0.8 simple fast HTML (UL)
+ fifinddo.sty 2012/08/27 v0.6 filtering TeX(t) files by TeX (UL)
+ stacklet.sty 2012/08/27 v0.3 private letters (UL)
+ actcodes.sty 2012/09/19 v0.2 active characters (UL)
+ dowith.sty 2012/05/19 v0.21a simple list loop (UL)
+ texlinks.sty 2012/05/13 v0.6 TeX-related links (UL)
+ blogexec.sty 2012/08/29 v0.2 assignments with blog.sty (UL)
+ catchdq.sty 2012/09/20 v0.2 simple typographic dqs (UL)
+ langcode.sty 2012/09/20 v0.2 language adjustment (UL)
+ atari_ht.fdf 2012/05/13 -- Atari umlauts for blog.sty
+ texblog.fdf 2012/10/06 -- extra blog settings
+ domore.sty 2012/08/08 v0.2 dowith extended (UL)
+ makehtml.tex 2012/10/19 -- HTML driver
+adhocfilelist.tex 2012/10/17 -- documenting adhocfilelist (UL)
+ filedate.sty 2012/10/19 v0.21 check file dates (UL)
+adhocfilelist.sh 2012/10/17 v0.7 command line -> \listfiles (UL)
+ srcfiles.tex 2012/10/19 -- file infos -> SrcFILEs.txt
+adhocfilelist.RLS 2012/10/18 -- r0.3 RELEASE.txt for v0.7 (-c, -x)
+ ***********
+
+ )
+Here is how much of TeX's memory you used:
+ 991 strings out of 495022
+ 13237 string characters out of 1181057
+ 56304 words of memory out of 3000000
+ 4200 multiletter control sequences out of 15000+50000
+ 3640 words of font info for 14 fonts, out of 3000000 for 9000
+ 28 hyphenation exceptions out of 8191
+ 33i,1n,31p,301b,146s stack positions out of 5000i,500n,10000p,200000b,50000s
+
+No pages of output.