filedate (7nov12)

git-svn-id: svn://tug.org/texlive/trunk@28204 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 157 insertions, 46 deletions

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{<text>}|, |\file{<text>}|, |\acro{<text>}|,
+%% |\meta{<text>}|, |\pkg{<text>}|, |\code{<text>}|, |\qtdcode{<text>}|:
+\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]