From f030a7991748b043758202157b1d5fd953d0f922 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 16 May 2012 23:13:14 +0000 Subject: latexfileinfo-pkgs (16may12) git-svn-id: svn://tug.org/texlive/trunk@26456 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/latexfileinfo-pkgs/README | 29 +- .../latexfileinfo-pkgs/latexfileinfo_pkgs.htm | 17 +- .../source/latex/latexfileinfo-pkgs/SrcFILEs.txt | 21 + .../source/latex/latexfileinfo-pkgs/finfpkgs.tex | 459 -------------------- .../latex/latexfileinfo-pkgs/finfpkgs_SRCs.txt | 15 - .../latexfileinfo-pkgs/latexfileinfo_pkgs.tex | 462 +++++++++++++++++++++ .../latex/latexfileinfo-pkgs/ls_finfpkgs_srcs.tex | 8 - .../source/latex/latexfileinfo-pkgs/makehtml.tex | 25 -- .../latexfileinfo-pkgs/mkht_ltxfinfo_pkgs.tex | 18 + .../source/latex/latexfileinfo-pkgs/upfileinfo.sh | 6 - .../latexfileinfo-pkgs/latexfileinfo_pkgs.RLS | 5 + 11 files changed, 542 insertions(+), 523 deletions(-) create mode 100644 Master/texmf-dist/source/latex/latexfileinfo-pkgs/SrcFILEs.txt delete mode 100644 Master/texmf-dist/source/latex/latexfileinfo-pkgs/finfpkgs.tex delete mode 100644 Master/texmf-dist/source/latex/latexfileinfo-pkgs/finfpkgs_SRCs.txt create mode 100644 Master/texmf-dist/source/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.tex delete mode 100644 Master/texmf-dist/source/latex/latexfileinfo-pkgs/ls_finfpkgs_srcs.tex delete mode 100644 Master/texmf-dist/source/latex/latexfileinfo-pkgs/makehtml.tex create mode 100644 Master/texmf-dist/source/latex/latexfileinfo-pkgs/mkht_ltxfinfo_pkgs.tex delete mode 100755 Master/texmf-dist/source/latex/latexfileinfo-pkgs/upfileinfo.sh create mode 100644 Master/texmf-dist/tex/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.RLS (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/README b/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/README index 98bf40f93f6..66f5cd7c6f9 100644 --- a/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/README +++ b/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/README @@ -1,7 +1,7 @@ README for the `latexfileinfo-pkgs' package Comparison of packages showing LaTeX file infos - (C) Uwe Lueck 2012/05/07 + (C) Uwe Lueck 2012/05/15 This "package" in the first instance provides a file @@ -14,7 +14,7 @@ according to the commands \ProvidesClass, \ProvidesFile, and \ProvidesPackage that LaTeX files should start with. The document especially describes five packages of my own, including interrelations and dependencies, and thus extends -their documentations. Among packages from different authers +their documentations. Among packages from different authors mentioned or described as well are * `latexfileversion' and `ltxfileinfo' (rather) @@ -24,6 +24,31 @@ mentioned or described as well are Support of revision control systems is mentioned briefly. +The .htm has been generated with extensions of `blog.sty' from +the `morehype' bundle that are not on CTAN today, hopefully soon +... + +For v0.2b, the method for generating the .htm and `SrcFILEs.txt' +has been refined, see docsrc/ in the CTAN directory or +source/tex/latexfileinfo-pkgs/ in TDS. They are generated from +the same source and use `nicefilelist.sty'. Encoding problems +with umlauts are expected to be solved. + +When file `latexfileinfo_pkgs.RLS' is installed in TEXMF/tex/, +you can access a release summary by some of the packages +described in the .htm file, e.g., + + latexfileversion latexfileinfo_pkgs.RLS + +Generalizing this ([PKG].RLS) may be helpful for managing +multi-package bundles (such as [PKG]) or when code versions of +a package (such as [PKG]) are distinguished from documentation +versions. Using the `myfilist' package, you can then generate +lists of states of bundles ... + + +LICENSE: + The files 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 diff --git a/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.htm b/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.htm index c77a8b8bb47..d8df71dd51d 100644 --- a/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.htm +++ b/Master/texmf-dist/doc/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.htm @@ -1,8 +1,9 @@ - with blog.sty, 2012-05-07 --> Display LaTeX file metadata (“info”) @@ -367,7 +368,7 @@ LaTeX base, no need of myfilist or monofill.
  • Still, filename extensions with number of characters -differing from 3 break alignment. Martin Münch mentions +differing from 3 break alignment. Martin Münch mentions t1cmtt.fd (standard LaTeX font definition) and supp-pdf.mkii (ConTeXt).
  • @@ -385,7 +386,7 @@ nicefilelist.sty  2012/03/29  v0.2   more file list alignment (UL nicefilelist.tex  2012/03/23   --    documenting nicefilelist.sty -(Martin Münch’s idea). +(Martin Münch’s idea).
  • Problem of varying filename extension lengths overcome by actually keeping a separate flush-left column for them. @@ -547,17 +548,17 @@ For revi

    [→| ↑ ]


    Acknowledgements

    -Thanks to Martin Münch, Moss +Thanks to Martin Münch, Moss (I wrote this for his question), -and Rainer Schöpf! +and Rainer Schöpf! RCS stuff mainly has been stolen from -Jürgen Fenn’s Topic Index of the +Jürgen Fenn’s Topic Index of the TeX Catalogue.


    * not mine -

    Last revised 2012-05-07 © Uwe Lück +

    Last revised 2012-05-15 © Uwe Lück diff --git a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/SrcFILEs.txt b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/SrcFILEs.txt new file mode 100644 index 00000000000..227cc24d761 --- /dev/null +++ b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/SrcFILEs.txt @@ -0,0 +1,21 @@ + + *File List* + nicefilelist.sty 2012/03/29 v0.2 more file list alignment (UL) + monofill.sty 2012/03/19 v0.1a monospace alignment (UL) + myfilist.sty 2011/01/30 v0.3a \listfiles -- mine only (UL) + readprov.sty 2010/11/27 v0.3 file infos without loading (UL) + blog.sty 2012/05/15 v0.7 simple fast HTML (UL) + fifinddo.sty 2012/01/20 v0.51 filtering TeX(t) files by TeX (UL) + dowith.sty 2012/05/14 v0.21 simple list loop (UL) + texlinks.sty 2012/05/13 v0.6 TeX-related links (UL) + blogexec.sty 2011/12/15 v0.1 assignments with blog.sty (UL) + texblog.fdf 2012/05/15 -- extra blog settings + atari_ht.fdf 2012/05/13 -- Atari umlauts for blog.sty +mkht_ltxfinfo_pkgs.tex 2012/05/14 -- HTML driver +latexfileinfo_pkgs.tex 2012/05/13 v0.2a latex file info packages (UL) +latexfileinfo_pkgs.RLS 2012/05/15 -- r0.2b refined; corr. tex/ + doc. + *********** + + List made at 2012/05/15, 22:08 + from script file mkht_ltxfinfo_pkgs.tex + diff --git a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/finfpkgs.tex b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/finfpkgs.tex deleted file mode 100644 index 10f406228e1..00000000000 --- a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/finfpkgs.tex +++ /dev/null @@ -1,459 +0,0 @@ -\ProvidesFile{finfpkgs.tex}[2012/05/06 v0.2 latex file info packages (UL)] -\head \charset{ISO-8859-1} %%% {utf-8} - \texrobots - \title{Display LaTeX file metadata ("info")} -% \stylesheet{all}{plain} %% tried 2012/05/06 - \CLBrk %%% \body - \lineanc{top-of-page} %%% \textopofpage -\EXECUTE{\let\CPR\ctanpkgref \def\title{\heading1} \def\section{\heading2} - \def\subsection{\heading3} \let\pkg\pkgnamefmt - \def\fakeitem{\bullet\enspace} - \def\strongcs#1{\strong{\cs{#1}}} - \def\metaarg#1{\code{\{\metavar{#1}\}}} -} -% \EXECUTE{\BlogInterceptHash} %% upfinfo.sh instead -% \EXECUTE{\RequirePackage{monofill}} %% upfinfo.sh instead -% \EXECUTE{\let\pkgnamefmt\code} -\title{\code{latexfileinfo-pkgs} ---\vspace{6} Displaying \Wikienref{Metadata} - (\endqtd{Info}) of \emph{\LaTeX} Source Files} - -\pardash a comparison of packages available from \acro{CTAN} -% \small[\,\UseVersionOf{finfinfo.tex}~as~of~\UseDateOf{finfinfo.tex}\,]\endsmall -%% <- TODO \relax 2012/04/09 -

    %%% \vspace{24} -\begin{small} -[\,\ancrefslist{{{intro}{intro}} - {{table}{table}} - {{single}{\cs{GetFileInfo}~etc.}} - {{several}{\cs{listfiles}~etc.}}{{rcs}{rcs/svn}} - {{thanks}{thanks}}}\,]\quad -[\,\textit{\fileref{\htmljob}{reload}}\,] -\end{small} -\nextruleview{intro} -\section{0\quad Introduction (with links to sections)} -For \Wikienref{\LaTeX} source files, -it is recommended to start them with \LaTeX\ command -\begin{itemize} - \item \cs{ProvidesClass}\code{ ~}\quad (for \file{.cls} files) - \item \cs{ProvidesPackage}\quad (for \file{.sty} files) - \item \cs{ProvidesFile}\code{ ~ }\quad (for all other files) -\end{itemize} -(after \cs{NeedsTeXFormat}). -Their trailing optional argument can provide the most recent -\begin{itemize} - \item \wikienref{Revision control}{revision} \strong{date}\\ - (expected as \emph{\endqtd{first word}} in trailing optional argument) - \item the corresponding \strong{version} string\\ - (expected as \emph{\endqtd{second word}} - in trailing optional argument)\pardash and - \item and a brief \strong{description} of the file ("caption")\\ - (expected as anything \emph{else} in trailing optional argument). -\end{itemize} -Here we are listing and comparing \TeX\ packages available from -\httpref{ctan.org}{\acro{CTAN}} that make use of this information. -

    -The document especially describes five packages of my own, -including interrelations and dependencies, and thus extends -their documentations; see \ancref{table}{table below} for them. -An \emph{asterisk}* near a package name indicates that the package -is \emph{not mine}; so what I tell about it may be wrong or bad \dots\ -(please let me know via \webdesignref{contact.html}{form}, - or should I add something?) ... -

    -We have the \emph{cases} of %% single vs. several -\begin{enumerate} - \item displaying \ancref{single}{single} file info (\strongcs{GetFileInfo} ...) - \item listing infos of \ancref{several}{several} files (\strongcs{listfiles} etc.) -\end{enumerate} -and for each %% LaTeX vs. external -\begin{enumerate-a} - \item access by \emph{\LaTeX} (\ancref{sing-ltx}{1\,}\cdot\ancref{sev-ltx}{\,2}) - \item access by \emph{external} program (\ancref{sing-ext}{1\,}\cdot\ancref{sev-ext}{\,2}). -\end{enumerate-a} -\emph{Related} subjects are using -\begin{enumerate-i} - \item \ancref{rcs}{revision control systems} and - \item modification time according to \ancref{filemod}{pdf\TeX}. -\end{enumerate-i} -\lineanc{table}A \emph{tabular overview} of the first two case distinctions: -

    -\begin{stdallrulestable} - \endcell just using \emph{\LaTeX}\qquad \endcell using \emph{external} program - \endline - \textbf{\ancref{single}{single} file}\endcell - \fakeitem \ancref{doc}{\pkg{doc}}* ~ ~ ~ ~ ~ ~\,\,\, - (Frank \ctanpkgauref{mittelbach}{Mittelbach})\\ - \fakeitem \ancref{zwgetfdate}{\pkg{zwgetfdate}}*\,\,\,\,\,\,\,\, - (Zden\unicodehexentity{011b}k \ctanpkgauref{wagner}{Wagner})\\ - \fakeitem \ancref{readprov}{\pkg{readprov}} - \endcell - \fakeitem \ancref{lfv} {\pkg{latexfileversion}}* - \,(Harald \ctanpkgauref{harders}{Harders}) \\ - \fakeitem \ancref{lfi} {\pkg{ltxfileinfo}}*~ ~ ~ ~ \,\,\,\,\,\,\,\,\, - \,(Wybo \ctanpkgauref{dekker}{Dekker}) \\ - \fakeitem \ancref{tofi}{\pkg{typeoutfileinfo}} - \endline - \textbf{file \ancref{several}{list}}\endcell - \fakeitem \ancref{cl} {\pkg{classlist}}*~~~~~~~\,\,\,\, - (Heiko \ctanpkgauref{oberdiek}{Oberdiek}) \\ - \fakeitem \ancref{dl} {\pkg{dateiliste}}*~~~~~ ~\, - \,(Paul \ctanpkgauref{ebermann}{Ebermann}) \\ - \fakeitem \ancref{lnfl}{\pkg{longnamefilelist}} \\ - \fakeitem \ancref{nfl} {\pkg{nicefilelist}} \\ - \fakeitem \ancref{mfl} {\pkg{myfilist}} \\ - \endcell - \fakeitem[\ancref{ltxinput}{\pkg{ltxinput}}* ~ ~ ~ ~ ~ ~ ~ ~ \,\,\,\,\,\, - (Jim \ctanpkgauref{green}{Green})] \\ - \fakeitem[\ancref{tle}{\pkg{texlog-extract}}* ~ \,\,\, - (Wybo \ctanpkgauref{dekker}{Dekker})] \\ - \\ - [\,don't really belong here \dots\,] \\ - \\ -\end{stdallrulestable} - -\nextruleview{single} -\section{1\quad Access Single File Info} -%% v0.11: distributing intro words over first two subsections -% \internallinksbar{{{sing-ltx}{a}}{{sing-ext}{b}}{{filemod}{c}}} -\begin{small} - [\,\ancref{sing-ltx}{a:}\enspace - \ancrefslist{{{doc}{\pkg{doc}}} - {{readprov}{\pkg{readprov}}} - {{zwgetfdate}{\pkg{zwgetfdate}}} - }\,]\quad - [\,\ancref{sing-ext}{b:}\enspace - \ancrefslist{{{lfv}{\pkg{latexfileversion}}} - {{lfi}{\pkg{ltxfileinfo}}} - {{tofi}{\pkg{typeoutfileinfo}}}}\,]\quad - [\,\ancref{filemod}{c:\enspace \pkg{filemod}}\,] -\end{small} -\subsection{\lineanc{sing-ltx}a.\quad Access in \emph{\LaTeX} Run} -%% shortening 2012/04/05: -\emdash originally for \emph{automatic} inclusion of \emph{current} -revision date and version of a package %%% (? cf.~\ancref{sing-ext}{next subsection}) -in \emph{typesetting} the latter's documentation -(\textit{\endqtd{This document describes version \dots\ as of \dots}}), but then \dots -\begin{description} - \ditem{\lineanc{doc}\CPR{doc}*} - \begin{itemize} - \item Belongs to \LaTeX\ \CtanPkgRef{latex-base}{base} distribution. - \item Provides \strong{\cs{GetFileInfo}}\code{\{\metavar{file}\}}; after using this, - you have \cs{filedate}, \cs{fileversion}, \cs{fileinfo} of \metavar{file}. - \item \metavar{file} must have been \emph{loaded} in the \LaTeX\ run. - \item \cs{GetFileInfo} is \emph{fragile}. - \end{itemize} - \ditem{\lineanc{zwgetfdate}\CPR{zwgetfdate}*} - \begin{itemize} - \item Provides \strongcs{DateOfFile}\metaarg{file} - and \strong{\cs{DateOfPackage}}\metaarg{file}. - \item \metavar{file} must have been \emph{loaded}. - \end{itemize} - \ditem{\lineanc{readprov}\CPR{readprov}} - \begin{itemize} - \item %%% \pkg{readprov} further provides %%% \emph{robust}, expandable - Provides - \strongcs{UseDateOf}\metaarg{file} and \strongcs{UseVersionOf}\metaarg{file}. - \item %%% It steals - Steals \ancref{doc}{\pkg{doc}}'s \strongcs{GetFileInfo} so \pkg{doc} is not - needed, in case ... - \item Provides - \begin{itemize} - \item \strongcs{ReadFileInfos}\metaarg{files} - \item \strongcs{ReadPackageInfos}\metaarg{files} - \item \strongcs{ReadClassInfo}\metaarg{file} - \end{itemize} - as \emph{alternatives} to \cs{GetFileInfo}. - \begin{itemize} %% 2012/04/05 - \item They do \emph{not} really \emph{load} \metavar{file}/\metavar{files} ... - \item ... so can be used with incompatible packages and - classes (multiple latter by \cs{ReadFileInfos\{\metavar{base}.cls\}}). - \item This allows \strong{adding arbitrary} \LaTeX\ source files - to the list of files that \LaTeX\ manages for - \ancref{latex}{\strong{\cs{listfiles}}}\pardash this is used for - \ancref{myfilist}{\pkg{myfilist}}. - \end{itemize} - \end{itemize} -\end{description} -\subsection{\lineanc{sing-ext}b.\quad \emph{Screen} Display Using \emph{External} Program} -\emdash when you wonder whether the most recent version of a package -or a chapter file is present \dots -\begin{description} - \ditem{\lineanc{lfv}\CPR{latexfileversion}*} - \begin{itemize} - \item \Wikienref{Bash (Unix shell)} script. - \item \emph{Nice} screen display. %% TODO sample 2012/05/05 - \item Invokes \code{latex} run using a copy of - \ancref{doc}{\pkg{doc}}'s \cs{GetFileInfo}. - \end{itemize} - \ditem{\lineanc{lfi}\CPR{ltxfileinfo}*} - \begin{itemize} - \item \Wikiendisambref{Ruby}{programming language} script. - \item Displays nice - \mirrorctanref{support/ltxfileinfo/doc/ltxfileinfo.html}{table} - of infos (including \emph{location} in file system) on screen. - \end{itemize} - \ditem{\lineanc{tofi}\CPR{typeoutfileinfo}} - \begin{itemize} - \item 5-lines \Wikienref{Bash (Unix shell)} script. - \item Expects \code{latex} won't append too many screen lines after - 1-line \strongcs{typeout}\\ - (\emph{tolerable} screen display as compared with - \ancref{lfv}{latexfileversion}). - \item Invokes \code{latex} run using \ancref{readprov}{\pkg{readprov}}. - \end{itemize} -\end{description} -\subsection{\lineanc{filemod}c.\quad Related, while different ...} -\begin{description} - \ditem{\CPR{filemod}*} - \begin{itemize} - \item Uses \tugref{applications/pdftex/NEWS}{\pdfTeX}'s - \cs{pdffilemoddate\{\metavar{file}\}} primitive. - \item Compares modification dates of files. - \item Files include images. - \item Also works with \code{pdflatex} in \acro{DVI} mode. - \end{itemize} -\end{description} - -\nextruleview{several} -\section{2\quad File Info List} -This is about listing \emph{all} files input in a \LaTeX\ run, \emph{or}~... -\subsection{\lineanc{sev-ltx}a.\quad Create in \LaTeX\ Run} -\begin{small} -[\,\ancrefslist{{{latex}{\pkg{LaTeX}}} - {{cl}{\pkg{classlist}}} - {{dl}{\pkg{dateiliste}}} - {{lnfl}{\pkg{longnamefilelist}}} - {{mfl}{\pkg{myfilist}}} - {{nfl}{\pkg{nicefilelist}}}}\,] -\end{small} -\begin{description} - \ditem{\lineanc{latex}\CPR{latex}*} - \begin{itemize} - \item \LaTeX\ provides \strong{\cs{listfiles}} for the document preamble. - \item \cs{listfiles} issues a list of \strong{all} files input in the \code{latex} run - near end of \file{.log} file, together with their infos according - to \cs{Provide...} commands. - \item The list is a \strong{two-column} "table" (plain text), \emph{base} filenames - flush right, \emph{info} (maybe date, maybe version, maybe anything) flush left. - \item Any file whose base \Wikienref{filename} has \strong{more than 8}~characters - or whose filename extension does \emph{not} have 3~characters \strong{corrupts} alignment. - \end{itemize} - \ditem{\lineanc{cl}\CPR{classlist}*} - \begin{itemize} - \item Remembers (separately) files input by ~(a)~\strong{\cs{documentclass}}~ - and what was input by ~(b)~\strong{\cs{LoadClass}}. - \item On \strong{\cs{PrintClassList}}, the list of loaded class files appears on screen. - \item Configurable by \strongcs{PrintClassListEntry} and \strongcs{PrintClassListTitle}. - \end{itemize} - \ditem{\lineanc{dl}\CPR{dateiliste}*} - \begin{itemize} - \item Lists anything that the \ancref{latex}{original} \cs{listfiles} would list. - \item \strong{Typesets} the list as a \LaTeX\ table, using package \CPR{longtable}. - \item Separate \strong{columns} for - \begin{itemize} - \item filename - \item \emph{page} where input (optionally) %% \emph 2012/04/09 - \item date - \item version - \item description ("caption") - \end{itemize} - \item Supports \strong{\acro{RCS}}, - \wikienref{Concurrent Versions System}{\acro{CVS}}, - and \acro{SVN} (cf.~\ancref{rcs}{section below}). - \item Highly configurable. - \item E.g., you can replace info for a file by what you want to see in the list - (cf.~\ancref{myfilist}{\pkg{myfilist}}). - \item I haven't seen what happens with \emph{plain text} (\file{.log}) output. - \end{itemize} - \ditem{\lineanc{lnfl}\CPR{longnamefilelist}} - \begin{itemize} - \item Overcomes \ancref{latex}{\LaTeX}'s "8-character~limit" - by a new \strong{optional argument} for \cs{listfiles}, - indicating number of characters to be reserved for - base filenames, e.g. accounting for "\code{longnamefilelist.sty}": - \begin{quote} - \cs{listfiles[16]} - \end{quote} - \pardash view - \mirrorctanref{macros/latex/contrib/longnamefilelist/% - SrcFILEs.txt}{example outcome} - \item \emdash showing combination with \ancref{mfl}{\pkg{myfilist}} - \item \emdash while also working as single addition to - \LaTeX~\CtanPkgRef{latex-base}{base}, - \emph{no} need of \ancref{mfl}{\pkg{myfilist}} or \CPR{monofill}. - \item Still, filename \strong{extension}s with number of characters - differing from 3 break alignment. Martin Mnch mentions - \file{t1cmtt.fd} (standard \LaTeX\ font definition) and - \file{supp-pdf.mkii} (\Wikienref{ConTeXt}). - \end{itemize} - \ditem{\lineanc{nfl}\CPR{nicefilelist}} - \begin{itemize} - \item Uses separate \strong{columns} for \strong{date} and \strong{time} - (like \ancref{dl}{\pkg{dateiliste}}). - \item (Picky) recognition of "date" and "version"\pardash if not present, - left \strong{empty} or gets "missing" display: - \begin{codelines} - nicefilelist.sty~ 2012/03/29~ v0.2 ~ more file list alignment (UL)\/ - nicefilelist.tex~ 2012/03/23~ ~--~ ~ documenting nicefilelist.sty - \end{codelines} - (Martin Mnch's idea). - \item Problem of varying filename \strong{extension} lengths overcome - by actually keeping a separate flush-left column for them. - \item Column widths configurable by \strong{templates}\pardash replace - pre-configuration (\CPR{monofill} commands): - \begin{codelines} - \EXECUTE{\MFfieldtemplate[~]{nfl}{% - /MFfieldtemplate(f-base)...(nicefilelist)..}} - \MFleftinfield{% - \\MFfieldtemplate\{f-base\}~~~\{nicefilelist\}}{nfl}\%\%\ base name \/ - \MFleftinfield{% - \\MFfieldtemplate\{f-ext\}~~~~\{tex\}}{nfl}\%\%\ name extension \/ - \MFleftinfield{% - \\MFfieldtemplate\{f-version\}\{v0.11a\}}{nfl}\%\%\ version - \end{codelines} - \item First code line above shows \strong{difference} to \CPR{longnamefilelist}, - equivalent there would be \cs{listfiles[12]}. - \pkg{nicefilelist} does \emph{not} provide an optional argument - for \cs{listfiles}. - \item Column \strong{distances} and "\strong{missing}" display configurable too. - \item Can be combined with \ancref{mfl}{\pkg{myfilist}}\pardash view - \mirrorctanref{macros/latex/contrib/nicefilelist/% - SrcFILEs.txt}{output sample}. - \item Needs just \CPR{monofill}, additionally to - \LaTeX~\CtanPkgRef{latex-base}{base}. - \end{itemize} - \ditem{\lineanc{mfl}\lineanc{myfilist}\CPR{myfilist}} - \begin{itemize} - \item Allows \strong{removing} all entries that \LaTeX\ has collected - for \ancref{latex}{\cs{listfiles}} at a certain point. - \item Then, by commands from \ancref{readprov}{\pkg{readprov}}, - you can \strong{add arbitrary} files to the list - (as they are \emph{not} really \emph{loaded}), - in the order you want to have them in the list. - \item Thus actually, you can set up a list of files you want to have - \emph{independently} of a typesetting run ... - \item ... and actually, the \strong{intended} application is generating the - list \strong{without} any \strong{typesetting}, - by running \code{latex} on a "\strong{script}" file - just loading \pkg{readprov} and \pkg{myfilist} - and using only commands from \emph{them}. - (No \cs{documentclass}, no \code{\{document\}} environment.) - \item View - \mirrorctanref{macros/latex/contrib/longnamefilelist/docsrc/% - srcfiles.tex}{input example} - for \ancref{lnfl}{\pkg{longnamefilelist}}. - \item Besides \file{.log} output, the list can be written into a \strong{separate} - plain text \strong{file%%% } ... -% \item ... view - }\pardash view - \mirrorctanref{macros/latex/contrib/longnamefilelist/% - SrcFILEs.txt}{output example} - for \ancref{lnfl}{\pkg{longnamefilelist}}. - \item \strong{Main applications} in my mind and actual work: - \begin{enumerate} - \item List of \file{.sty} and \file{.tex} files for \emph{my} - \strong{\acro{CTAN} packages} and \strong{bundles} - (instead of the \file{.dtx}/\CPR{docstrip} system, I use \CPR{nicetext}). - \item List of \strong{package} files specific to some \strong{project} - that often change\pardash manual replacement for a - "concurrent versions" system with single author. - E.g.: - \begin{itemize} - \item \CPR{nicetext} packages underlying \strong{documentation} - of a certain different package. - \item \strong{style} files underlying a \strong{book} project - at which authors and programmers work on changing computers. - \end{itemize} - \item List of \strong{chapter} \cs{include} files for a \strong{book} project, - edited at changing computers (by a number of authors). - \item Often, one \strong{forgets} to \strong{update} version information - in the \cs{Provides...} command\pardash the \pkg{myfilist} - helps you to \pkg{check} this - (e.g., right before a release; - \ancref{filemod}{\pkg{filemod}} might automate this check, - perhaps together with \ancref{readprov}{\pkg{readprov}}, - \emph{without} \pkg{myfilist}). - \end{enumerate} - \item My actual \strong{workflow} with \Wikienref{Bash (Unix shell)}: - \begin{itemize} - \item \strong{\code{upsfl}} with - \begin{codelines} - alias upsfl='latex srcfiles'} - \end{codelines} - updates the list of source files, - and actually displays the updated list on screen. - \item \strong{\code{shsfl}} with - \begin{codelines} - \code{alias shsfl='more SrcFILEs.txt'} - \end{codelines} - displays the source file list without updating, - and waits when the list is too long for your (netbook) screen. - \end{itemize} - \item Combinable with \ancref{dl}{\pkg{dateiliste}}? - \end{itemize} -\end{description} -\subsection{\lineanc{sev-ext}b.\quad Create by External Program} -Hm, not so related, \emph{no} infos (it seems), lists only; -so, just \emph{"most related I could find"} for this section~... -\begin{description} - \ditem{\lineanc{ltxinput}\CPR{ltxinput}*} - \begin{itemize} - \item \wikienref{MS-DOS}{\acro{MS-DOS}} utility - (compiled from \wikienref{C (programming language)}{\acro{C}}). - \item Lists files that \emph{would} be input (recursively). - \end{itemize} - \ditem{\lineanc{tle}\CPR{texlog-extract}*} - \begin{itemize} - \item \Wikiendisambref{Ruby}{programming language} script. - \item Lists files that issued errors and warnings (colored). - \end{itemize} -\end{description} - -\nextruleview{rcs} -\section{\lineanc{rcs}3\quad \acro{RCS}/\acro{SVN}} -For \wikienref{Revision control}{revision control systems} -\wikienref{Revision control system}{\acro{RCS}} and -\wikienref{Apache Subversion}{\acro{SVN}}, there are -\begin{itemize} - \item \CPR{rcs}* \cdot\ \CPR{rcsinfo}* \cdot\ \CPR{rcs-multi}* - \item \CPR{svn}* \cdot\ \CPR{svninfo}* \cdot\ \CPR{svn-multi}* - \item \CPR{svn-prov}* provides \acro{SVN} variants of - \cs{ProvidesClass}, \cs{ProvidesFile}, and \cs{ProvidesPackage}. -\end{itemize} -\emdash sorry, I can't tell more about them right now~\dots %% 2012/04/08 - -\nextruleview{thanks} -\section{Acknowledgements} -Thanks to Martin Mnch, Moss -(I wrote this for his question), %% 2012/04/06 -and Rainer Sch”pf! -\ancref{rcs}{\acro{RCS} stuff} mainly has been stolen from -\bytopicref{revision}{Jrgen Fenn's Topic Index} of the -\mirrorctanref{help/Catalogue}{\TeX~Catalogue}. -

    %%% \vspace{24} -\hrule -\small*~not~mine\endsmall -\rightpar{\textit{% - Last~revised~\isotoday\ \copyright~\webdesignref{contact.html}{Uwe Lck} - \vspace{6} - (using \CtanPkgRef{morehype}{blog.sty} - and \CtanPkgRef{monofill}{monofill.sty}) - \vspace{6} - License: \httpref{www.latex-project.org/lppl/}{LPPL~1.3c} or later, author-maintained.}} -\entotopofpage -\vspace{550} -\finish - -%% HISTORY: -%% 2012/04/02 v0.1 first upload -%% 2012/04/02 v0.11 little improvements afterwards, -%% especially intro words for section 1 -%% 2012/04/05 v0.12 less words in section 1; -%% sub-itemize for readprov -%% 2012/04/06 wrote for Moss -%% 2012/04/08 started table, some other additions -%% 2012/04/09 continued (fix of strange bug!?) -%% -%% 2012/05/05f. v0.2 renamed `latexfileinfo-pkgs', table -%% reformatted manually, minor rewordings -%% and reformattings, link fixes diff --git a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/finfpkgs_SRCs.txt b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/finfpkgs_SRCs.txt deleted file mode 100644 index 079a32dac21..00000000000 --- a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/finfpkgs_SRCs.txt +++ /dev/null @@ -1,15 +0,0 @@ - - *File List* -finfpkgs.tex 2012/05/06 v0.2 latex file info packages (UL) - atari.fdf 2010/08/29 Atari German to ISO-8859 with blog.sty - blog.sty 2012/04/09 v0.7 simple fast HTML (UL) -blogexec.sty 2011/12/15 v0.1 assignments with blog.sty (UL) -fifinddo.sty 2012/01/20 v0.51 filtering TeX(t) files by TeX (UL) -texlinks.sty 2012/04/10 v0.6 TeX-related links (UL) -makehtml.tex 2012/01/07 HTML driver - texblog.fdf 2012/03/17 extra blog settings - *********** - - List made at 2012/05/06, 23:41 - from script file ls_finfpkgs_srcs.tex - diff --git a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.tex b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.tex new file mode 100644 index 00000000000..23ae3c84b6f --- /dev/null +++ b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.tex @@ -0,0 +1,462 @@ +\ProvidesFile{latexfileinfo_pkgs.tex}[2012/05/13 v0.2a latex file info packages (UL)] +% \ProvidesFile{finfpkgs.tex}[2012/05/06 v0.2 latex file info packages (UL)] +\head \charset{ISO-8859-1} %%% {utf-8} + \texrobots + \title{Display LaTeX file metadata ("info")} +% \stylesheet{all}{plain} %% tried 2012/05/06 + \CLBrk %%% \body + \lineanc{top-of-page} %%% \textopofpage +\EXECUTE{\let\CPR\ctanpkgref \def\title{\heading1} \def\section{\heading2} + \def\subsection{\heading3} \let\pkg\pkgnamefmt + \def\fakeitem{\bullet\enspace} + \def\strongcs#1{\strong{\cs{#1}}} + \def\metaarg#1{\code{\{\metavar{#1}\}}} +} +% \EXECUTE{\BlogInterceptHash} %% upfinfo.sh instead +% \EXECUTE{\RequirePackage{monofill}} %% upfinfo.sh instead +% \EXECUTE{\let\pkgnamefmt\code} +\title{\code{latexfileinfo-pkgs} ---\vspace{6} Displaying \Wikienref{Metadata} + (\endqtd{Info}) of \emph{\LaTeX} Source Files} + +\pardash a comparison of packages available from \acro{CTAN} +% \small[\,\UseVersionOf{finfinfo.tex}~as~of~\UseDateOf{finfinfo.tex}\,]\endsmall +%% <- TODO \relax 2012/04/09 +

    %%% \vspace{24} +\begin{small} +[\,\ancrefslist{{{intro}{intro}} + {{table}{table}} + {{single}{\cs{GetFileInfo}~etc.}} + {{several}{\cs{listfiles}~etc.}}{{rcs}{rcs/svn}} + {{thanks}{thanks}}}\,]\quad +[\,\textit{\fileref{\htmljob}{reload}}\,] +\end{small} +\nextruleview{intro} +\section{0\quad Introduction (with links to sections)} +For \Wikienref{\LaTeX} source files, +it is recommended to start them with \LaTeX\ command +\begin{itemize} + \item \cs{ProvidesClass}\code{ ~}\quad (for \file{.cls} files) + \item \cs{ProvidesPackage}\quad (for \file{.sty} files) + \item \cs{ProvidesFile}\code{ ~ }\quad (for all other files) +\end{itemize} +(after \cs{NeedsTeXFormat}). +Their trailing optional argument can provide the most recent +\begin{itemize} + \item \wikienref{Revision control}{revision} \strong{date}\\ + (expected as \emph{\endqtd{first word}} in trailing optional argument) + \item the corresponding \strong{version} string\\ + (expected as \emph{\endqtd{second word}} + in trailing optional argument)\pardash and + \item and a brief \strong{description} of the file ("caption")\\ + (expected as anything \emph{else} in trailing optional argument). +\end{itemize} +Here we are listing and comparing \TeX\ packages available from +\httpref{ctan.org}{\acro{CTAN}} that make use of this information. +

    +The document especially describes five packages of my own, +including interrelations and dependencies, and thus extends +their documentations; see \ancref{table}{table below} for them. +An \emph{asterisk}* near a package name indicates that the package +is \emph{not mine}; so what I tell about it may be wrong or bad \dots\ +(please let me know via \webdesignref{contact.html}{form}, + or should I add something?) ... +

    +We have the \emph{cases} of %% single vs. several +\begin{enumerate} + \item displaying \ancref{single}{single} file info (\strongcs{GetFileInfo} ...) + \item listing infos of \ancref{several}{several} files (\strongcs{listfiles} etc.) +\end{enumerate} +and for each %% LaTeX vs. external +\begin{enumerate-a} + \item access by \emph{\LaTeX} (\ancref{sing-ltx}{1\,}\cdot\ancref{sev-ltx}{\,2}) + \item access by \emph{external} program (\ancref{sing-ext}{1\,}\cdot\ancref{sev-ext}{\,2}). +\end{enumerate-a} +\emph{Related} subjects are using +\begin{enumerate-i} + \item \ancref{rcs}{revision control systems} and + \item modification time according to \ancref{filemod}{pdf\TeX}. +\end{enumerate-i} +\lineanc{table}A \emph{tabular overview} of the first two case distinctions: +

    +\begin{stdallrulestable} + \endcell just using \emph{\LaTeX}\qquad \endcell using \emph{external} program + \endline + \textbf{\ancref{single}{single} file}\endcell + \fakeitem \ancref{doc}{\pkg{doc}}* ~ ~ ~ ~ ~ ~\,\,\, + (Frank \ctanpkgauref{mittelbach}{Mittelbach})\\ + \fakeitem \ancref{zwgetfdate}{\pkg{zwgetfdate}}*\,\,\,\,\,\,\,\, + (Zden\unicodehexentity{011b}k \ctanpkgauref{wagner}{Wagner})\\ + \fakeitem \ancref{readprov}{\pkg{readprov}} + \endcell + \fakeitem \ancref{lfv} {\pkg{latexfileversion}}* + \,(Harald \ctanpkgauref{harders}{Harders}) \\ + \fakeitem \ancref{lfi} {\pkg{ltxfileinfo}}*~ ~ ~ ~ \,\,\,\,\,\,\,\,\, + \,(Wybo \ctanpkgauref{dekker}{Dekker}) \\ + \fakeitem \ancref{tofi}{\pkg{typeoutfileinfo}} + \endline + \textbf{file \ancref{several}{list}}\endcell + \fakeitem \ancref{cl} {\pkg{classlist}}*~~~~~~~\,\,\,\, + (Heiko \ctanpkgauref{oberdiek}{Oberdiek}) \\ + \fakeitem \ancref{dl} {\pkg{dateiliste}}*~~~~~ ~\, + \,(Paul \ctanpkgauref{ebermann}{Ebermann}) \\ + \fakeitem \ancref{lnfl}{\pkg{longnamefilelist}} \\ + \fakeitem \ancref{nfl} {\pkg{nicefilelist}} \\ + \fakeitem \ancref{mfl} {\pkg{myfilist}} \\ + \endcell + \fakeitem[\ancref{ltxinput}{\pkg{ltxinput}}* ~ ~ ~ ~ ~ ~ ~ ~ \,\,\,\,\,\, + (Jim \ctanpkgauref{green}{Green})] \\ + \fakeitem[\ancref{tle}{\pkg{texlog-extract}}* ~ \,\,\, + (Wybo \ctanpkgauref{dekker}{Dekker})] \\ + \\ + [\,don't really belong here \dots\,] \\ + \\ +\end{stdallrulestable} + +\nextruleview{single} +\section{1\quad Access Single File Info} +%% v0.11: distributing intro words over first two subsections +% \internallinksbar{{{sing-ltx}{a}}{{sing-ext}{b}}{{filemod}{c}}} +\begin{small} + [\,\ancref{sing-ltx}{a:}\enspace + \ancrefslist{{{doc}{\pkg{doc}}} + {{readprov}{\pkg{readprov}}} + {{zwgetfdate}{\pkg{zwgetfdate}}} + }\,]\quad + [\,\ancref{sing-ext}{b:}\enspace + \ancrefslist{{{lfv}{\pkg{latexfileversion}}} + {{lfi}{\pkg{ltxfileinfo}}} + {{tofi}{\pkg{typeoutfileinfo}}}}\,]\quad + [\,\ancref{filemod}{c:\enspace \pkg{filemod}}\,] +\end{small} +\subsection{\lineanc{sing-ltx}a.\quad Access in \emph{\LaTeX} Run} +%% shortening 2012/04/05: +\emdash originally for \emph{automatic} inclusion of \emph{current} +revision date and version of a package %%% (? cf.~\ancref{sing-ext}{next subsection}) +in \emph{typesetting} the latter's documentation +(\textit{\endqtd{This document describes version \dots\ as of \dots}}), but then \dots +\begin{description} + \ditem{\lineanc{doc}\CPR{doc}*} + \begin{itemize} + \item Belongs to \LaTeX\ \CtanPkgRef{latex-base}{base} distribution. + \item Provides \strong{\cs{GetFileInfo}}\code{\{\metavar{file}\}}; after using this, + you have \cs{filedate}, \cs{fileversion}, \cs{fileinfo} of \metavar{file}. + \item \metavar{file} must have been \emph{loaded} in the \LaTeX\ run. + \item \cs{GetFileInfo} is \emph{fragile}. + \end{itemize} + \ditem{\lineanc{zwgetfdate}\CPR{zwgetfdate}*} + \begin{itemize} + \item Provides \strongcs{DateOfFile}\metaarg{file} + and \strong{\cs{DateOfPackage}}\metaarg{file}. + \item \metavar{file} must have been \emph{loaded}. + \end{itemize} + \ditem{\lineanc{readprov}\CPR{readprov}} + \begin{itemize} + \item %%% \pkg{readprov} further provides %%% \emph{robust}, expandable + Provides + \strongcs{UseDateOf}\metaarg{file} and \strongcs{UseVersionOf}\metaarg{file}. + \item %%% It steals + Steals \ancref{doc}{\pkg{doc}}'s \strongcs{GetFileInfo} so \pkg{doc} is not + needed, in case ... + \item Provides + \begin{itemize} + \item \strongcs{ReadFileInfos}\metaarg{files} + \item \strongcs{ReadPackageInfos}\metaarg{files} + \item \strongcs{ReadClassInfo}\metaarg{file} + \end{itemize} + as \emph{alternatives} to \cs{GetFileInfo}. + \begin{itemize} %% 2012/04/05 + \item They do \emph{not} really \emph{load} \metavar{file}/\metavar{files} ... + \item ... so can be used with incompatible packages and + classes (multiple latter by \cs{ReadFileInfos\{\metavar{base}.cls\}}). + \item This allows \strong{adding arbitrary} \LaTeX\ source files + to the list of files that \LaTeX\ manages for + \ancref{latex}{\strong{\cs{listfiles}}}\pardash this is used for + \ancref{myfilist}{\pkg{myfilist}}. + \end{itemize} + \end{itemize} +\end{description} +\subsection{\lineanc{sing-ext}b.\quad \emph{Screen} Display Using \emph{External} Program} +\emdash when you wonder whether the most recent version of a package +or a chapter file is present \dots +\begin{description} + \ditem{\lineanc{lfv}\CPR{latexfileversion}*} + \begin{itemize} + \item \Wikienref{Bash (Unix shell)} script. + \item \emph{Nice} screen display. %% TODO sample 2012/05/05 + \item Invokes \code{latex} run using a copy of + \ancref{doc}{\pkg{doc}}'s \cs{GetFileInfo}. + \end{itemize} + \ditem{\lineanc{lfi}\CPR{ltxfileinfo}*} + \begin{itemize} + \item \Wikiendisambref{Ruby}{programming language} script. + \item Displays nice + \mirrorctanref{support/ltxfileinfo/doc/ltxfileinfo.html}{table} + of infos (including \emph{location} in file system) on screen. + \end{itemize} + \ditem{\lineanc{tofi}\CPR{typeoutfileinfo}} + \begin{itemize} + \item 5-lines \Wikienref{Bash (Unix shell)} script. + \item Expects \code{latex} won't append too many screen lines after + 1-line \strongcs{typeout}\\ + (\emph{tolerable} screen display as compared with + \ancref{lfv}{latexfileversion}). + \item Invokes \code{latex} run using \ancref{readprov}{\pkg{readprov}}. + \end{itemize} +\end{description} +\subsection{\lineanc{filemod}c.\quad Related, while different ...} +\begin{description} + \ditem{\CPR{filemod}*} + \begin{itemize} + \item Uses \tugref{applications/pdftex/NEWS}{\pdfTeX}'s + \cs{pdffilemoddate\{\metavar{file}\}} primitive. + \item Compares modification dates of files. + \item Files include images. + \item Also works with \code{pdflatex} in \acro{DVI} mode. + \end{itemize} +\end{description} + +\nextruleview{several} +\section{2\quad File Info List} +This is about listing \emph{all} files input in a \LaTeX\ run, \emph{or}~... +\subsection{\lineanc{sev-ltx}a.\quad Create in \LaTeX\ Run} +\begin{small} +[\,\ancrefslist{{{latex}{\pkg{LaTeX}}} + {{cl}{\pkg{classlist}}} + {{dl}{\pkg{dateiliste}}} + {{lnfl}{\pkg{longnamefilelist}}} + {{mfl}{\pkg{myfilist}}} + {{nfl}{\pkg{nicefilelist}}}}\,] +\end{small} +\begin{description} + \ditem{\lineanc{latex}\CPR{latex}*} + \begin{itemize} + \item \LaTeX\ provides \strong{\cs{listfiles}} for the document preamble. + \item \cs{listfiles} issues a list of \strong{all} files input in the \code{latex} run + near end of \file{.log} file, together with their infos according + to \cs{Provide...} commands. + \item The list is a \strong{two-column} "table" (plain text), \emph{base} filenames + flush right, \emph{info} (maybe date, maybe version, maybe anything) flush left. + \item Any file whose base \Wikienref{filename} has \strong{more than 8}~characters + or whose filename extension does \emph{not} have 3~characters \strong{corrupts} alignment. + \end{itemize} + \ditem{\lineanc{cl}\CPR{classlist}*} + \begin{itemize} + \item Remembers (separately) files input by ~(a)~\strong{\cs{documentclass}}~ + and what was input by ~(b)~\strong{\cs{LoadClass}}. + \item On \strong{\cs{PrintClassList}}, the list of loaded class files appears on screen. + \item Configurable by \strongcs{PrintClassListEntry} and \strongcs{PrintClassListTitle}. + \end{itemize} + \ditem{\lineanc{dl}\CPR{dateiliste}*} + \begin{itemize} + \item Lists anything that the \ancref{latex}{original} \cs{listfiles} would list. + \item \strong{Typesets} the list as a \LaTeX\ table, using package \CPR{longtable}. + \item Separate \strong{columns} for + \begin{itemize} + \item filename + \item \emph{page} where input (optionally) %% \emph 2012/04/09 + \item date + \item version + \item description ("caption") + \end{itemize} + \item Supports \strong{\acro{RCS}}, + \wikienref{Concurrent Versions System}{\acro{CVS}}, + and \acro{SVN} (cf.~\ancref{rcs}{section below}). + \item Highly configurable. + \item E.g., you can replace info for a file by what you want to see in the list + (cf.~\ancref{myfilist}{\pkg{myfilist}}). + \item I haven't seen what happens with \emph{plain text} (\file{.log}) output. + \end{itemize} + \ditem{\lineanc{lnfl}\CPR{longnamefilelist}} + \begin{itemize} + \item Overcomes \ancref{latex}{\LaTeX}'s "8-character~limit" + by a new \strong{optional argument} for \cs{listfiles}, + indicating number of characters to be reserved for + base filenames, e.g. accounting for "\code{longnamefilelist.sty}": + \begin{quote} + \cs{listfiles[16]} + \end{quote} + \pardash view + \mirrorctanref{macros/latex/contrib/longnamefilelist/% + SrcFILEs.txt}{example outcome} + \item \emdash showing combination with \ancref{mfl}{\pkg{myfilist}} + \item \emdash while also working as single addition to + \LaTeX~\CtanPkgRef{latex-base}{base}, + \emph{no} need of \ancref{mfl}{\pkg{myfilist}} or \CPR{monofill}. + \item Still, filename \strong{extension}s with number of characters + differing from 3 break alignment. Martin Mnch mentions + \file{t1cmtt.fd} (standard \LaTeX\ font definition) and + \file{supp-pdf.mkii} (\Wikienref{ConTeXt}). + \end{itemize} + \ditem{\lineanc{nfl}\CPR{nicefilelist}} + \begin{itemize} + \item Uses separate \strong{columns} for \strong{date} and \strong{time} + (like \ancref{dl}{\pkg{dateiliste}}). + \item (Picky) recognition of "date" and "version"\pardash if not present, + left \strong{empty} or gets "missing" display: + \begin{codelines} + nicefilelist.sty~ 2012/03/29~ v0.2 ~ more file list alignment (UL)\/ + nicefilelist.tex~ 2012/03/23~ ~--~ ~ documenting nicefilelist.sty + \end{codelines} + (Martin Mnch's idea). + \item Problem of varying filename \strong{extension} lengths overcome + by actually keeping a separate flush-left column for them. + \item Column widths configurable by \strong{templates}\pardash replace + pre-configuration (\CPR{monofill} commands): + \begin{codelines} + \EXECUTE{\MFfieldtemplate[~]{nfl}{% + /MFfieldtemplate(f-base)...(nicefilelist)..}} + \MFleftinfield{% + \\MFfieldtemplate\{f-base\}~~~\{nicefilelist\}}{nfl}\%\%\ base name \/ + \MFleftinfield{% + \\MFfieldtemplate\{f-ext\}~~~~\{tex\}}{nfl}\%\%\ name extension \/ + \MFleftinfield{% + \\MFfieldtemplate\{f-version\}\{v0.11a\}}{nfl}\%\%\ version + \end{codelines} + \item First code line above shows \strong{difference} to \CPR{longnamefilelist}, + equivalent there would be \cs{listfiles[12]}. + \pkg{nicefilelist} does \emph{not} provide an optional argument + for \cs{listfiles}. + \item Column \strong{distances} and "\strong{missing}" display configurable too. + \item Can be combined with \ancref{mfl}{\pkg{myfilist}}\pardash view + \mirrorctanref{macros/latex/contrib/nicefilelist/% + SrcFILEs.txt}{output sample}. + \item Needs just \CPR{monofill}, additionally to + \LaTeX~\CtanPkgRef{latex-base}{base}. + \end{itemize} + \ditem{\lineanc{mfl}\lineanc{myfilist}\CPR{myfilist}} + \begin{itemize} + \item Allows \strong{removing} all entries that \LaTeX\ has collected + for \ancref{latex}{\cs{listfiles}} at a certain point. + \item Then, by commands from \ancref{readprov}{\pkg{readprov}}, + you can \strong{add arbitrary} files to the list + (as they are \emph{not} really \emph{loaded}), + in the order you want to have them in the list. + \item Thus actually, you can set up a list of files you want to have + \emph{independently} of a typesetting run ... + \item ... and actually, the \strong{intended} application is generating the + list \strong{without} any \strong{typesetting}, + by running \code{latex} on a "\strong{script}" file + just loading \pkg{readprov} and \pkg{myfilist} + and using only commands from \emph{them}. + (No \cs{documentclass}, no \code{\{document\}} environment.) + \item View + \mirrorctanref{macros/latex/contrib/longnamefilelist/docsrc/% + srcfiles.tex}{input example} + for \ancref{lnfl}{\pkg{longnamefilelist}}. + \item Besides \file{.log} output, the list can be written into a \strong{separate} + plain text \strong{file%%% } ... +% \item ... view + }\pardash view + \mirrorctanref{macros/latex/contrib/longnamefilelist/% + SrcFILEs.txt}{output example} + for \ancref{lnfl}{\pkg{longnamefilelist}}. + \item \strong{Main applications} in my mind and actual work: + \begin{enumerate} + \item List of \file{.sty} and \file{.tex} files for \emph{my} + \strong{\acro{CTAN} packages} and \strong{bundles} + (instead of the \file{.dtx}/\CPR{docstrip} system, I use \CPR{nicetext}). + \item List of \strong{package} files specific to some \strong{project} + that often change\pardash manual replacement for a + "concurrent versions" system with single author. + E.g.: + \begin{itemize} + \item \CPR{nicetext} packages underlying \strong{documentation} + of a certain different package. + \item \strong{style} files underlying a \strong{book} project + at which authors and programmers work on changing computers. + \end{itemize} + \item List of \strong{chapter} \cs{include} files for a \strong{book} project, + edited at changing computers (by a number of authors). + \item Often, one \strong{forgets} to \strong{update} version information + in the \cs{Provides...} command\pardash the \pkg{myfilist} + helps you to \pkg{check} this + (e.g., right before a release; + \ancref{filemod}{\pkg{filemod}} might automate this check, + perhaps together with \ancref{readprov}{\pkg{readprov}}, + \emph{without} \pkg{myfilist}). + \end{enumerate} + \item My actual \strong{workflow} with \Wikienref{Bash (Unix shell)}: + \begin{itemize} + \item \strong{\code{upsfl}} with + \begin{codelines} + alias upsfl='latex srcfiles'} + \end{codelines} + updates the list of source files, + and actually displays the updated list on screen. + \item \strong{\code{shsfl}} with + \begin{codelines} + \code{alias shsfl='more SrcFILEs.txt'} + \end{codelines} + displays the source file list without updating, + and waits when the list is too long for your (netbook) screen. + \end{itemize} + \item Combinable with \ancref{dl}{\pkg{dateiliste}}? + \end{itemize} +\end{description} +\subsection{\lineanc{sev-ext}b.\quad Create by External Program} +Hm, not so related, \emph{no} infos (it seems), lists only; +so, just \emph{"most related I could find"} for this section~... +\begin{description} + \ditem{\lineanc{ltxinput}\CPR{ltxinput}*} + \begin{itemize} + \item \wikienref{MS-DOS}{\acro{MS-DOS}} utility + (compiled from \wikienref{C (programming language)}{\acro{C}}). + \item Lists files that \emph{would} be input (recursively). + \end{itemize} + \ditem{\lineanc{tle}\CPR{texlog-extract}*} + \begin{itemize} + \item \Wikiendisambref{Ruby}{programming language} script. + \item Lists files that issued errors and warnings (colored). + \end{itemize} +\end{description} + +\nextruleview{rcs} +\section{\lineanc{rcs}3\quad \acro{RCS}/\acro{SVN}} +For \wikienref{Revision control}{revision control systems} +\wikienref{Revision control system}{\acro{RCS}} and +\wikienref{Apache Subversion}{\acro{SVN}}, there are +\begin{itemize} + \item \CPR{rcs}* \cdot\ \CPR{rcsinfo}* \cdot\ \CPR{rcs-multi}* + \item \CPR{svn}* \cdot\ \CPR{svninfo}* \cdot\ \CPR{svn-multi}* + \item \CPR{svn-prov}* provides \acro{SVN} variants of + \cs{ProvidesClass}, \cs{ProvidesFile}, and \cs{ProvidesPackage}. +\end{itemize} +\emdash sorry, I can't tell more about them right now~\dots %% 2012/04/08 + +\nextruleview{thanks} +\section{Acknowledgements} +Thanks to Martin Mnch, Moss +(I wrote this for his question), %% 2012/04/06 +and Rainer Sch”pf! +\ancref{rcs}{\acro{RCS} stuff} mainly has been stolen from +\bytopicref{revision}{Jrgen Fenn's Topic Index} of the +\mirrorctanref{help/Catalogue}{\TeX~Catalogue}. +

    %%% \vspace{24} +\hrule +\small*~not~mine\endsmall +\rightpar{\textit{% + Last~revised~\isotoday\ \copyright~\webdesignref{contact.html}{Uwe Lck} + \vspace{6} + (using \CtanPkgRef{morehype}{blog.sty} + and \CtanPkgRef{monofill}{monofill.sty}) + \vspace{6} + License: \httpref{www.latex-project.org/lppl/}{LPPL~1.3c} or later, author-maintained.}} +\entotopofpage +\vspace{550} +\finish + +%% HISTORY: +%% 2012/04/02 v0.1 first upload +%% 2012/04/02 v0.11 little improvements afterwards, +%% especially intro words for section 1 +%% 2012/04/05 v0.12 less words in section 1; +%% sub-itemize for readprov +%% 2012/04/06 wrote for Moss +%% 2012/04/08 started table, some other additions +%% 2012/04/09 continued (fix of strange bug!?) +%% +%% 2012/05/05f. v0.2 renamed `latexfileinfo-pkgs', table +%% reformatted manually, minor rewordings +%% and reformattings, link fixes +%% 2012/05/13 v0.2a modified \ProvidesFile for different +%% generation method diff --git a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/ls_finfpkgs_srcs.tex b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/ls_finfpkgs_srcs.tex deleted file mode 100644 index 55def3bbbff..00000000000 --- a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/ls_finfpkgs_srcs.tex +++ /dev/null @@ -1,8 +0,0 @@ -\RequirePackage{myfilist} -\ProvidesFile{ls_finfpkgs_srcs.tex}[2012/05/06 finfpkgs source infos] -\EmptyFileList %%% [readprov.sty,myfilist.sty] -\ReadFileInfos{finfpkgs.tex,atari.fdf} -\ReadPackageInfos{blog,blogexec,fifinddo,texlinks} -\ReadFileInfos{makehtml,texblog.fdf} -%\ReadFileInfos{ls_finfpkgs_srcs.tex} -\ListInfos[finfpkgs_SRCs.txt] diff --git a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/makehtml.tex b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/makehtml.tex deleted file mode 100644 index 42761f1706a..00000000000 --- a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/makehtml.tex +++ /dev/null @@ -1,25 +0,0 @@ -\ProvidesFile{makehtml.tex}[2012/01/07 HTML driver] -\RequirePackage{blog}[2011/11/20] \BlogInterceptEnvironments* -\RequirePackage{texlinks} \input{atari.fdf} \input{texblog.fdf} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\input{jobname} %% write with "echo" -% \def \htmljob -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% {texmap} -% {heyctan} -% {makeshow} -% {texhax} -% {aaoe1550} -% {jobs} %%% \BlogAutoPars -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% {beobacht} \uselangcode{de} %% \uselangcode 2012/01/07 -% {gtd} \uselangcode{de} -% {STEUER} \uselangcode{de} -% {GALLEY} \uselangcode{de} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\ResultFile{\htmljob\htmakeext} -\BlogProcessFinalFile[% - \TextCodes - \MakeActiveDef\"{\catchdq}%% TODO \MakeActiveLet? - ]{\htmljob.tex} -\stop diff --git a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/mkht_ltxfinfo_pkgs.tex b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/mkht_ltxfinfo_pkgs.tex new file mode 100644 index 00000000000..7c56b28099a --- /dev/null +++ b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/mkht_ltxfinfo_pkgs.tex @@ -0,0 +1,18 @@ +\ProvidesFile{mkht_ltxfinfo_pkgs.tex}[2012/05/14 HTML driver] +\RequirePackage{nicefilelist} +\MFfieldtemplate{f-base}{latexfileinfo_pkgs} +\RequirePackage{myfilist} +\RequirePackage{blog}[2011/11/20] \BlogInterceptEnvironments* +\RequirePackage{texlinks} +\input{texblog.fdf} +\input{atari_ht.fdf} %% umlauts -> entities +\def\htmljob{latexfileinfo_pkgs} +\ResultFile{\htmljob\htmakeext} +\BlogProcessFinalFile[% + \TextCodes + \MakeActiveDef\"{\catchdq}%% TODO \MakeActiveLet? + ]{\htmljob.tex} +\ReadFileInfos{mkht_ltxfinfo_pkgs,latexfileinfo_pkgs} +\ReadFileInfos{latexfileinfo_pkgs.RLS} +\ListInfos[SrcFILEs.txt] +\stop diff --git a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/upfileinfo.sh b/Master/texmf-dist/source/latex/latexfileinfo-pkgs/upfileinfo.sh deleted file mode 100755 index 79e0c7f248d..00000000000 --- a/Master/texmf-dist/source/latex/latexfileinfo-pkgs/upfileinfo.sh +++ /dev/null @@ -1,6 +0,0 @@ -echo '\def\htmljob{latexfileinfo_pkgs}' > jobname.tex -#echo '\RequirePackage{monofill,readprov}' >> jobname.tex -#echo '\ReadFileInfos{\htmljob.tex}' >> jobname.tex -## ↠\relax TODO -echo '\RequirePackage{monofill}' >> jobname.tex -latex makehtml diff --git a/Master/texmf-dist/tex/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.RLS b/Master/texmf-dist/tex/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.RLS new file mode 100644 index 00000000000..976306d53a4 --- /dev/null +++ b/Master/texmf-dist/tex/latex/latexfileinfo-pkgs/latexfileinfo_pkgs.RLS @@ -0,0 +1,5 @@ +\ProvidesFile{latexfileinfo_pkgs.RLS} %% RELEASE INFO + [2012/05/15 r0.2b refined; corr. tex/ + doc.] +% [2012/05/14 r0.2a generation refined] %% not used +% [2012/05/07 r0.2 first on CTAN] %% was "2012/05/10" with r0.2a + -- cgit v1.2.3