diff options
author | Karl Berry <karl@freefriends.org> | 2012-10-15 17:39:58 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-10-15 17:39:58 +0000 |
commit | 194dbf928abdd659520679ca4c448b78c0f94c4b (patch) | |
tree | 32bf7ad3e30c47514238b6a791dddcd08bc69d9d | |
parent | 37aa0ee26efa7d88f12c32ebfcae8b1078dfc9f5 (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.txt | 18 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/fileinfo/RELEASE.txt | 31 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/fileinfo/myfilist.pdf | bin | 293328 -> 309179 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/fileinfo/readprov.pdf | bin | 290632 -> 290577 bytes | |||
-rw-r--r-- | Master/texmf-dist/source/latex/fileinfo/gather.tex | 15 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/fileinfo/myfilist.tex | 66 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/fileinfo/fileinfo.RLS | 4 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/fileinfo/myfilist.sty | 127 |
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 Binary files differindex 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 Binary files differindex 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 |