summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/filedate
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-03-27 21:42:12 +0000
committerKarl Berry <karl@freefriends.org>2013-03-27 21:42:12 +0000
commit086cac171c683caf6fa19aa9e4c3bbbaa06ceeb4 (patch)
tree4490bf94ee0ffadd35fe934eaa8c25f9716d898a /Master/texmf-dist/source/latex/filedate
parent2cd41c75a2ebe18504b8ffbdaf0b7ed4fa279b30 (diff)
filedate (27mar13)
git-svn-id: svn://tug.org/texlive/trunk@29529 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/filedate')
-rw-r--r--Master/texmf-dist/source/latex/filedate/fdatechk.tex7
-rw-r--r--Master/texmf-dist/source/latex/filedate/filedate.tex42
-rw-r--r--Master/texmf-dist/source/latex/filedate/srcfiles.tex4
3 files changed, 36 insertions, 17 deletions
diff --git a/Master/texmf-dist/source/latex/filedate/fdatechk.tex b/Master/texmf-dist/source/latex/filedate/fdatechk.tex
index 6e8d2dfe26c..9856c423ef2 100644
--- a/Master/texmf-dist/source/latex/filedate/fdatechk.tex
+++ b/Master/texmf-dist/source/latex/filedate/fdatechk.tex
@@ -1,10 +1,7 @@
-\ProvidesFile{fdatechk.tex}[2012/11/06 `filedate' checks]
-%% TODO short notation
+\ProvidesFile{fdatechk.tex}[2013/03/25 `filedate' checks]
\EqualityMessages
-\CheckDateOfPDFmod{filedate.sty}
-\CheckDateOfPDFmod{filedate.tex}
\ReadFileInfos{filedate.RLS,srcfiles}
-\CheckDateOfPDFmod{filedate.RLS}
+\DoWithBasesExts{\CheckDateOfPDFmod}{filedate}{sty,tex,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 92c07a73351..6be4950cbe9 100644
--- a/Master/texmf-dist/source/latex/filedate/filedate.tex
+++ b/Master/texmf-dist/source/latex/filedate/filedate.tex
@@ -1,4 +1,4 @@
-\ProvidesFile{filedate.tex}[2012/11/11 documenting filedate.sty]
+\ProvidesFile{filedate.tex}[2013/03/25 documenting filedate.sty]
%% 2012/06/24
\title{\pkgtitle{filedate.sty}{Access and Compare
\LaTeX~File~% %% 2012/11/06
@@ -8,7 +8,7 @@
% \listfiles
{ \RequirePackage{makedoc} \ProcessLineMessage{}
\MakeJobDoc{18}%% 2012/10/16
- {\SectionLevelTwoParseInput} }
+ {\SectionLevelThreeParseInput} } %% Three 2013/03/24
\documentclass[fleqn]{article}%% TODO paper dimensions!?
\input{makedoc.cfg} %% shared formatting settings
\usepackage{filedate,readprov}
@@ -16,12 +16,14 @@
%% <- were these two 2012/10/25 ->
document versions, macro programming}
\usepackage{lmodern}
+\usepackage{filesdo} %% TODO makedoc.cfg? 2013/03/25
\sloppy
\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
+\newcommand*{\secref}[1]{Section~\ref{sec:#1}} %% 2013/03/24
\begin{document}
\maketitle
\begin{MDabstract}
@@ -50,8 +52,17 @@ a \LaTeX\ file is loaded while typesetting or in a
% \newpage
\section{Features and Usage}
-
-\subsection{Installing and Calling}
+\subsection{Basics of Usage} %% 2013/03/24
+\subsubsection{The Most Interesting Command}
+The package allows to check whether the file \strong{info}
+date <date> according to `\Provides' near the top of a \LaTeX\
+input file <file>---i.e.,
+\[`\Provides...{<file>}[<date> ...]'\]
+has been updated the same day when <file> actually was \strong{modified}
+most recently. With \pdfTeX, this can be checked by
+\[|\CheckDateOfPDFmod{<file>}|\]
+
+\subsubsection{Installing and Calling}
The file 'filedate.sty' is provided ready, installation only requires
putting it somewhere where \TeX\ finds it
(which may need updating the filename data
@@ -65,7 +76,7 @@ but in ``\TeX\ scripts" such as \hyperref[sec:wrong]{below},
\[|\RequirePackage{filedate}|\]
is better.
-\subsection{Demonstration with a ``\TeX\ script" Example}
+\subsubsection{Demonstration with a ``\TeX\ script" Example}
\label{sec:wrong}
The accompanying `wrong.tex' is an example of a ``\pkg{filedate} \TeX\ script"
demonstrating what may go wrong.
@@ -80,7 +91,7 @@ demonstrating what may go wrong.
% \cs{CheckDateOfToday}\{wrong.tex\}
% \cs{stop}
% \end{quotation}
-\MDsampleinput{wrong}
+\MDsamplecodeinput{wrong}
\ReadFileInfos{wrong}
You may run it (by the command line \qtd{\file{latex wrong}}) and experience:
\begin{enumerate}
@@ -110,13 +121,15 @@ You may run it (by the command line \qtd{\file{latex wrong}}) and experience:
% \subsection{The Single Commands}
% $\dots$ are described below near to their implementation.
-% \pagebreak
+ \pagebreak[2] %% 2013/03/25
\section{Implementation and Single Commands}
\subsection{Package File Header (Legalese)}
\input{filedate.doc}
+ \pagebreak %% 2013/03/25
\section{Use with Present Package Documentation}
+\label{sec:demo-here}
%% mod. 2012/11/06:
\noNiceVerb
\input{fdatechk.tex}
@@ -128,7 +141,7 @@ Above this paragraph,
the documentation source `filedate.tex' issues
\[|\input{fdatechk.tex}|\]
in order to run the following \TeX~script `fdatechk.tex':
-\MDsampleinput{fdatechk}
+\MDsamplecodeinput{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
@@ -140,9 +153,12 @@ 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).
-
+ generation of first version of the file from a template,
+ draft).---%%% 2013/03/25
|\EqualityMessages| confirms that the tests were run indeed.
+%
+|\DoWithBasesExts| is from the 'filesdo' package
+(\ctanpkgdref{commado} bundle).
The \TeX~script `srcfiles.tex' that in the first instance
generates a release overview additionally inputs `fdatechk.tex'
@@ -168,3 +184,9 @@ VERSION HISTORY
for \qtd{\file{..., and other mod.s of
doc. there; title extended
2012/11/11 for v0.4 v0.4 in abstract
+2013/03/24 for v0.41 deeper sectioning level, \secref,
+ \MDsamplecodeinput (+ `code'),
+ \subsubsections for "Basic Usage"
+2013/03/25 for v0.41 \usepackage{filesdo}, \label{sec:demo-here},
+ mentioning `filesdo' there;
+ folding and page breaks
diff --git a/Master/texmf-dist/source/latex/filedate/srcfiles.tex b/Master/texmf-dist/source/latex/filedate/srcfiles.tex
index c334d9fb444..e354f5786d5 100644
--- a/Master/texmf-dist/source/latex/filedate/srcfiles.tex
+++ b/Master/texmf-dist/source/latex/filedate/srcfiles.tex
@@ -1,6 +1,6 @@
-\ProvidesFile{srcfiles.tex}[2012/11/06 file infos -> SrcFILEs.txt]
+\ProvidesFile{srcfiles.tex}[2013/03/25 file infos -> SrcFILEs.txt]
\RequirePackage[r]{nicefilelist}
-\RequirePackage{filedate}
+\RequirePackage{filedate,filesdo}
\MaxBaseEmptyList*[filedate.sty] %%% [readprov.sty,myfilist.sty]
%% packages:
\ReadPackageInfos{filedate}