nicefilelist 0.4 (21may12)

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

2 files changed, 46 insertions, 19 deletions

diff --git a/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex b/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex
index 1673621ac95..f1e97b911c5 100644
--- a/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex
+++ b/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex
@@ -1,4 +1,4 @@
-\ProvidesFile{nicefilelist.tex}[2012/03/23 documenting nicefilelist.sty]
+\ProvidesFile{nicefilelist.tex}[2012/05/20 documenting nicefilelist.sty]
 \title{\pkg{\huge nicefilelist.sty
        }\\---\\\cs{listfiles} Alignment for Connoisseurs\thanks{This
        document describes version
@@ -30,6 +30,9 @@ neither with respect to implementation nor with respect to user interface.
 \end{abstract}
 \tableofcontents
 \section{Features and Usage}
+We are describing relations to, ahm, related packages---rather brief{}ly. 
+The \ctanpkgref{latexfileinfo-pkgs} package provides a more general overview.
+%% <- 2012/05/18
 \subsection{Relation to 'longnamefilelist.sty'}
 \CtanPkgRef{longnamefilelist}{longnamefilelist.sty} equips 
 \cs{listfiles} with an optional argument for the maximum number of characters 
@@ -51,25 +54,30 @@ each other's behaviour of \cs{listfiles}.
 unless one finds that its version of \cs{listfiles} looks fine enough 
 and it is easier to understand and to use than 'nicefilelist'.
 
-\subsection{Installing and Calling}
+\subsection{Installing}
 The file 'nicefilelist.sty' is provided ready, installation only requires
 putting it somewhere where \TeX\ finds it
 (which may need updating the filename data
  base).\urlfoot{ukfaqref}{inst-wlcf} 
 
+\subsection{Calling}
 Below the `\documentclass' line(s) and above `\begin{document}',
 you load 'nicefilelist.sty' (as usually) by
-\begin{verbatim}
-  \usepackage{nicefilelist}
-\end{verbatim}
+\[`\usepackage{nicefilelist}'\]
 Alternatively---e.g., for use with \ctanpkgref{myfilist} from the 
 \ctanpkgref{fileinfo} bundle, see~Sec.~\ref{sec:myfilist}, 
 or in order to include the `.cls' file in the list---you may load it by 
-\begin{verbatim}
-  \RequirePackage{nicefilelist}
-\end{verbatim}
+\[`\RequirePackage{nicefilelist}'\]
 before `\documentclass' or when you don't use `\documentclass'. 
 
+As of v0.4, there is a package option `[r]' in order to place 
+strings like \qtd{`r0.4'} in the column reserved for version numbers. 
+You get this functionality by 
+\[`\usepackage[r]{nicefilelist}'\]
+or
+\[`\RequirePackage[r]{nicefilelist}'\]
+See Section~\ref{sec:opt} for more information.
+
 \subsection{Usage and Sample with 'myfilist.sty'}
 \label{sec:myfilist}
 In order to get a reduced and/or rearranged list of used files 
@@ -136,21 +144,35 @@ nicefilelist.tex  2012/03/23   --    \rlap{documenting nicefilelist.sty}
 ~List made at 2012/03/23, 10:31
 ~from script file srcfiles.tex
 \end{small}
+%% TODO update example!?
 
-
-% \section{Example}
-% TODO
 \section{Implementation}
-\subsection{Package File Header (Legalize)}
+\subsection{Package File Header (Legalese)}
 \input{nicefilelist.doc}
 
-\section{Credit}
-It was \textsc{Martin Muench} who pointed out the shortcomings of 'longnamefilelist'
-that the present package addresses---thanks!
+\section{Credits}
+\begin{enumerate}   %% 2012/05/20
+  \item It was \textsc{Martin Muench} who pointed out the shortcomings 
+        of 'longnamefilelist' that the present package addresses---thanks!
+  %% 2012/05/20:
+  \item For \textsc{Alois Kabelschacht}---whose idea in 
+        TUGboat~\textbf{8}~\#2\footnote{\tugbartref{tb08-2/tb18kabel}{%
+            ``&\expandafter\ vs. &\let\ and &\def\ in Conditionals 
+            and a Generalization of PLAIN's &\loop,"}
+            TUGboat Vol.~8 (1987), No.~2, pp.~184f. 
+            (\urlhttpref{tug.org/TUGboat/tb08-2/tb18kabel.pdf})}
+        is used for v0.3---cf.\ the \ctanpkgref{dowith} documentation.
+\end{enumerate}
 
 \section{Missing}
-The package once might provide \ctanpkgref{keyval}-style optional arguments for \cs{listfiles}
-or even call \cs{listfiles} automatically with 'keyval' package options.
+\begin{enumerate}
+  \item The package once might provide \ctanpkgref{keyval}-style 
+        optional arguments for \cs{listfiles} or even call \cs{listfiles} 
+        automatically with 'keyval' package options.
+  %% 2012/05/18:
+  \item Another idea from \textsc{Martin Muench}: wrapping inside caption column. 
+        Can \ctanpkgref{hardwrap} help?
+\end{enumerate}
 
 \end{document}
 
@@ -159,3 +181,7 @@ VERSION HISTORY
 2012/03/20  for v0.1    started
 2012/03/22              trying something 
 2012/03/23  for v0.1a   without "aligning the dots" etc.
+2012/05/18  for v0.30   Legalize -> Legalese; add. TODO "wrapping"; 
+                        ref. to `latexfileinfo-pkgs'
+2012/05/20  for v0.31   mention Kabelschacht
+2012/05/20  for v0.4    on new package option [r]
diff --git a/Master/texmf-dist/source/latex/nicefilelist/srcfiles.tex b/Master/texmf-dist/source/latex/nicefilelist/srcfiles.tex
index fe4d6d2b878..1fdf591deb7 100644
--- a/Master/texmf-dist/source/latex/nicefilelist/srcfiles.tex
+++ b/Master/texmf-dist/source/latex/nicefilelist/srcfiles.tex
@@ -1,5 +1,5 @@
-\ProvidesFile{srcfiles.tex}[2012/03/23 file infos -> SrcFILEs.txt]
-\RequirePackage{nicefilelist}
+\ProvidesFile{srcfiles.tex}[2012/05/20 file infos -> SrcFILEs.txt]
+\RequirePackage[r]{nicefilelist}
 \RequirePackage{myfilist}
 % \EmptyFileList[nicefilelist.sty] %%% [readprov.sty,myfilist.sty]
 %% packages:
@@ -13,5 +13,6 @@
 % \ReadPackageInfos{fifinddo,makedoc,niceverb}
 % \ReadFileInfos{makedoc.cfg,mdoccorr.cfg}
 \ReadFileInfos{srcfiles}
+\ReadFileInfos{nicefilelist.RLS} %% 2012/05/18
 \ListInfos[SrcFILEs.txt]