summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-11-07 23:25:57 +0000
committerKarl Berry <karl@freefriends.org>2012-11-07 23:25:57 +0000
commitacc831c276c0d0d377139d480e0ce559af8c0e6d (patch)
tree220f762fe1c3539936023f2c3d1364c01bddbe99 /Master/texmf-dist/source
parentc0361b0ef83b60b3ad65498c4b3520c41a281518 (diff)
filedate (7nov12)
git-svn-id: svn://tug.org/texlive/trunk@28204 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source')
-rw-r--r--Master/texmf-dist/source/latex/filedate/fdatechk.tex10
-rw-r--r--Master/texmf-dist/source/latex/filedate/filedate.tex82
-rw-r--r--Master/texmf-dist/source/latex/filedate/makedoc.cfg95
-rw-r--r--Master/texmf-dist/source/latex/filedate/srcfiles.tex16
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]