summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nicefilelist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-01-08 20:59:17 +0000
committerKarl Berry <karl@freefriends.org>2023-01-08 20:59:17 +0000
commit820dce948805cb27519a4848c3c5bb66275ac6b9 (patch)
treea0388353bb41779bdb13c533a9ecfe0b8a37ee79 /Master/texmf-dist/source/latex/nicefilelist
parent40228bf6894d9fd7bd88ff7e6b8f1e228f7a2c27 (diff)
nicefilelist (7jan23)
git-svn-id: svn://tug.org/texlive/trunk@65492 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/nicefilelist')
-rw-r--r--Master/texmf-dist/source/latex/nicefilelist/SrcFILEs.txt29
-rw-r--r--Master/texmf-dist/source/latex/nicefilelist/nicefilelist.RLS11
-rw-r--r--Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex82
-rw-r--r--Master/texmf-dist/source/latex/nicefilelist/provonly.fd2
-rw-r--r--Master/texmf-dist/source/latex/nicefilelist/srcfiles.tex2
5 files changed, 91 insertions, 35 deletions
diff --git a/Master/texmf-dist/source/latex/nicefilelist/SrcFILEs.txt b/Master/texmf-dist/source/latex/nicefilelist/SrcFILEs.txt
new file mode 100644
index 00000000000..1d0a9bc538e
--- /dev/null
+++ b/Master/texmf-dist/source/latex/nicefilelist/SrcFILEs.txt
@@ -0,0 +1,29 @@
+ *File List*
+-----RELEASE.--- -- -- -- -- --
+nicefilelist.RLS 2023/01/08 v0.9a ver@@; option autolength
+-----PACKAGE.--- -- -- -- -- --
+nicefilelist.sty 2023/01/08 v0.9a more file list alignment (UL)
+------DOCSRC.--- -- -- -- -- --
+nicefilelist.tex 2023/01/08 -- documenting nicefilelist.sty
+ srcfiles.tex 2023/01/08 -- file infos -> SrcFILEs.txt
+--------DEMO.--- -- -- -- -- --
+ provonly.fd -- -- -- -- no date, no version, but a lot of info,
+ look how that is wrapped!
+ wrong.prv * NOT FOUND *
+ empty.f * NOT FOUND *
+--------USED.--- -- -- -- -- --
+ hardwrap.sty 2011/02/12 v0.2 Hard wrap messages
+ myfilist.sty 2012/11/22 v0.71 \listfiles -- mine only (UL)
+ readprov.sty 2012/11/22 v0.5 file infos without loading (UL)
+ fifinddo.sty 2012/11/17 v0.61 filtering TeX(t) files by TeX (UL)
+ makedoc.sty 2012/08/28 v0.52 TeX input from *.sty (UL)
+ niceverb.sty 2015/11/21 v0.62 minimize doc markup (UL)
+ texlinks.sty 2015/07/20 v0.83 TeX-related links (UL)
+ makedoc.cfg 2013/03/25 -- documentation settings
+ mdoccorr.cfg 2012/11/13 -- `makedoc' local typographical corrections
+-not-so-much.--- -- -- -- -- --
+ kvsetkeys.sty 2022-10-05 v1.19 Key value parser (HO)
+ ***********
+
+ List made at 2023/01/08, 00:00
+ from script file srcfiles.tex \ No newline at end of file
diff --git a/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.RLS b/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.RLS
new file mode 100644
index 00000000000..fee0d9b4cad
--- /dev/null
+++ b/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.RLS
@@ -0,0 +1,11 @@
+\ProvidesFile{nicefilelist.RLS}%% RELEASE INFO
+ [2023/01/08 v0.9a ver@@; option autolength]
+ [2022/12/05 v0.8a date: dashes OK]
+ [2012/12/12 v0.7a [wrap], `mono' typo, vs.]
+ [2012/10/30 r0.7 v0.7 [wrap] option]
+ [2012/10/11 r0.6 v0.6 \string\MaxBaseEmptyList*]
+ [2012/10/01 r0.5 v0.5 \string\MaxBaseEmptyList]
+ [2012/05/20 r0.4 v0.4 Kabelschacht + [r]]
+ [2012/05/20 v0.3 Kabelschacht reimplementation]
+ [2012/03/29 v0.2 reimpl.: much within \string\typeout]
+ [2012/03/23 v0.1(a) initial] \ No newline at end of file
diff --git a/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex b/Master/texmf-dist/source/latex/nicefilelist/nicefilelist.tex
index 61681852f7e..40cdb2f8aa6 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}[2022/12/05 documenting nicefilelist.sty]
+\ProvidesFile{nicefilelist.tex}[2023/01/08 documenting nicefilelist.sty]
\title{\pkg{\huge nicefilelist.sty
}\\---\\\cs{listfiles} Alignment for Connoisseurs\thanks{This
document describes version
@@ -19,7 +19,7 @@
While \CtanPkgRef{longnamefilelist}{longnamefilelist.sty}
improves \LaTeX's \cs{listfiles} with respect to long base filenames only,
'nicefilelist.sty' can keep separate columns for
-(i)~date, (ii)~version, and (iii)~``caption" %% 1st , 2012/10/30
+(i)~date, (ii)~version, and (iii)~``caption" %% 1st, 2012/10/30
(don't write caption text in date column),
their alignment not being disturbed by short filename extensions such as `.fd'.
This is achieved basing on the \ctanpkgref{monofill} package.
@@ -84,7 +84,7 @@ you load 'nicefilelist.sty' (as usually) by
\[`\usepackage{nicefilelist}'\]
or by
\[`\usepackage[<options>]{nicefilelist}'\]
-where <options> may be `r', `wrap', or `r,wrap'~\dots---see
+where <options> may be `r', `wrap', and/or `autolength'---see
summaries in sections~\ref{sec:set} and \ref{sec:opt}
on the package options and an example in section~\ref{sec:short}.
Alternatively---e.g., for use with \ctanpkgref{myfilist} from the
@@ -159,6 +159,10 @@ Probably only adjusting the width for \emph{base} filenames
is required in real life, see the example in section~\ref{sec:short}.
(But there exist extensions .info and .mkii and versions
v4.6.3.1 (fontawesome.sty).)
+%% 2023-01-06
+Option `autolength' measures the respective length of the field and
+writes it into the .aux file for use in the next compilation run.
+This option requires \LaTeX{} format-version at least 2022-11-01.
The spaces between the columns are determined by macros
|\NFLspaceI|, |\NFLspaceII|, and |\NFLspaceIII|,
@@ -185,22 +189,21 @@ some ``newline sequence" before the first word that is too much,
and we use this feature here to put the next word into the
\emph{caption column} rather than at the beginning of the next line.
(Details and implementation are in section~\ref{sec:opt}.)
-\pagebreak
If you are not happy with the column width that 'hardwrap'
chooses, but want to assume your own width <max-line-chars>
(e.g., your width, measured by your doctor, divided by the
width of one character),
compute its difference <max-line-chars-minus-one> to 1
-(maybe by your electronic calculator, or an emulation, or
- a Lua script, cf.~\ctanpkgref{lualatex-doc}, or by
- \ctanpkgref{bigintcalc}), and enter
+(maybe by your electronic calculator, or an emulation,
+or a Lua script, cf.~\ctanpkgref{lualatex-doc}, or by
+\ctanpkgref{bigintcalc}), and enter
the 'hardwrap' instruction
\[|\setmaxprintline{<max-line-chars-minus-one>}|\]
when 'hardwrap' or 'nicefilelist' have been loaded
\emph{and} before the internal macro `\@dofilelist' is run
(which happens at the end of the document or when
- \ctanpkgref{myfilist}'s `\ListInfos' is issued, for instance).
+\ctanpkgref{myfilist}'s `\ListInfos' is issued, for instance).
\subsection{Usage and Samples with 'myfilist.sty'}
\label{sec:myfilist}
@@ -253,32 +256,47 @@ The previous code mentions the following files:
Moreover, my `.tex' files have dates, but not version numbers,
so you see what happens then:
\vskip\topsep
-\begin{small}\tt
-\obeyspaces\obeylines
-~ *File List*
-nicefilelist.sty 2012/03/23 v0.1 \rlap{more file list alignment (UL)}
-~ monofill.sty 2012/03/19 v0.1a monospace alignment (UL)
-~ myfilist.sty 2011/01/30 v0.3a \rlap{\cs{listfiles} -- mine only (UL)}
-~ readprov.sty 2010/11/27 v0.3 \rlap{file infos without loading (UL)}
-nicefilelist.tex 2012/03/23 -- \rlap{documenting nicefilelist.sty}
-~ provonly.fd -- -- -- -- such
-~ wrong.prv * NOT FOUND *
-~ empty.f * NOT FOUND *
-~ srcfiles.tex 2012/03/23 -- file infos -> SrcFILEs.txt
-~ ***********
-~
-~List made at 2012/03/23, 10:31
-~from script file srcfiles.tex
+\begin{small}
+\begin{verbatim}
+ *File List*
+-----RELEASE.--- -- -- -- -- --
+nicefilelist.RLS 2023/01/08 v0.9a ver@@; option autolength
+-----PACKAGE.--- -- -- -- -- --
+nicefilelist.sty 2023/01/08 v0.9a more file list alignment (UL)
+------DOCSRC.--- -- -- -- -- --
+nicefilelist.tex 2023/01/08 -- documenting nicefilelist.sty
+ srcfiles.tex 2023/01/08 -- file infos -> SrcFILEs.txt
+--------DEMO.--- -- -- -- -- --
+ provonly.fd -- -- -- -- no date, no version, but a lot of info,
+ look how that is wrapped!
+ wrong.prv * NOT FOUND *
+ empty.f * NOT FOUND *
+--------USED.--- -- -- -- -- --
+ hardwrap.sty 2011/02/12 v0.2 Hard wrap messages
+ myfilist.sty 2012/11/22 v0.71 \listfiles -- mine only (UL)
+ readprov.sty 2012/11/22 v0.5 file infos without loading (UL)
+ fifinddo.sty 2012/11/17 v0.61 filtering TeX(t) files by TeX (UL)
+ makedoc.sty 2012/08/28 v0.52 TeX input from *.sty (UL)
+ niceverb.sty 2015/11/21 v0.62 minimize doc markup (UL)
+ texlinks.sty 2015/07/20 v0.83 TeX-related links (UL)
+ makedoc.cfg 2013/03/25 -- documentation settings
+ mdoccorr.cfg 2012/11/13 -- `makedoc' local typographical corrections
+-not-so-much.--- -- -- -- -- --
+ kvsetkeys.sty 2022-10-05 v1.19 Key value parser (HO)
+ ***********
+
+ List made at 2023/01/08, 00:00
+ from script file srcfiles.tex
+\end{verbatim}
\end{small}
-%% TODO update example!?
-%%
+
\subsubsection{More Generally and Shorthand}
\label{sec:short}
\AddQuotes %% 2012/10/11
In the above example, the 'myfilist' command `\EmptyFileList'
-was missing---it was not intended there. Usually however, %% is -> was 2012/10/29
+was missing---it was not intended there. Usually however, %% is -> was 2012/10/29
it \emph{is} intended, i.e., the following sequence of
lines is wanted:
\begin{quotation}\tt\small
@@ -304,8 +322,6 @@ with 'myfilist'.
\DontAddQuotes
-\pagebreak
-
'nicefilelist' formats file lists nicely
even when base filenames have eight characters at most,
what \LaTeX's original `\listfiles' was made for.
@@ -316,7 +332,7 @@ works like `\MaxBaseEmptyList{nicefile}' (eight characters)---still,
optional `[<read-again-files>]' may follow. This feature is demonstrated
with \ctanpkgref{inputtrc} v/r0.3.
-\subsubsection{Sample with Wrapped Caption Column} %% 2012/10/30
+\subsubsection{Sample with Wrapped Caption Column} %% 2012/10/30
\AddQuotes
@@ -364,9 +380,8 @@ of the \TeX\ script `srcfiles.tex':
\subsection{Package File Header (Legalese)}
\input{nicefilelist.doc}
-\pagebreak
\section{Credits}
-\begin{enumerate} %% 2012/05/20
+\begin{enumerate} %% 2012/05/20
\item It was \ctanpkgauref{muench-hm}{\textsc{Martin M\"{u}nch}}
who pointed out the shortcomings
of 'longnamefilelist' that the present package addresses---thanks!
@@ -408,4 +423,5 @@ VERSION HISTORY
usage restructured and extended
2012/10/30 \listfiles
2012/12/12 for v0.7a vs.\
-2022/12/05 for v0.8a accepts also the new date format \ No newline at end of file
+2022/12/05 for v0.8a accepts also the new date format with dashes
+2023/01/06 for v0.9a regards |ver@@| for version; new option [autolength] \ No newline at end of file
diff --git a/Master/texmf-dist/source/latex/nicefilelist/provonly.fd b/Master/texmf-dist/source/latex/nicefilelist/provonly.fd
index 357896e8f8f..278740491ce 100644
--- a/Master/texmf-dist/source/latex/nicefilelist/provonly.fd
+++ b/Master/texmf-dist/source/latex/nicefilelist/provonly.fd
@@ -1,4 +1,4 @@
-%\ProvidesFile{provonly.fd}[2022/12/05 v0.11a such]
+%\ProvidesFile{provonly.fd}[2023/01/08 v0.12a such]
%\ProvidesFile{provonly.fd}[such]
\ProvidesFile{provonly.fd}[no date, no version, but a lot of info,
look how that is wrapped!] \ No newline at end of file
diff --git a/Master/texmf-dist/source/latex/nicefilelist/srcfiles.tex b/Master/texmf-dist/source/latex/nicefilelist/srcfiles.tex
index 359d5bd3231..f11a4891fbb 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}
- [2022/12/05 file infos -> SrcFILEs.txt]
+ [2023/01/08 file infos -> SrcFILEs.txt]
\RequirePackage[r,wrap]{nicefilelist}
\RequirePackage{filedate}
\MaxBaseEmptyList{nicefilelist}