nicefilelist update

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

5 files changed, 50 insertions, 9 deletions

diff --git a/Master/texmf-dist/doc/latex/nicefilelist/SrcFILEs.txt b/Master/texmf-dist/doc/latex/nicefilelist/SrcFILEs.txt
index 7caa4482d79..781b455515b 100644
--- a/Master/texmf-dist/doc/latex/nicefilelist/SrcFILEs.txt
+++ b/Master/texmf-dist/doc/latex/nicefilelist/SrcFILEs.txt
@@ -1,17 +1,17 @@
 
      *File List*
-nicefilelist.sty  2012/05/20  v0.4   more file list alignment (UL)
+nicefilelist.sty  2012/09/30  v0.5   more file list alignment (UL)
     monofill.sty  2012/03/29  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)
+    myfilist.sty  2012/05/26  v0.4   \listfiles -- mine only (UL)
+    readprov.sty  2012/03/20  v0.3b  file infos without loading (UL)
 nicefilelist.tex  2012/05/20   --    documenting nicefilelist.sty
     provonly.fd    --  -- --   --    such
        wrong.prv   * NOT FOUND *
        empty.f     * NOT FOUND *
     srcfiles.tex  2012/05/20   --    file infos -> SrcFILEs.txt
-nicefilelist.RLS  2012/05/20  r0.4   v0.4 Kabelschacht + [r] 
+nicefilelist.RLS  2012/10/01  r0.5   v0.5 \MaxBaseEmptyList
      ***********
 
- List made at 2012/05/20, 23:40
+ List made at 2012/10/01, 08:57
  from script file srcfiles.tex
 
diff --git a/Master/texmf-dist/doc/latex/nicefilelist/nicefilelist.pdf b/Master/texmf-dist/doc/latex/nicefilelist/nicefilelist.pdf
index 938bfae21e2..f72d758866f 100644
--- a/Master/texmf-dist/doc/latex/nicefilelist/nicefilelist.pdf
+++ b/Master/texmf-dist/doc/latex/nicefilelist/nicefilelist.pdf
diff --git a/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex b/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex
index f1e97b911c5..f611a403e03 100644
--- a/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex
+++ b/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex
@@ -80,6 +80,7 @@ See Section~\ref{sec:opt} for more information.
 
 \subsection{Usage and Sample with 'myfilist.sty'}
 \label{sec:myfilist}
+\subsubsection{Basically}
 In order to get a reduced and/or rearranged list of used files 
 with the \ctanpkgref{myfilist} package, 
 `nicefilelist.sty' must be loaded earlier than 
@@ -145,11 +146,41 @@ nicefilelist.tex  2012/03/23   --    \rlap{documenting nicefilelist.sty}
 ~from script file srcfiles.tex
 \end{small}
 %% TODO update example!?
+%%
+\subsubsection{More Generally and Shorthand}
+\label{sec:short}
+In the above example, the 'myfilist' command `\EmptyFileList'
+is missing---it is not intended there. Usually however, 
+it \emph{is} intended, i.e., the following sequence of 
+lines is wanted:
+\begin{quotation}\tt\small
+\expandafter\def\expandafter\{\expandafter{\string{}
+\expandafter\def\expandafter\}\expandafter{\string}}
+\obeyspaces\obeylines
+\cs{RequirePackage}[r]\{nicefilefilelist\}
+\cs{MFfieldtemplate}\{f-base\}[<longest-name>]
+\cs{RequirePackage}\{myfilist\}
+\cs{EmptyFileList}[<read-again-files>]
+\end{quotation}
+Here you also see usage of package option |[r]| for 
+release numbers and the adjustment 
+   \[|\MFfieldtemplate{f-base}{<longest-name>}|\]
+according to Section~\ref{sec:templates}. While there are also 
+field identifiers |f-ext| and |f-version|, it seems that only 
+|f-base| varies between real-life applications.
+
+With v0.5, the last three code lines in the snippet above 
+can be replaced by 
+\[|\MaxBaseEmptyList{<longest-name>}[<read-again-files>|]\]
+---``optionally" without \qtd{`[<read-again-files>]'}.
+This may save the user from worrying about usage 
+with 'myfilist'.
 
 \section{Implementation}
 \subsection{Package File Header (Legalese)}
 \input{nicefilelist.doc}
 
+\pagebreak          %% 2012/09/30
 \section{Credits}
 \begin{enumerate}   %% 2012/05/20
   \item It was \textsc{Martin Muench} who pointed out the shortcomings 
@@ -185,3 +216,4 @@ VERSION HISTORY
                         ref. to `latexfileinfo-pkgs'
 2012/05/20  for v0.31   mention Kabelschacht
 2012/05/20  for v0.4    on new package option [r]
+2012/09/30  for v0.5    \MaxBaseEmptyList, doc. \pagebreak
diff --git a/Master/texmf-dist/tex/latex/nicefilelist/nicefilelist.RLS b/Master/texmf-dist/tex/latex/nicefilelist/nicefilelist.RLS
index 7fa50e33682..b88f8481afc 100644
--- a/Master/texmf-dist/tex/latex/nicefilelist/nicefilelist.RLS
+++ b/Master/texmf-dist/tex/latex/nicefilelist/nicefilelist.RLS
@@ -1,5 +1,6 @@
 \ProvidesFile{nicefilelist.RLS}     %% RELEASE INFO
+    [2012/10/01 r0.5 v0.5 \string\MaxBaseEmptyList]
     [{2012/05/20 r0.4 v0.4 Kabelschacht + [r] }]
-%     [2012/05/20 v0.3 Kabelschacht reimplementation]
-%     [2012/03/29 v0.2 reimpl.: much within \string\typeout]
-%     [2012/03/23 v0.1(a) initial]
+    [2012/05/20 v0.3 Kabelschacht reimplementation]
+    [2012/03/29 v0.2 reimpl.: much within \string\typeout]
+    [2012/03/23 v0.1(a) initial]
diff --git a/Master/texmf-dist/tex/latex/nicefilelist/nicefilelist.sty b/Master/texmf-dist/tex/latex/nicefilelist/nicefilelist.sty
index 4cf70735873..eb66299cae3 100644
--- a/Master/texmf-dist/tex/latex/nicefilelist/nicefilelist.sty
+++ b/Master/texmf-dist/tex/latex/nicefilelist/nicefilelist.sty
@@ -1,5 +1,5 @@
 \NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesPackage{nicefilelist}[2012/05/20 v0.4
+\ProvidesPackage{nicefilelist}[2012/09/30 v0.5
                                more file list alignment (UL)]
 
 %% Copyright (C) 2012 Uwe Lueck,
@@ -262,6 +262,13 @@
                    {\NFL@place@version{##1}\NFLspaceIII##2}%
                    {\NFLnoversion@\NFLspaceIII##1 ##2}}%
 }
+%% === Shorthand for 'myfilist' ===
+%% |\MaxBaseEmptyList{<longest-name>}[<read-again-files>]|
+%% as described in Section~\ref{sec:short} (v0.2):
+\newcommand*{\MaxBaseEmptyList}[1]{%
+    \MFfieldtemplate{f-base}{#1}%
+    \RequirePackage{myfilist}\EmptyFileList}
+%%
 %% === Leaving the Package File ===
 \endinput
 %%
@@ -290,3 +297,4 @@ v0.32  2012/05/20   removing \NFL@xpxpxp; replacing \NFL@after@false
 v0.33  2012/05/20   removing old code; added 3 %s
        STORED INTERNALLY
 v0.4   2012/05/20   option [r]
+v0.5   2012/09/30   \MaxBaseEmptyList