From b6227abf37f373d7db4dcf49b07c889c2fb04d2b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 12 Mar 2012 23:34:37 +0000 Subject: new latex package longnamefilelist (12mar12) git-svn-id: svn://tug.org/texlive/trunk@25620 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/longnamefilelist/README | 41 ++++++ .../doc/latex/longnamefilelist/SrcFILEs.txt | 17 +++ .../latex/longnamefilelist/longnamefilelist.pdf | Bin 0 -> 303319 bytes .../source/latex/longnamefilelist/lonaflst.tex | 59 ++++++++ .../tex/latex/longnamefilelist/lonaflst.sty | 149 +++++++++++++++++++++ Master/tlpkg/bin/tlpkg-ctan-check | 3 +- Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc | 1 + Master/tlpkg/tlpsrc/longnamefilelist.tlpsrc | 0 8 files changed, 269 insertions(+), 1 deletion(-) create mode 100644 Master/texmf-dist/doc/latex/longnamefilelist/README create mode 100644 Master/texmf-dist/doc/latex/longnamefilelist/SrcFILEs.txt create mode 100644 Master/texmf-dist/doc/latex/longnamefilelist/longnamefilelist.pdf create mode 100644 Master/texmf-dist/source/latex/longnamefilelist/lonaflst.tex create mode 100644 Master/texmf-dist/tex/latex/longnamefilelist/lonaflst.sty create mode 100644 Master/tlpkg/tlpsrc/longnamefilelist.tlpsrc 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/longnamefilelist/longnamefilelist.pdf 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[]| ``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 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 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 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{}| +%% for combining the package with 'myfilist' right in place of +%% `\listfiles[]'. 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 diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check index c5528f62b9f..e1af2c2af81 100755 --- a/Master/tlpkg/bin/tlpkg-ctan-check +++ b/Master/tlpkg/bin/tlpkg-ctan-check @@ -232,7 +232,8 @@ my @TLP_working = qw( libgreek librarian libris limap linearA linegoal lineno linguex lipsum listbib listing listings listings-ext listliketab listofsymbols lithuanian liturg lkproof lm lmake - locality localloc logbox logical-markup-utils logpap logreq lpic lps lsc + locality localloc logbox logical-markup-utils logpap logreq + longnamefilelist lpic lps lsc lshort-bulgarian lshort-chinese lshort-czech lshort-dutch lshort-english lshort-finnish lshort-french lshort-german lshort-italian lshort-japanese lshort-korean lshort-mongol lshort-persian diff --git a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc index 7871c6d7a15..17dabb9bf0f 100644 --- a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc +++ b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc @@ -392,6 +392,7 @@ depend localloc depend logbox depend logical-markup-utils depend logpap +depend longnamefilelist depend lsc depend ltabptch depend ltxdockit diff --git a/Master/tlpkg/tlpsrc/longnamefilelist.tlpsrc b/Master/tlpkg/tlpsrc/longnamefilelist.tlpsrc new file mode 100644 index 00000000000..e69de29bb2d -- cgit v1.2.3