summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nicefilelist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-05-21 23:54:16 +0000
committerKarl Berry <karl@freefriends.org>2012-05-21 23:54:16 +0000
commit83ea821e5153a6e36b35e799efb3ef833dd316a4 (patch)
tree09b27fe507ba1190281b6918f9f4adfc62c536ce /Master/texmf-dist/source/latex/nicefilelist
parentf6a6e91fb663b813a417b4de2377cb578d56f646 (diff)
nicefilelist 0.4 (21may12)
git-svn-id: svn://tug.org/texlive/trunk@26551 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/nicefilelist')
-rw-r--r--Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex60
-rw-r--r--Master/texmf-dist/source/latex/nicefilelist/srcfiles.tex5
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]