summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-11-22 00:51:36 +0000
committerKarl Berry <karl@freefriends.org>2012-11-22 00:51:36 +0000
commit7091f02f114d34ab2164074d16106b9e9b4e8bb4 (patch)
treeb7015b4d037854b112819fafcd5679d8d5cc68c9 /Master/texmf-dist/doc/support
parentac225c92964fc1f94322e26a4edc729528882bcb (diff)
adhocfilelist (21nov12)
git-svn-id: svn://tug.org/texlive/trunk@28326 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/README55
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/RELEASEs.txt (renamed from Master/texmf-dist/doc/support/adhocfilelist/RELEASE.txt)10
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt24
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm296
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/demo/herelist.txt1
-rw-r--r--Master/texmf-dist/doc/support/adhocfilelist/makehtml.log142
6 files changed, 228 insertions, 300 deletions
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/README b/Master/texmf-dist/doc/support/adhocfilelist/README
new file mode 100644
index 00000000000..5634b892fff
--- /dev/null
+++ b/Master/texmf-dist/doc/support/adhocfilelist/README
@@ -0,0 +1,55 @@
+
+ README for the `adhocfilelist' package
+ -- \listfiles entries from command line --
+ (C) Uwe Lueck 2012/10/17
+
+`adhocfilelist.sh' is a shell script to display a list of LaTeX
+\Provides... contents on screen. Parameters can be either a list
+of comma-separated file names or criteria for the Unix `find'
+utility, especially to restrict the list to LaTeX source files
+modified <digits> days ago, such as "today". Command line options
+provide interfaces to the find utility and to packages `myfilist',
+`longnamefilelist', `nicefilist', and `filedate' for accessing and
+aligning those file informations and for adding a test of "date
+consistency" (even with XeTeX where \pdffilemoddate is unavailable).
+
+REQUIRED: This works on Unix-like systems only, and probably the
+ GNU version of `find' is required. The LaTeX bundle `fileinfo'
+ must be installed, and full functionality requires the LaTeX
+ packages `longnamefilelist', `nicefilelist', and `filedate'.
+
+RELATED PACKAGES: Apart from what has been mentioned above,
+ `latexfileversion', `typeoutfileinfo', and `ltxfileinfo' are
+ related in that they are somewhat extended to a
+ "multiplicity" of files whose infos are displayed.
+
+DOCUMENTATION: The manual `adhocfilelist.htm' can be read by a
+ web browser, and the command line option `-h' provides an
+ abridged version of it.
+
+KEYWORDs: Package management, document versions.
+
+LICENSE: The script file `adhocfilelist.sh' and the documentation
+ files `adhocfilelist.htm' and `adhocfilelist.tex' 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
+
+ There is NO WARRANTY, indeed this still is somewhat experimental.
+
+The `adhocfilelist' package is author-maintained in the sense of
+the license.
+
+The latest public version of the package is available at
+
+ http://mirror.ctan.org/support/adhocfilelist/
+
+A TDS version of the package is available as
+
+ http://mirror.ctan.org/install/support/adhocfilelist.tds.zip
+
+Please report bugs, problems, and suggestions via
+
+ http://www.contact-ednotes.sty.de.vu
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/RELEASE.txt b/Master/texmf-dist/doc/support/adhocfilelist/RELEASEs.txt
index 49ce3f4a9cb..b6a686fbde2 100644
--- a/Master/texmf-dist/doc/support/adhocfilelist/RELEASE.txt
+++ b/Master/texmf-dist/doc/support/adhocfilelist/RELEASEs.txt
@@ -28,3 +28,13 @@ UPLOAD r0.3 (2012-10-19):
* \listfiles in makehtml.tex (HTML driver) more careful,
using `nicefilelist', for comparison with SrcFILEs.txt
+UPLOAD r0.4 (2012-11-20):
+
+ * deprecated -follow replaced by -L
+ * `adhocfilelist.RLS' provides a release summary with
+ `typeoutfileinfo', appearing in SrcFILEs.txt too.
+ [was announced earlier, but not carried out
+ -- may worry Karl]
+ * using `fdatechk.tex'
+ * TDS: texmf/source/support/adhocfilelist, cf. `texdef'
+
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt b/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt
index 1678576985b..febd5e46d27 100644
--- a/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt
+++ b/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt
@@ -1,19 +1,21 @@
*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)
+adhocfilelist.sh 2012/11/19 v0.71 command line -> \listfiles (UL)
+ herelist.sh 2012/10/15 -- customize adhocfilelist
+adhocfilelist.tex 2012/11/19 -- documenting adhocfilelist (UL)
+ makehtml.tex 2012/11/20 -- HTML driver
+ fdatechk.tex 2012/11/20 -- `filedate' checks
+ srcfiles.tex 2012/11/20 -- file infos -> SrcFILEs.txt
+ ----RELEASE.--- -- -- -- -- ----
+adhocfilelist.RLS 2012/11/20 r0.4 v0.71: -follow -> -L; fdatechk.tex, .RLS
HTML_packages.--- -- -- -- -- ----
- blog.sty 2012/10/05 v0.8 simple fast HTML (UL)
+ blog.sty 2012/11/19 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
+ domore.sty 2012/11/19 v0.3 dowith extended (UL)
+ fifinddo.sty 2012/11/17 v0.61 filtering TeX(t) files by TeX (UL)
+ texblog.fdf 2012/11/20 -- (11/15) extra blog settings
***********
- List made at 2012/10/19, 19:54
+ List made at 2012/11/20, 15:52
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
index 9bd63c2dc07..0aa80e2be40 100644
--- a/Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm
+++ b/Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm
@@ -1,15 +1,15 @@
<!DOCTYPE html>
<!-- generated from
- adhocfilelist.tex, 2012/10/17 documenting adhocfilelist (UL),
+ adhocfilelist.tex, 2012/11/19 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">
+ with blog.sty, 2012-11-20 -->
+<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>
+<a name="top-of-page"></a>
@@ -24,20 +24,20 @@
<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;]
+[&#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
+<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>,
@@ -47,55 +47,55 @@ 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
+(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>
+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
+<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>.
+<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
+<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>
+<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>
+ <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>
+ <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>,
+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>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>
+ <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;,
+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).
+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>
@@ -105,12 +105,12 @@ 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.
+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
+<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,
+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>,
@@ -118,17 +118,18 @@ 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>
+<code>'-L ( -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.
+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,
+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>.
+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>
@@ -136,18 +137,18 @@ Display an overview (brief version of present one, &ldquo;<strong>help</strong>&
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>
+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
+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
+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;)
+<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).
+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
@@ -159,19 +160,19 @@ as plain text file &lang;<i>txt-file</i>&rang; also.
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,
+&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
+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
+<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.
+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
@@ -179,104 +180,105 @@ the <code>latex</code> command is missing on the user&rsquo;s (unusual) installa
</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>
+(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;,
+ <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
+<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>
+<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,
+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>.
+<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>
+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.
+<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
+(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,
+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.
+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.
+<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.
+<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.
+<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;
+<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>
+<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>
+<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>
+<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
+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>
+<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.
+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.
+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,
+ <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>.
+<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
+<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>
+<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>
+ <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>
+<code>-L -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
@@ -290,12 +292,12 @@ where &lang;<i>prefix</i>&rang; is the content of the file &lang;<i>find-file</i
</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;
+<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>
+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>
@@ -318,7 +320,7 @@ 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>
+<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>,
@@ -327,12 +329,12 @@ 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>
+<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
+ <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
@@ -342,48 +344,48 @@ like
</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.
+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.
+&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>
+<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>
+ <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)
+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>.
+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>
+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;
+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>
+<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.
+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>
@@ -393,32 +395,32 @@ has the effect that &lang;<i>loading-settings</i>&rang; becomes
</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>
+ <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>
+ <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;
+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
+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>
+<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;.
@@ -427,18 +429,18 @@ Two ways come to my mind how to simplify this situation.
</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>)
+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>
+<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>,
+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>
@@ -454,11 +456,11 @@ 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>
+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>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>
@@ -478,41 +480,41 @@ is installed like a TeX&nbsp;package.)
</li>
</ol>
-<h2><a name="idea"></a>The idea/motivation; acknowledgements<a href="#idea">.</a></h2>
+<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>
+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;.
+<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>.
+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)
+<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>
+<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;
+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>
+<p align="right"><i>Last&nbsp;revised&nbsp;2012-11-20 &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 -->
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/demo/herelist.txt b/Master/texmf-dist/doc/support/adhocfilelist/demo/herelist.txt
new file mode 100644
index 00000000000..ace621c03f6
--- /dev/null
+++ b/Master/texmf-dist/doc/support/adhocfilelist/demo/herelist.txt
@@ -0,0 +1 @@
+-follow -daystart -maxdepth 1 ( -name \*.tex -o -name \*.sty -o -name \*.cfg -o -name \*.fdf ) ! -name jobname.tex ! -name hallo\*.tex ! -name \*gullet.tex
diff --git a/Master/texmf-dist/doc/support/adhocfilelist/makehtml.log b/Master/texmf-dist/doc/support/adhocfilelist/makehtml.log
deleted file mode 100644
index bcbab821a91..00000000000
--- a/Master/texmf-dist/doc/support/adhocfilelist/makehtml.log
+++ /dev/null
@@ -1,142 +0,0 @@
-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.