fileinfo 0.6a (15oct12

git-svn-id: svn://tug.org/texlive/trunk@27973 c570f23f-e606-0410-a88d-b1316a301751

8 files changed, 209 insertions, 52 deletions

diff --git a/Master/texmf-dist/doc/latex/fileinfo/CONTENTs.txt b/Master/texmf-dist/doc/latex/fileinfo/CONTENTs.txt
index c9f1402adda..58f32907438 100644
--- a/Master/texmf-dist/doc/latex/fileinfo/CONTENTs.txt
+++ b/Master/texmf-dist/doc/latex/fileinfo/CONTENTs.txt
@@ -1,14 +1,22 @@
 
  *File List*
+-RELEASE.---    ----------
+fileinfo.RLS    2012/10/12 r0.6 myfilist v0.6a, correcting r0.5
+-----USE.---    ----------
 readprov.sty    2012/03/20 v0.3b file infos without loading (UL)
-myfilist.sty    2012/05/26 v0.4 \listfiles -- mine only (UL)
+myfilist.sty    2012/10/12 v0.6a \listfiles -- mine only (UL)
+-----DOC.---    ----------
 readprov.tex    2012/03/18 documenting readprov.sty
-myfilist.tex    2012/03/18 documenting myfilist.sty
+myfilist.tex    2012/10/12 documenting myfilist.sty
+----USED.---    ----------
   README.tex    2012/03/18 make README.pdf
-  gather.tex    2012/05/26 collect file infos
-fileinfo.RLS    2012/05/26 r0.4 myfilelist v0.4: options
+ makedoc.cfg    2012/07/13 documentation settings
+fifinddo.sty    2012/08/27 v0.6 filtering TeX(t) files by TeX (UL)
+ makedoc.sty    2012/08/28 v0.52 TeX input from *.sty (UL)
+niceverb.sty    2012/09/27 v0.5 minimize doc markup (UL)
+  gather.tex    2012/10/12 collect file infos
  ***********
 
- List made at 2012/05/26, 19:38
+ List made at 2012/10/12, 16:02
  from script file gather.tex
 
diff --git a/Master/texmf-dist/doc/latex/fileinfo/RELEASE.txt b/Master/texmf-dist/doc/latex/fileinfo/RELEASE.txt
index 617b62e850e..2671486928e 100644
--- a/Master/texmf-dist/doc/latex/fileinfo/RELEASE.txt
+++ b/Master/texmf-dist/doc/latex/fileinfo/RELEASE.txt
@@ -15,12 +15,35 @@ present file (2012/03/16). Resuming work 2012/03/18, we use
 `readprov.tex', add TDS-info to README, remove outdated `makedoc.cfg', 
 and move `gather.tex' to `docsrc'.
 
-r0.4 provides `myfilist.sty' v0.4 that allows reentering a package 
-after \EmptyFileList, even when it has been loaded with an option 
-before; mainly for the `nicefilelist' package:
+r0.4 (2012/05/26) provides `myfilist.sty' v0.4 that allows reentering 
+a package after \EmptyFileList, even when it has been loaded with an 
+option before; mainly for the `nicefilelist' package:
 
     \RequirePackage[r]{nicefilelist}
     \RequirePackage{myfilist}
     \EmptyFileList[nicefilelist.sty]
 
-UL 2012/05/26
+r0.5 (2012/10/11) provided `myfilist.sty' v0.6 with a trick 
+\FileListRemark  to insert "comments" in the file list, a hook 
+\ListGenerator   to support `adhocfilelist', and 
+\NoBottomLines   to suppress final messages, 
+also issued by the new package option [no-bot]
+
+But moreover, it provided `myfilist.sty' v0.5 as of 2012/09/27 
+which I failed to upload. v0.5 brought \ReadListFileInfos, 
+\WriteFileList, \ReadListFileInfos, and \UseFindUtility for 
+the `adhocfilelist' package, or something else like that. 
+I had thought that \WriteFileList could be useful, and it 
+could perhaps with the -i option of `adhocfilelist'. 
+r0.5 did announce `v0.5' literally, but described v0.6. 
+Good that it hasn't been processed ...
+
+r0.6 (2012/10/12) corrects this, i.e., the present file is 
+corrected and updated, and the announcement is corrected. 
+And `myfilist' v0.6a is provided where \UseFindUtility is 
+added to the version history. Moreover, `readprov.pdf' has 
+been typeset anew just to apply changes in `nicetext' and 
+to avoid worrying in the future when I would not remember 
+the problem (.aux files need to be removed, that's it).
+-- Actually, I have modified `gather.tex' finally in order 
+to have the *.sty's and `fileinfo.RLS' in adjacent lines.
diff --git a/Master/texmf-dist/doc/latex/fileinfo/myfilist.pdf b/Master/texmf-dist/doc/latex/fileinfo/myfilist.pdf
index e305bb3d918..a264ac488c6 100644
--- a/Master/texmf-dist/doc/latex/fileinfo/myfilist.pdf
+++ b/Master/texmf-dist/doc/latex/fileinfo/myfilist.pdf
diff --git a/Master/texmf-dist/doc/latex/fileinfo/readprov.pdf b/Master/texmf-dist/doc/latex/fileinfo/readprov.pdf
index d3db1ea2a9d..7315c4d10f4 100644
--- a/Master/texmf-dist/doc/latex/fileinfo/readprov.pdf
+++ b/Master/texmf-dist/doc/latex/fileinfo/readprov.pdf
diff --git a/Master/texmf-dist/source/latex/fileinfo/gather.tex b/Master/texmf-dist/source/latex/fileinfo/gather.tex
index 8dda6e542eb..15c29200598 100644
--- a/Master/texmf-dist/source/latex/fileinfo/gather.tex
+++ b/Master/texmf-dist/source/latex/fileinfo/gather.tex
@@ -1,9 +1,14 @@
-\RequirePackage{myfilist}
-\ProvidesFile{gather.tex}[2012/05/26 collect file infos]
+\ProvidesFile{gather.tex}[2012/10/12 collect file infos]
+\RequirePackage[no-bot]{myfilist}
 \EmptyFileList[readprov.sty,myfilist.sty]
+\FileListRemark[----------]{-RELEASE.---}
+\ReadFileInfos{fileinfo.RLS}
+\FileListRemark[----------]{-----USE.---}
 \ReadPackageInfos{readprov,myfilist}
-\ReadFileInfos{readprov,myfilist,README.tex}%%%,makedoc.cfg}
-% \ReadPackageInfos{fifinddo,makedoc,niceverb}
+\FileListRemark[----------]{-----DOC.---}
+\ReadFileInfos{readprov,myfilist}
+\FileListRemark[----------]{----USED.---}
+\ReadFileInfos{README.tex,makedoc.cfg}
+\ReadPackageInfos{fifinddo,makedoc,niceverb}
 \ReadFileInfos{gather}
