From acc831c276c0d0d377139d480e0ce559af8c0e6d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 7 Nov 2012 23:25:57 +0000 Subject: filedate (7nov12) git-svn-id: svn://tug.org/texlive/trunk@28204 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/source/latex/filedate/fdatechk.tex | 10 +++ .../texmf-dist/source/latex/filedate/filedate.tex | 82 +++++++++++-------- .../texmf-dist/source/latex/filedate/makedoc.cfg | 95 ++++++++++++++++++++++ .../texmf-dist/source/latex/filedate/srcfiles.tex | 16 ++-- 4 files changed, 157 insertions(+), 46 deletions(-) create mode 100644 Master/texmf-dist/source/latex/filedate/fdatechk.tex create mode 100644 Master/texmf-dist/source/latex/filedate/makedoc.cfg (limited to 'Master/texmf-dist/source/latex/filedate') diff --git a/Master/texmf-dist/source/latex/filedate/fdatechk.tex b/Master/texmf-dist/source/latex/filedate/fdatechk.tex new file mode 100644 index 00000000000..6e8d2dfe26c --- /dev/null +++ b/Master/texmf-dist/source/latex/filedate/fdatechk.tex @@ -0,0 +1,10 @@ +\ProvidesFile{fdatechk.tex}[2012/11/06 `filedate' checks] +%% TODO short notation +\EqualityMessages +\CheckDateOfPDFmod{filedate.sty} +\CheckDateOfPDFmod{filedate.tex} +\ReadFileInfos{filedate.RLS,srcfiles} +\CheckDateOfPDFmod{filedate.RLS} +\CheckDateOfPDFmod{srcfiles.tex} +\DatesDiffWarnings +\CheckDateOfToday{filedate.RLS} diff --git a/Master/texmf-dist/source/latex/filedate/filedate.tex b/Master/texmf-dist/source/latex/filedate/filedate.tex index 2e1a2383ec5..c80305232ea 100644 --- a/Master/texmf-dist/source/latex/filedate/filedate.tex +++ b/Master/texmf-dist/source/latex/filedate/filedate.tex @@ -1,6 +1,10 @@ -\ProvidesFile{filedate.tex}[2012/10/25 documenting filedate.sty] +\ProvidesFile{filedate.tex}[2012/11/06 documenting filedate.sty] %% 2012/06/24 -\title{\pkgtitle{filedate.sty}{Access and Compare Info and Modification Date}} +\title{\pkgtitle{filedate.sty}{Access and Compare + \LaTeX~File~% %% 2012/11/06 + Info + \\ %% 2012/11/06 + and Modification Date}} % \listfiles { \RequirePackage{makedoc} \ProcessLineMessage{} \MakeJobDoc{18}%% 2012/10/16 @@ -13,12 +17,14 @@ document versions, macro programming} \usepackage{lmodern} \sloppy -\newcommand*{\TODO}[1][]{% - \textcolor{blue}{TODO\ifx$#1$\else\space#1\fi}} +% \newcommand*{\TODO}[1][]{% +% \textcolor{blue}{TODO\ifx$#1$\else\space#1\fi}} + %% <- rm. 2012/11/06 \providecommand*{\LuaTeX}{Lua\TeX} \providecommand*{\pdfTeX}{pdf\TeX} \providecommand*{\XeLaTeX}{X\lower.5ex\hbox{E}\kern-.125em\LaTeX} %% <- TODO some logo package +% \newcommand*{\qtdfile}{} %% 2012/11/06 \begin{document} \maketitle \begin{MDabstract} @@ -74,11 +80,7 @@ demonstrating what may go wrong. % \cs{CheckDateOfToday}\{wrong.tex\} % \cs{stop} % \end{quotation} -\vskip \bigskipamount -\hrule -\verbatiminput{wrong} -\hrule -\vskip \bigskipamount +\MDsampleinput{wrong} \ReadFileInfos{wrong} You may run it (by the command line \qtd{\file{latex wrong}}) and experience: \begin{enumerate} @@ -115,39 +117,44 @@ You may run it (by the command line \qtd{\file{latex wrong}}) and experience: \input{filedate.doc} \section{Use with Present Package Documentation} -At this place, the documentation source \qtd{\file{filedate.tex}} -issues -\begin{verbatim} - \EqualityMessages - \CheckDateOfPDFmod{filedate.sty} - \CheckDateOfPDFmod{filedate.tex} - \ReadFileInfos{srcfiles} - \CheckDateOfPDFmod{srcfiles.tex} -\end{verbatim} - \EqualityMessages - \CheckDateOfPDFmod{filedate.sty} - \CheckDateOfPDFmod{filedate.tex} - \ReadFileInfos{srcfiles} - \CheckDateOfPDFmod{srcfiles.tex} -in order to check whether the ``info dates" of the package file -\qtd{\file{filedate.sty}} and of the documentation source and driver -\qtd{\file{filedate.tex}} are the same as their modification dates +%% mod. 2012/11/06: +\noNiceVerb + \input{fdatechk.tex} +\useNiceVerb + +\AddQuotes + +Above this paragraph, +the documentation source `filedate.tex' issues +\[|\input{fdatechk.tex}|\] +in order to run the following \TeX~script `fdatechk.tex': +\MDsampleinput{fdatechk} +(That is done \emph{above} the paragraph to avoid wrong spacing + within the paragraph from `filedate.tex'.) +This way we check whether the ``info dates" of the package file +`filedate.sty', of the documentation source and driver +`filedate.tex', and of some other related files +are the same as their modification dates according to |\pdffilemoddate| (using \code{pdflatex}). -When I added this on 2012-10-17, it indeed informed me that I had not updated -\file{filedate.tex}'s info date +When I added the (original) check on 2012-10-17, +it indeed informed me that I had not updated +`filedate.tex's info date (\code{2012/10/16}, generation of first version of the file from a template, draft). |\EqualityMessages| confirms that the tests were run indeed. -Check for \qtd{\file{srcfiles.tex}}, the \TeX\ script generating a -release overview, has been added 2012-10-19. -That script performs the checks as well, -but I might not run it the same day. However, such checks rather -approaching package management should better be based on modification -\emph{times}. If this should be done by \TeX\ -(\CtanPkgRef{pdftex}{\pdfTeX}, \ctanpkgref{pdfcmds}), -it should better be based on the \ctanpkgref{filemod} package. +The \TeX~script `srcfiles.tex' that in the first instance +generates a release overview additionally inputs `fdatechk.tex' +(as of 2012-11-06) as well. This way the check is performed +even when I rerun the documentation without updating the file list, +as well the other way round. +%% rm. 2012/11/06: +% However, such checks rather +% approaching package management should better be based on modification +% \emph{times}. If this should be done by \TeX\ +% (\CtanPkgRef{pdftex}{\pdfTeX}, \ctanpkgref{pdfcmds}), +% it should better be based on the \ctanpkgref{filemod} package. \end{document} @@ -157,3 +164,6 @@ VERSION HISTORY 2012/10/17 completed 2012/10/19 for v0.21 added srcfiles check, corr. history 2012/10/25 for v0.3 more than two keywords, lmodern +2012/11/06 for r0.3a final demo with `fdatechk.tex', \AddQuotes + for \qtd{\file{..., and other mod.s of + doc. there; title extended diff --git a/Master/texmf-dist/source/latex/filedate/makedoc.cfg b/Master/texmf-dist/source/latex/filedate/makedoc.cfg new file mode 100644 index 00000000000..ea9293175e5 --- /dev/null +++ b/Master/texmf-dist/source/latex/filedate/makedoc.cfg @@ -0,0 +1,95 @@ +\ProvidesFile{makedoc.cfg}[2012/11/06 documentation settings] + +\author{Uwe L\"uck\thanks{\url{http://contact-ednotes.sty.de.vu}}} +% \author{Uwe L\"uck---{\tt http://contact-ednotes.sty.de.vu}} + +%% hyperref: +\RequirePackage{ifpdf} +\usepackage[% + \ifpdf +% bookmarks=false, %% 2010/12/22 +% bookmarksnumbered, + bookmarksopen, %% 2011/01/24!? + bookmarksopenlevel=2, %% 2011/01/23 +% pdfpagemode=UseNone, +% pdfstartpage=10, +% pdfstartview=FitH, + pdfstartview=0 0 100, %% 2011/08/22 + pdffitwindow=true, %% 2011/08/22 + citebordercolor={ .6 1 .6}, + filebordercolor={1 .6 1}, + linkbordercolor={1 .9 .7}, + urlbordercolor={ .7 1 1}, %% playing 2011/01/24 + \else + draft + \fi +]{hyperref} +%% metadata, |\MDkeywords|, |\MDkeywordsstring|, |\printMDkeywords| +%% 2011/08/22: +\makeatletter + \newcommand*{\MDkeywords}[1]{% + \gdef\MDkeywordsstring{#1}% + \hypersetup{pdfkeywords=\MDkeywordsstring}%% TODO!? + } + \@onlypreamble\MDkeywords + \newcommand*{\MDaddtoabstract}[1]{% %% 2012/05/10 + \par\smallskip\noindent + \strong{#1:}\quad\ignorespaces} + \newcommand*{\printMDkeywords}{% + \MDaddtoabstract{Keywords}% + \MDkeywordsstring + \global\let\MDkeywordsstring\relax + } + \newenvironment{MDabstract} + {\abstract\noindent + \hspace{1sp}%% for niceverb + \ignorespaces} + {\@ifundefined{MDkeywordsstring}% + {}% + {\printMDkeywords}% + \endabstract} +\makeatother +\hypersetup{% + pdfauthor={Uwe L\374ck}% +} +\RequirePackage{niceverb}[2011/01/24] +\RequirePackage{readprov} %% 2010/12/08 +\RequirePackage{hypertoc} %% 2011/01/23 +\RequirePackage{texlinks} %% 2011/01/24 +\RequirePackage{relsize} %% 2011/06/27 +\RequirePackage{color} %% 2011/08/06 +\RequirePackage{lmodern} %% 2012/10/29 +%% Logical markup |\strong{}|, |\file{}|, |\acro{}|, +%% |\meta{}|, |\pkg{}|, |\code{}|, |\qtdcode{}|: +\makeatletter + \def\do#1#2{\@ifdefinable#1{\let#1#2}}%% 2012/07/13 + \do\strong\textbf \do\file\texttt \do\acro\textsmaller + %% <- wrong tests before 2012/07/13 + \do\meta\textit \do \pkg\textsf \do\code\texttt + \newcommand*{\qtdcode}[1]{`\code{#1}'} %% 2012/10/24 + \ifpdf + \pdfstringdefDisableCommands{% + \let\acro\textrm + \let\file\textrm %% 2011/11/09 + \let\code\textrm %% 2011/11/20 + \let\pkg \textrm %% 2012/03/23 + } + \fi + %% TODO 2011/07/22 -> `htlogml.sty' +\makeatother +\newcommand*{\pkgtitle}[2]{% %% 2012/07/13 + \global\let\pkgtitle\relax + \pkg{\huge #1}\\---\\#2\thanks{This + document describes version + \textcolor{blue}{\UseVersionOf{\jobname.sty}} + of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}} +\newcommand*{\TODO}{\textcolor{blue}{\acro{TODO}}} +\newcommand*{\MDsampleinput}[1]{% %% 2012/11/06 + \par\bigskip\hrule\verbatiminput{#1}% + \hrule\bigskip} + +\errorcontextlines=4 +\pagestyle{headings} + +\endinput + diff --git a/Master/texmf-dist/source/latex/filedate/srcfiles.tex b/Master/texmf-dist/source/latex/filedate/srcfiles.tex index 6e10095107b..c334d9fb444 100644 --- a/Master/texmf-dist/source/latex/filedate/srcfiles.tex +++ b/Master/texmf-dist/source/latex/filedate/srcfiles.tex @@ -1,8 +1,7 @@ -\ProvidesFile{srcfiles.tex}[2012/10/25 file infos -> SrcFILEs.txt] -\RequirePackage{nicefilelist,filedate} -\MFfieldtemplate{f-base}{filedate} -\RequirePackage{myfilist} -\EmptyFileList[filedate.sty] %%% [readprov.sty,myfilist.sty] +\ProvidesFile{srcfiles.tex}[2012/11/06 file infos -> SrcFILEs.txt] +\RequirePackage[r]{nicefilelist} +\RequirePackage{filedate} +\MaxBaseEmptyList*[filedate.sty] %%% [readprov.sty,myfilist.sty] %% packages: \ReadPackageInfos{filedate} %% documentation: @@ -10,10 +9,7 @@ %% documentation settings and auxiliaries: %\ReadPackageInfos{fifinddo,makedoc,niceverb} %\ReadFileInfos{makedoc.cfg,mdoccorr.cfg} -\ReadFileInfos{srcfiles.tex} -\EqualityMessages -\CheckDateOfPDFmod{filedate.sty} -\CheckDateOfPDFmod{filedate.tex} -\CheckDateOfPDFmod{srcfiles.tex} +%\ReadFileInfos{srcfiles.tex} +\input{fdatechk} \ListInfos[SrcFILEs.txt] -- cgit v1.2.3