diff options
Diffstat (limited to 'Master/texmf-dist/source')
| -rw-r--r-- | Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex | 32 |
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 |