From 20e694f8ef6b05552490e7cc3f9b0c553ae01cf5 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 4 Jan 2013 23:29:26 +0000 Subject: adhocfilelist (4jan13) git-svn-id: svn://tug.org/texlive/trunk@28731 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/support/adhocfilelist/RELEASEs.txt | 3 ++ .../doc/support/adhocfilelist/SrcFILEs.txt | 17 +++---- .../doc/support/adhocfilelist/adhocfilelist.htm | 54 +++++++++++----------- 3 files changed, 39 insertions(+), 35 deletions(-) (limited to 'Master/texmf-dist/doc/support') diff --git a/Master/texmf-dist/doc/support/adhocfilelist/RELEASEs.txt b/Master/texmf-dist/doc/support/adhocfilelist/RELEASEs.txt index 51ce3af525c..fe81d31ac99 100644 --- a/Master/texmf-dist/doc/support/adhocfilelist/RELEASEs.txt +++ b/Master/texmf-dist/doc/support/adhocfilelist/RELEASEs.txt @@ -44,3 +44,6 @@ UPLOAD r0.4a (2012-11-22): in `makehtml.tex' and `srcfiles.tex' * no change in shell script files +UPLOAD r0.4c (2013-01-04): + + * regenerated documentation with `morehype' r.81 diff --git a/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt b/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt index 5a8d451df86..3fd2f304c78 100644 --- a/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt +++ b/Master/texmf-dist/doc/support/adhocfilelist/SrcFILEs.txt @@ -3,19 +3,20 @@ 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/22 -- HTML driver - fdatechk.tex 2012/11/20 -- `filedate' checks - srcfiles.tex 2012/11/22 -- file infos -> SrcFILEs.txt + makehtml.tex 2013/01/04 -- HTML driver + fdatechk.tex 2012/12/30 -- `filedate' checks + srcfiles.tex 2012/12/21 -- file infos -> SrcFILEs.txt ----RELEASE.--- -- -- -- -- ---- -adhocfilelist.RLS 2012/11/22 r0.4a using \ReadShInfos from `readprov' v0.5 +adhocfilelist.RLS 2013/01/04 r0.4c doc. regen. w/ morehype r0.81 HTML_packages.--- -- -- -- -- ---- - blog.sty 2012/11/19 v0.8 simple fast HTML (UL) - blogexec.sty 2012/08/29 v0.2 assignments with blog.sty (UL) + blog.sty 2013/01/04 v0.81 simple fast HTML (UL) + blogexec.sty 2012/12/20 v0.21 assignments with blog.sty (UL) 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/21 -- extra blog settings + texlinks.sty 2012/12/31 v0.81 TeX-related links (UL) + texblog.fdf 2013/01/04 -- extra blog settings *********** - List made at 2012/11/22, 14:36 + List made at 2013/01/04, 11:49 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 3ca657b06cb..28339e62b05 100644 --- a/Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm +++ b/Master/texmf-dist/doc/support/adhocfilelist/adhocfilelist.htm @@ -3,7 +3,7 @@ adhocfilelist.tex, 2012/11/19 documenting adhocfilelist (UL), - with blog.sty, 2012-11-22 --> + with blog.sty, 2013-01-04 --> List LaTeX file infos according to command line @@ -52,17 +52,17 @@ For the latter, adhocfilelist provi interface, especially for restricting the list of files to those that have been modified “today” or a few days ago. So you/I can check whether version info was updated correctly, -and it may allow filedate “consistency checks” -even with XeTeX (where \pdffilemoddate +and it may allow filedate “consistency checks” +even with XeTeX (where \pdffilemoddate is unavailable).

The package may thus be considered an extension of the -latexfileversion (Harald Harders) -and typeoutfileinfo packages +latexfileversion (Harald Harders) +and typeoutfileinfo packages that display ⟨info⟩ for a single file ⟨file⟩. Moreover, it is a somewhat simplified interface to the packages -myfilist, longnamefilelist, -nicefilelist, and filedate. +myfilist, longnamefilelist, +nicefilelist, and filedate.

Overview of command line contents.

The general structure of a command line using adhocfilelist is @@ -105,7 +105,7 @@ List files modified ⟨integer⟩ days ago only (unless ⟨integer⟩ starts with “-” or “+” …)
-c
(f) Compare date according to \Provides... content with modification -date using filedate additionally. +date using filedate additionally.

