diff options
author | Karl Berry <karl@freefriends.org> | 2023-01-08 20:59:17 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-01-08 20:59:17 +0000 |
commit | 820dce948805cb27519a4848c3c5bb66275ac6b9 (patch) | |
tree | a0388353bb41779bdb13c533a9ecfe0b8a37ee79 /Master/texmf-dist/source | |
parent | 40228bf6894d9fd7bd88ff7e6b8f1e228f7a2c27 (diff) |
nicefilelist (7jan23)
git-svn-id: svn://tug.org/texlive/trunk@65492 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source')
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} |