summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nicefilelist
diff options
context:
space:
mode:
authorManuel Pégourié-Gonnard <mpg@elzevir.fr>2012-10-06 09:08:20 +0000
committerManuel Pégourié-Gonnard <mpg@elzevir.fr>2012-10-06 09:08:20 +0000
commit99b6adc076aa7516825a10d1d52fe47e8f8730f9 (patch)
tree030e7d892779f516fb650fdfa38feaa4464036d9 /Master/texmf-dist/source/latex/nicefilelist
parent0898e1fdd27c3968ab94aca1751dbd24252babc4 (diff)
nicefilelist update
git-svn-id: svn://tug.org/texlive/trunk@27892 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/nicefilelist')
-rw-r--r--Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex32
1 files changed, 32 insertions, 0 deletions
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