summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-03-12 23:34:37 +0000
committerKarl Berry <karl@freefriends.org>2012-03-12 23:34:37 +0000
commitb6227abf37f373d7db4dcf49b07c889c2fb04d2b (patch)
tree8d3b93e41a9ed13e7f0424f9e43191dd1ea1a3a6 /Master/texmf-dist
parentf374f77a9d1f375f121bd4372b20ab5048944b00 (diff)
new latex package longnamefilelist (12mar12)
git-svn-id: svn://tug.org/texlive/trunk@25620 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/latex/longnamefilelist/README41
-rw-r--r--Master/texmf-dist/doc/latex/longnamefilelist/SrcFILEs.txt17
-rw-r--r--Master/texmf-dist/doc/latex/longnamefilelist/longnamefilelist.pdfbin0 -> 303319 bytes
-rw-r--r--Master/texmf-dist/source/latex/longnamefilelist/lonaflst.tex59
-rw-r--r--Master/texmf-dist/tex/latex/longnamefilelist/lonaflst.sty149
5 files changed, 266 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/longnamefilelist/README b/Master/texmf-dist/doc/latex/longnamefilelist/README
new file mode 100644
index 00000000000..1274957c18a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/longnamefilelist/README
@@ -0,0 +1,41 @@
+ README for the `longnamefilelist' package
+ (C) Uwe Lueck 2012/03/12
+
+
+`longnamefilelist.sty' equips LaTeX's \listfiles with an optional
+argument for the number of characters in the longest base filename.
+This way you get a neatly aligned file list even when it contains
+files whose base names have more than 8 characters. The package can
+be combined with `myfilist.sty' as explained in the documentation.
+
+KEYWORDs: file info; file version, macro programming
+
+RELATED PACKAGES: classlist, dateiliste, ltxfileinfo, ltxinput, myfilist
+
+LICENSE:
+
+The package file `longnamefilelist.sty' and the documentation files
+`longnamefilelist.pdf' and `longnamefilelist.tex' can be redistributed
+and/or modified under the terms of the LaTeX Project Public License;
+either version 1.3c of the License, or any later version, see
+
+ http://www.latex-project.org/lppl.txt
+
+We did our best to help you, but there is NO WARRANTY.
+
+The `longnamefilelist' package is author-maintained in the sense of
+this license.
+
+The latest public version of the package is available at
+
+ http://mirror.ctan.org/macros/latex/contrib/longnamefilelist/
+
+A TDS version of the package is available as
+
+ http://mirror.ctan.org/install/macros/latex/contrib/longnamefilelist.tds.zip
+
+Please report bugs, problems, and suggestions via
+
+ http://www.contact-ednotes.sty.de.vu
+
+
diff --git a/Master/texmf-dist/doc/latex/longnamefilelist/SrcFILEs.txt b/Master/texmf-dist/doc/latex/longnamefilelist/SrcFILEs.txt
new file mode 100644
index 00000000000..bb452e1e672
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/longnamefilelist/SrcFILEs.txt
@@ -0,0 +1,17 @@
+
+ *File List*
+longnamefilelist.sty 2012/03/12 v0.1 list files with long names (UL)
+ myfilist.sty 2011/01/30 v0.3a \listfiles -- mine only (UL)
+ readprov.sty 2010/11/27 v0.3 file infos without loading (UL)
+longnamefilelist.tex 2012/03/12 documenting longnamefilelist.sty
+ fifinddo.sty 2012/01/20 v0.51 filtering TeX(t) files by TeX (UL)
+ makedoc.sty 2011/11/19 v0.42 TeX input from *.sty (UL)
+ niceverb.sty 2011/12/05 v0.44 minimize doc markup (UL)
+ makedoc.cfg 2011/11/20 documentation settings
+ mdoccorr.cfg 2011/12/03 local typographical corrections with makedoc.sty
+ srcfiles.tex 2012/03/12 file infos -> SrcFILEs.txt
+ *******************
+
+ List made at 2012/03/12, 14:11
+ from script file srcfiles.tex
+
diff --git a/Master/texmf-dist/doc/latex/longnamefilelist/longnamefilelist.pdf b/Master/texmf-dist/doc/latex/longnamefilelist/longnamefilelist.pdf
new file mode 100644
index 00000000000..11457d39baa
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/longnamefilelist/longnamefilelist.pdf
Binary files differ
diff --git a/Master/texmf-dist/source/latex/longnamefilelist/lonaflst.tex b/Master/texmf-dist/source/latex/longnamefilelist/lonaflst.tex
new file mode 100644
index 00000000000..72e7965296f
--- /dev/null
+++ b/Master/texmf-dist/source/latex/longnamefilelist/lonaflst.tex
@@ -0,0 +1,59 @@
+\ProvidesFile{longnamefilelist.tex}[2012/03/12 documenting longnamefilelist.sty]
+\title{\textsf{longnamefilelist.sty}\\---\\\cs{listfiles}
+ when some File Names\\Consist of quite a Lot of
+ Characters, such as\\\relax
+ [\,to be continued in next package update\,]\thanks{This
+ document describes version
+ \textcolor{blue}{\UseVersionOf{\jobname.sty}}
+ of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
+{ \RequirePackage{makedoc} \ProcessLineMessage{}
+ \MakeJobDoc{19}
+ {\SectionLevelTwoParseInput} }
+\documentclass[fleqn]{article}%% TODO paper dimensions!?
+\input{makedoc.cfg} %% shared formatting settings
+\ReadPackageInfos{longnamefilelist}
+\sloppy
+\begin{document}
+\maketitle
+\begin{abstract}\noindent
+'longnamefilelist.sty' equips \LaTeX's `\listfiles' with an optional
+argument for the number of characters in the longest base filename.
+This way you get a neatly aligned file list even when it contains
+files whose base names have more than 8 characters.
+\end{abstract}
+\tableofcontents
+
+% \newpage
+% \section{Features and Usage}
+\section{Installing and Calling}
+The file 'longnamefilelist.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} %% corr. 2011/02/08
+
+%% extended 2011/01/14:
+Below the `\documentclass' line(s) and above `\begin{document}',
+you load 'longnamefilelist.sty' (as usually) by
+\begin{verbatim}
+ \usepackage{longnamefilelist}
+\end{verbatim}
+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{longnamefilelist}
+\end{verbatim}
+before `\documentclass' or when you don't use `\documentclass'.
+
+% \section{Example}
+
+% \pagebreak
+% \section{Implementation}
+\section{Package File Header (Legalize)}
+\input{longnamefilelist.doc}
+\end{document}
+
+VERSION HISTORY
+
+2012/03/11 for v0.1 started
+2012/03/12 completed
diff --git a/Master/texmf-dist/tex/latex/longnamefilelist/lonaflst.sty b/Master/texmf-dist/tex/latex/longnamefilelist/lonaflst.sty
new file mode 100644
index 00000000000..2ee96f83e5f
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/longnamefilelist/lonaflst.sty
@@ -0,0 +1,149 @@
+\NeedsTeXFormat{LaTeX2e}[1994/12/01]
+\ProvidesPackage{longnamefilelist}[2012/03/12 v0.1
+ list files with long names (UL)]
+%%
+%% Copyright (C) 2012 Uwe Lueck,
+%% http://www.contact-ednotes.sty.de.vu
+%% -- author-maintained in the sense of LPPL below --
+%%
+%% This file can be redistributed and/or modified under
+%% the terms of the LaTeX Project Public License; either
+%% version 1.3c of the License, or any later version.
+%% The latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% We did our best to help you, but there is NO WARRANTY.
+%%
+%% Please report bugs, problems, and suggestions via
+%%
+%% http://www.contact-ednotes.sty.de.vu
+%%
+%% == Usage with 'myfilist' ==
+%% \label{sec:myfilist}
+%% In order to get a reduced and/or rearranged list of used files
+%% with the \ctanpkgref{myfilist} package,
+%% `longnamefilelist.sty' must be loaded earlier than
+%% `myfilist.sty'. This is due to a kind of limitation of the latter,
+%% it \emph{issues} `\listfiles' (TODO).
+%% Therefore `\listfiles' must be modified earlier---or \emph{issued} earlier,
+%% in this case the `\listfiles' in `myfilist.sty' does nothing.
+%% The file `SrcFILEs.txt' accompanying the distribution of 'longnamefilelist',
+%% e.g., can be generated by running the following file `srcfiles.tex'
+%% with \LaTeX:
+%% \begin{verbatim}
+%% \ProvidesFile{srcfiles.tex}[2012/03/12
+%% file infos -> SrcFILEs.txt]
+%% \RequirePackage{longnamefilelist}
+%% \listfiles[16]
+%% \RequirePackage{myfilist}
+%% %% documentation:
+%% \ReadFileInfos{longnamefilelist}
+%% %% documentation settings and auxiliaries:
+%% \ReadPackageInfos{fifinddo,makedoc,niceverb}
+%% \ReadFileInfos{makedoc.cfg,mdoccorr.cfg,srcfiles}
+%% \ListInfos[SrcFILEs.txt]
+%% \end{verbatim}
+%%
+%% == \cs{listfiles} extended ==
+%% \label{sec:list}
+%% |\listfiles[<number>]| ``orders" a final list of files
+%% with infos and optimizes the list's alignment
+%% (in plain text output) when the longest base filename
+%% consists of <number> characters:
+\renewcommand*{\listfiles}[1][\LNFL@chars@set]{%
+%% The default parameter `\LNFL@chars@set' is defined in Sec.~\ref{sec:set}.
+ \let\listfiles\relax
+ \def\LNFL@chars{#1}%
+%% This stores the actual parameter. It is used several times:
+%% for preparing the alignment and the final line of stars here
+%% and then for aligning each list entry by `\@listfiles'
+%% from `\@dofilelist'.
+%%
+%% \LaTeX's `\@dofilelist' appends a list of ``dummy" tokens `\\'
+%% to each filename before `\@listfiles' is run on the filename.
+%% \LaTeX's `\@listfiles' is run 8 times, and there are 8 dummies.
+%% Dummies not looked at by `\@listfiles' are removed by some
+%% ``killing" macro using a token that delimits the dummy list.
+%% We use `\relax' tokens as dummies instead. They need not to be removed.
+%% And we append <number> dummies. They are stored in a macro `\LNFL@dummies':
+ \let\LNFL@dummies\@empty
+%% `\LNFL@spaces' is used to align the list title ``*file list*"
+%% flushleft with the filenames:
+ \def\LNFL@spaces{ }%
+%% We also use more stars than \LaTeX below the list.
+%% (However, all of this can also be used for \emph{shorter} names
+%% with \emph{less} stars below.)
+ \def\LNFL@stars{***}%
+ \count@\LNFL@chars\relax
+%% This initializes the loop for adding dummies, title spaces,
+%% and stars below the list.
+ \@whilenum\count@>\z@\do{%
+ \edef \LNFL@dummies{\LNFL@dummies\relax}%
+ \ifnum8<\count@
+ \edef \LNFL@spaces { \LNFL@spaces}%
+ \fi
+ \edef \LNFL@stars {*\LNFL@stars}%
+ \advance\count@\m@ne
+ }%
+%% Our version of `\@listfiles' takes one token ahead at a time
+%% and counts the numbes of tokens that have been looked at so far.
+%% For each \emph{dummy} found instead of a filename character,
+%% (as with \LaTeX) a space is added to `\filename@area'
+%% that is used to move the filenames right.
+%% As opposed to the \LaTeX\ original version, `\@listfiles' stops
+%% being applied after <number> times:
+ \def\@listfiles##1{%
+ \ifx##1\relax \edef\filename@area{ \filename@area}\fi
+ \advance\count@\m@ne
+ \ifnum\count@>\z@ \expandafter\@listfiles \fi }%
+ \def\@dofilelist{%
+%% In \LaTeX's `\@dofilelist', we first replace the single space
+%% starting the title line by `\LNFL@spaces':
+ \typeout{^^J\LNFL@spaces *File List*}%
+ \@for\@currname:=\@filelist\do{%
+%% This is the loop body adding a list entry line, first like \LaTeX:
+ \filename@parse\@currname
+ \edef\reserved@a{%
+ \filename@base.%
+ \ifx\filename@ext\relax tex\else\filename@ext\fi}%
+ \expandafter\let\expandafter\reserved@b
+ \csname ver@\reserved@a\endcsname
+%% We use `\@tempa' for expanding both the filename and the list of dummies
+%% in time:
+ \edef\@tempa{\filename@base\LNFL@dummies}%
+ \count@\LNFL@chars\relax
+ \expandafter\expandafter\expandafter\@listfiles\expandafter
+ \filename@area\@tempa
+ \typeout{%
+ \filename@area\reserved@a
+ \ifx\reserved@b\relax\else
+%% I prefer \emph{two} spaces between the columns to four of them:
+ \space\space %%% \@spaces
+ \reserved@b\fi}}%
+%% The line of stars:
+ \typeout{ \LNFL@stars^^J}}%
+}
+%% == Setting Name Length \emph{before} \cs{listfiles} ==
+%% \label{sec:set}
+%% I first used |\SetLongNameFileListChars{<number>}|
+%% for combining the package with 'myfilist' right in place of
+%% `\listfiles[<number>]'. Both commands have the same effect
+%% on the following `\RequirePackage{myfilist}'.
+%% Now that I have realized that I could issue `\listfiles' earlier,
+%% `\SetLongNameFileListChars' is rather obsolete---but who knows...?
+\newcommand*{\SetLongNameFileListChars}{\def\LNFL@chars@set}
+%% This macro `\LNFL@chars@set' is used as the default for our new
+%% optional parameter for `\listfiles' (Sec.~\ref{sec:list}).
+\SetLongNameFileListChars{8}
+%% This sets the default value for `\listfiles' to the maximum number
+%% of characters in the base filename that `\LaTeX' somewhat expects.
+%%
+%% TODO: 1.~keyval package option avoiding `\listfiles'
+%% 2.~measuring longest filename?
+%%
+%% == Leaving the Package File ==
+\endinput
+%%
+%% == VERSION HISTORY ==
+
+v0.1 2012/03/11 very first
+ 2012/03/12 debugging; \LNFL@spaces, \LNFL@stars