summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-10-15 17:39:58 +0000
committerKarl Berry <karl@freefriends.org>2012-10-15 17:39:58 +0000
commit194dbf928abdd659520679ca4c448b78c0f94c4b (patch)
tree32bf7ad3e30c47514238b6a791dddcd08bc69d9d
parent37aa0ee26efa7d88f12c32ebfcae8b1078dfc9f5 (diff)
fileinfo 0.6a (15oct12
git-svn-id: svn://tug.org/texlive/trunk@27973 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/fileinfo/CONTENTs.txt18
-rw-r--r--Master/texmf-dist/doc/latex/fileinfo/RELEASE.txt31
-rw-r--r--Master/texmf-dist/doc/latex/fileinfo/myfilist.pdfbin293328 -> 309179 bytes
-rw-r--r--Master/texmf-dist/doc/latex/fileinfo/readprov.pdfbin290632 -> 290577 bytes
-rw-r--r--Master/texmf-dist/source/latex/fileinfo/gather.tex15
-rw-r--r--Master/texmf-dist/source/latex/fileinfo/myfilist.tex66
-rw-r--r--Master/texmf-dist/tex/latex/fileinfo/fileinfo.RLS4
-rw-r--r--Master/texmf-dist/tex/latex/fileinfo/myfilist.sty127
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
Binary files differ
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
Binary files differ
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