-\ReadFileInfos{fileinfo.RLS}                    %% 2012/05/26 
 \ListInfos[CONTENTs.txt]
diff --git a/Master/texmf-dist/source/latex/fileinfo/myfilist.tex b/Master/texmf-dist/source/latex/fileinfo/myfilist.tex
index a1aa990ebbf..b61c9c4ad30 100644
--- a/Master/texmf-dist/source/latex/fileinfo/myfilist.tex
+++ b/Master/texmf-dist/source/latex/fileinfo/myfilist.tex
@@ -1,4 +1,4 @@
-\ProvidesFile{myfilist.tex}[2012/03/18 documenting myfilist.sty]
+\ProvidesFile{myfilist.tex}[2012/10/12 documenting myfilist.sty]
 \title{\textsf{myfilist}\\---\\
        List Infos on just the Files\\You Want to Know About%
        \GetFileInfo{myfilist.sty}\thanks{%
@@ -13,33 +13,35 @@
 % \MainDocParser{\ProcessInputWith{PScomment}}
 %% Replacements:
 \SetPatternCodes{\MakeOther\\\MakeOther\ } %% CARE!
-\MakeExpandableAllReplacer{LaTeX2e}{LaTeX2e }{\LaTeXe }{LEAVE}
-% \MakeExpandableAllReplacer{TeX}{\TeX }{\TeX{} }{LEAVE}
-\PrependExpandableAllReplacer{log}{ .log}{ `.log'} 
-\PrependExpandableAllReplacer{tex}{ .tex}{ `.tex'} 
-\PrependExpandableAllReplacer{cls}{ .cls}{ `.cls'} 
-\PrependExpandableAllReplacer{sty}{ .sty}{ `.sty'} 
-\PrependExpandableAllReplacer{NOTE}{NOTE: }{\textbf{Note: }} 
+\MakeExpandableAllReplacer{TeX}{TeX }{\TeX{} }{LEAVE}   %% 2012/09/28
+% \let\do\PrependExpandableAllReplacer                    %% 2012/09/28
+\newcommand*{\do}{\PrependExpandableAllReplacer*}       %% 2012/10/11
+\do{LaTeX }{\LaTeX{} } 
+\do{LaTeX2e }{\LaTeXe{} } 
+\do{ .log}{ `.log'} 
+\do{ .tex}{ `.tex'} 
+\do{ .cls}{ `.cls'} 
+\do{ .sty}{ `.sty'} 
+\do{NOTE: }{\textbf{Note: }} 
 \SetPatternCodes{\MakeOther\\}             %% less care needed 
-\PrependExpandableAllReplacer{dots}{...}{$\dots$} 
-\PrependExpandableAllReplacer{provf}{\ProvidesFile}{`\ProvidesFile'} 
-\PrependExpandableAllReplacer{loads}{"loads"}{``loads''} 
-\PrependExpandableAllReplacer{USAGE}{USAGE:}{\section{Usage}} 
-\PrependExpandableAllReplacer{IMPLEM}
-                             {IMPLEMENTATION:}{\section{Implementation}} 
-\PrependExpandableAllReplacer{gather}
-                             {gather.tex}{`gather.tex'}
-\PrependExpandableAllReplacer{readprov.pdf}
-                             {readprov.pdf}{`readprov.pdf'}
-\PrependExpandableAllReplacer{readprov-}    %% 2010/11/26
-                             {readprov-.sty}{readprov.sty}
-\PrependExpandableAllReplacer{readprov}
-                             {readprov.sty}{'readprov.sty'}
-\PrependExpandableAllReplacer{myfilist-}    %% 2010/11/26
-                             {myfilist-.sty}{myfilist.sty} 
-\PrependExpandableAllReplacer{myfilist}
-                             {myfilist.sty}{'myfilist.sty'} 
-\PrependExpandableAllReplacer{rungather}[\MakeOther\ ]%
+\do{...}{$\dots$} 
+\do{\ProvidesFile}{`\ProvidesFile'} 
+\do{"loads"}{``loads''} 
+\do{USAGE:}{\section{Usage}} 
+\do{TRICKS:}{\section{Tricks, Package Option}} 
+%% 2012/09/28 for v0.5, generation support:
+\do{VARIANTS:}{\section{Variants}} 
+% \do{<txt-file>}{\MetaVar{txt-file}}     %% 2012/09/28
+\do{IMPLEMENTATION:}{\section{Implementation}} 
+\do{gather.tex}{`gather.tex'}
+\do{readprov.pdf}{`readprov.pdf'}
+\do{readprov-.sty}{readprov.sty}            %% 2010/11/26
+\do{readprov.sty}{'readprov.sty'}
+\do{myfilist-.sty}{myfilist.sty}            %% 2010/11/26
+\do{myfilist.sty}{'myfilist.sty'}           %% 2012/09/28
+\do{ifnextok.sty}{'ifnextok.sty'} 
+\do{adhocfilelist}{'adhocfilelist'} 
+\do[\MakeOther\ ]%
 {run gather.tex}{\emph{run} gather.tex}
   %% <- TODO \PrependStandardEnhancement...
 \SetCorrectHookJobLast
@@ -53,14 +55,15 @@
 % \MakeJobDoc{0}{\ProcessInputWith{PScomment}}
 
 %% Typesetting:
-\documentclass{article}
+\documentclass{article} 
 \usepackage{color} %% for highlighting package version!? TODO
 \input{makedoc.cfg}
 \ReadPackageInfos{myfilist}
 \usepackage{wiki}
 %% TeX markup inserted by the txt-to-TeX function must be 
 %% declared here for using 'niceverb''s ``auto mode". 
-\AddToNoVerbList{\LaTeXe\dots\textbf\emph}
+\AddToNoVerbList{\LaTeXe\dots\textbf\emph
+                 \TeX\LaTeX}                %% 2012/09/28
 \begingroup \MakeActive\" 
  \gdef\fineDQ{``\begingroup
    \let\do\MakeOther \dospecials \tt
@@ -119,8 +122,9 @@ putting it somewhere where \TeX\ finds it
 \section{File Info Header}
 
 \sloppy 
-\wikiEnvironments %% TODO fails with "or" 2010/03/31
-\MakeActiveLetHere\"\fineDQ %% fails with "loads"
+\enlargethispage{.5\baselineskip}            %% 2012/10/12
+\wikiEnvironments       %% TODO fails with "or" 2010/03/31
+\MakeActiveLetHere\"\fineDQ  %% fails with "loads"
 \AutoCmdInput{myfilist.doc}
 \nowikiEnvironments
 
diff --git a/Master/texmf-dist/tex/latex/fileinfo/fileinfo.RLS b/Master/texmf-dist/tex/latex/fileinfo/fileinfo.RLS
index f7ede438b03..2180af2d397 100644
--- a/Master/texmf-dist/tex/latex/fileinfo/fileinfo.RLS
+++ b/Master/texmf-dist/tex/latex/fileinfo/fileinfo.RLS
@@ -1,4 +1,6 @@
 \ProvidesFile{fileinfo.RLS}     %% RELEASE INFO
-    [2012/05/26 r0.4 myfilelist v0.4: options]
+    [2012/10/12 r0.6 myfilist v0.6a, correcting r0.5]
+   [{2012/10/11 r0.5 myfilist v0.5f.: fake entries, [no-bot]}]
+    [2012/05/26 r0.4 myfilist v0.4: options]
     [2012/03/18/20 r0.3b+ internal!?]  %% 2012/05/26
     [2012/03/18/18 r0.3b doc. (generation) mod.s]  %% 2012/05/26
diff --git a/Master/texmf-dist/tex/latex/fileinfo/myfilist.sty b/Master/texmf-dist/tex/latex/fileinfo/myfilist.sty
index 07e6f74b285..355bb29d1cf 100644
--- a/Master/texmf-dist/tex/latex/fileinfo/myfilist.sty
+++ b/Master/texmf-dist/tex/latex/fileinfo/myfilist.sty
@@ -3,7 +3,7 @@
 %% modifies \listfiles to choose files to be listed and 
 %% list them in a chosen file. 
 
-\def \fileversion {0.4}     \def \filedate {2012/05/26} 
+\def \fileversion {0.6a}     \def \filedate {2012/10/12} 
 
 %% copyright (C) 2008, 2010, 2011, 2012 Uwe Lueck, 
 %% http://www.contact-ednotes.sty.de.vu 
@@ -81,8 +81,66 @@
 % informations, but quits them as soon as it has found one of these
 % LaTeX2e commands. 
 %
+% VARIANTS:
+%
+% v0.5 provides different interfaces to reduce (shared) TeX code 
+% when (similar) shell or batch scripts generate that gather.tex. 
+%
+%     \ReadListFileInfos[<txt-file>]{<tex-files>} 
+%
+% is a shorthand for 
+% 
+%     \ReadFileInfos{<tex-files>}
+%     \ListInfos[<txt-file>]
+%
+% \emph{Without} the optional argument, the screen output is \emph{not}
+% written to disk---by default. However, preceding \ReadListFileInfos
+% by 
+% 
+%     \WriteFileInfosTo{<txt-file>}
+%
+% is an alternative way to get the list in the plain text file. 
+%
+%     \FindReadListFileInfos[<txt-file>]{<tex-files>} 
+%
+% must be used rather than \ReadListFileInfos\ when the comma-separated 
+% list (generated by the "find" utility) \emph{starts} with a comma.
+% Alternatively, 
+%
+%     \UseFindUtility
+%
+% preceding \ReadListFileInfos deals with the leading comma.
+%
+% TRICKS:
+% 
+% v0.6 first provides (e.g.)
+%
+%     \FileListRemark[----]{---DOC.---}
+%
+% in order to insert `---DOC.---  ----' in the list. This writes 
+% funny files that may be somewhat dangerous ...
+% I have used a bash script version of this for structuring 
+% large file lists.
+%
+% v0.6 moreover provides two hooks and a package option 
+% useful for the adhocfilelist package, 
+% or perhaps even otherwise.
+%
+%     \ListGenerator
+%
+% is a hook for the final lines in the plain text output file (see implementation).
+%
+%     \NoBottomLines
+%
+% suppresses final messages of the LaTeX run, which may be nicer and 
+% more informative on the screen. Package Option
+%
+%     [no-bot]
+%
+% is a kind of shorthand to issue \NoBottomLines.
+%
 % IMPLEMENTATION: 
-
+%
 \NeedsTeXFormat{LaTeX2e}[1994/12/01] %% \newcommand* etc. 
 \ProvidesPackage{myfilist}
                 [\filedate\space v\fileversion \space 
@@ -102,7 +160,7 @@
 % |\ListInfos[<external output file>]|
 \newcommand*{\ListInfos}[1][]{%
   \ifx$#1$\@dofilelist\else
-    \newwrite\file@of@filelist
+    % \newwrite\file@of@filelist                %% mv. v0.6
     \immediate\openout\file@of@filelist=#1\relax
     \def\typeout##1{%
       \read@@typeout{##1}%
@@ -114,14 +172,65 @@
     \multiply\count@ 60  \advance\@tempcntb -\count@ 
     \typeout{ List made at
       \the\year/\two@digits{\the\month}/\two@digits{\the\day},
-      \two@digits{\the\@tempcnta}:\two@digits{\the\@tempcntb}^^J
-      from script file \jobname.tex^^J}%% TODO ".tex"!? 2008/03/19
+      \two@digits{\the\@tempcnta}:\two@digits{\the\@tempcntb}%
+% v0.6 becomes more flexible here:
+      \ListGenerator}
     \immediate\closeout\file@of@filelist
   \fi
   \stop}
   %% <- TODO how to suppress first empty line? 2008/03/16
-  %% -> TODO more general style of output file 2008/03/19
+\newwrite\file@of@filelist                      %% mv. v0.6
+% emulating versions before v0.6:
+\providecommand*{\ListGenerator}{%
+    ^^J from script file \jobname.tex^^J}
 \let\read@@typeout\typeout
+% v0.5:
+%
+% There is a little (design) bug in \ListInfos: 
+% When gather.tex's last line is \ListInfos without optional 
+% argument or anything, LaTeX prompts for further input. 
+% This might be fixed using ifnextok.sty, but I am not sure 
+% right now. In |\VarListInfos|, \relax stops waiting for 
+% input. \providecommand means that the default can be 
+% overridden before loading myfilist.sty:
+\providecommand*{\VarListInfos}{\ListInfos\relax}
+% |\WriteFileInfosTo{<txt-file>}| overrides the previous default:
+\newcommand*{\WriteFileInfosTo}[1]{%
+    \renewcommand\VarListInfos{\ListInfos[#1]}}
+% |\ReadListFileInfos[<txt-file>]{<tex-files>}|
+\newcommand*{\ReadListFileInfos}[2][]{%
+    \ifx$#1$\else\WriteFileInfosTo{#1}\fi
+    \read@comma@guard\read@list@file@infos#2\stop}
+\let\read@comma@guard\@empty
+\def\read@list@file@infos#1\stop{%
+% Here |\VarListInfos| is used finally:
+    \ReadFileInfos{#1}\VarListInfos}
+% |\UseFindUtility| activates \read@comma@guard in order 
+% to kill a leading comma:
+\newcommand*{\UseFindUtility}{%
+    \let\read@comma@guard\@firstoftwo}
+% |\FindReadListFileInfos[<txt-file>]{<tex-files>}|
+\newcommand*{\FindReadListFileInfos}{%
+    \UseFindUtility\ReadListFileInfos}
+% v0.6:
+%
+% |\FileListRemark[<info>]{<filename>}| \
+% writes and reads a dummy file <filename> with \Provides... 
+% content <info> which is empty by default:
+\newcommand*\FileListRemark[2][]{%
+    \immediate\openout\file@of@filelist#2
+    \immediate\write\file@of@filelist{%
+        \string\ProvidesFile{#2}[#1]}%
+    \immediate\closeout\file@of@filelist
+    \ReadFileInfos{#2}}
+% 
+% |\NoBottomLines|
+\newcommand*{\NoBottomLines}{%
+    \let\STOP\stop \def\stop{\batchmode\STOP}}
+% Package option |[no-bot]|:
+\DeclareOption{no-bot}{\NoBottomLines}
+\ProcessOptions
+% Finally issuing |\listfiles| (already before v0.5):
 \listfiles
 
 \endinput 
@@ -140,3 +249,9 @@ v0.3    2010/11/26  split off from "myfiles.sty", opt. arg. for
 v0.3a   2011/01/29  two empty lines commented out
         2011/01/30  copyright updated
 v0.4    2012/05/26  \EmptyFileList clears options
+v0.5    2012/09/27  \ReadListFileInfos, \WriteFileList, 
+                    \FindReadListInfos, \UseFindUtility
+v0.6    2012/10/11  \FileListRemark, \ListGenerator, 
+                    \NoBottomLines, [no-bot]
+v0.6a   2012/10/12  adding \UseFindUtility and \FindReadListInfos 
+                    in the history for v0.5