TODO: The restriction to find (v0.7) is temporary, removing it is straightforward, but I may have to postpone this for a while. @@ -143,11 +143,11 @@ than adhocfilelist.sh’s inter (which are replaced by the content of ⟨tex-file⟩) and than the options -l and -n provide.

-l integer
-Format list by the longnamefilelist package +Format list by the longnamefilelist package where ⟨integer⟩ is the maximum length of base filenames in the list (about as …)
-n filename
-Format list by the nicefilelist package +Format list by the nicefilelist package where ⟨filename⟩ is the longest base filename (or a template). If base filenames do not have more than eight characters, @@ -160,11 +160,11 @@ as plain text file ⟨txt-file⟩ also. Use xelatex rather than latex (v0.7). — The idea for this has been that the script should provide “date consistency” checks (option -c) -“even with XeTeX where \pdffilemoddate is not available.” However, the script has used latex -before v0.7 which will run pdfTeX usually, +“even with XeTeX where \pdffilemoddate is not available.” However, the script has used latex +before v0.7 which will run pdfTeX usually, even when the user prefers typesetting with XeTeX, and anyway it does not rely on \pdffilemoddate. -The real problem with filedate and XeTeX is that +The real problem with filedate and XeTeX is that a reliable consistency check does not work while typesetting with XeTeX. But filedate can be used for “TeX scripts” too, i.e., without typesetting, @@ -216,13 +216,13 @@ that in order to use the find-g, the GNU version of find is required, because action -printf is used and essential (difficult without).
LaTeX
-The package requires that the fileinfo bundle is installed. +The package requires that the fileinfo bundle is installed. In order to use the -l option, -longnamefilelist must be installed additionally. +longnamefilelist must be installed additionally. In order to use the -n option, -nicefilelist must be installed additionally. +nicefilelist must be installed additionally. In order to use the -c option, -filedate must be installed additionally. +filedate must be installed additionally. @@ -250,9 +250,9 @@ For understanding the options -0, -a knowing something about the find utility and the present interface to it may be helpful. The options -i, -l, -n, -and -o refer to the myfilist package -and its enhancements by the packages longnamefilelist -and nicefilelist, and it may be helpful to know +and -o refer to the myfilist package +and its enhancements by the packages longnamefilelist +and nicefilelist, and it may be helpful to know what a “myfilist script” is.
find
@@ -334,7 +334,7 @@ must meet to be listed. However, if ⟨files⟩ ends on
myfilist
-The LaTeX package myfilist provides some commands +The LaTeX package myfilist provides some commands to control the input of LaTeX’s \listfiles so that its output is not a list of files used for typesetting, but a list of arbitrary files that is determined by commands @@ -372,10 +372,10 @@ this might be changed in the future.)

It has been a disadvantage of LaTeX’s \listfiles functionality that the resulting plain text file list looked good with base filenames -only that had up to eight characters. longnamefilelist -made up for this disadvantage, and nicefilelist +only that had up to eight characters. longnamefilelist +made up for this disadvantage, and nicefilelist has additional refinements of aligning the list, proposed by -Martin Münch. To use them with +Martin Münch. To use them with myfilist, they are loaded in ⟨loading-settings⟩ as well, and additional settings for column widths may be added there too. This is what options -l and -n do. @@ -484,10 +484,10 @@ is installed like a TeX package.) One day (most probably 2012-09-27), I wanted to check the \ProvideFile contents of two files I knew I had edited that day. -On 2012-09-26, I had thought about simplifying typeoutfileinfo +On 2012-09-26, I had thought about simplifying typeoutfileinfo by using a single command line without any piping. I realized that LaTeX s \typeout could be replaced by -\ReadFileInfos from myfilist. +\ReadFileInfos from myfilist. Therefore “ad hoc”.

Maybe the same day later, @@ -513,7 +513,7 @@ On the other hand it is nice that the entire command line with all the “parameters” is gobbled.


-

Last revised 2012-11-22 © Uwe Lück
(using blog.sty)
License: LPPL 1.3c or later, author-maintained.

+

Last revised 2013-01-04 © Uwe Lück
(using blog.sty)
License: LPPL 1.3c or later, author-maintained.

[→ top of page ]

-- cgit v1.2.3