summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/filemod/README
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-03-25 22:32:09 +0000
committerKarl Berry <karl@freefriends.org>2011-03-25 22:32:09 +0000
commit3e0da7063ec8c3bfc7455bfe9935bda3d82e9dc5 (patch)
tree5cd6b56bafe2f5d5920fd004bcf34a733343a9f6 /Master/texmf-dist/doc/latex/filemod/README
parentcfed44562985f2f168a5b2f6df46bcaec533d7e9 (diff)
filemod (25mar11)
git-svn-id: svn://tug.org/texlive/trunk@21831 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/filemod/README')
-rw-r--r--Master/texmf-dist/doc/latex/filemod/README46
1 files changed, 42 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/latex/filemod/README b/Master/texmf-dist/doc/latex/filemod/README
index 61f1f3455b1..6f48dd2195d 100644
--- a/Master/texmf-dist/doc/latex/filemod/README
+++ b/Master/texmf-dist/doc/latex/filemod/README
@@ -1,15 +1,17 @@
The filemod Package
~~~~~~~~~~~~~~~~~~~
Copyright (C) Martin Scharrer <martin@scharrer-online.de>
-Version v1.0 -- 2011/03/23
This package provides macros to read and compare the modification dates
of files. These files can be .tex files, images or other files as long as they can be
found by the LaTeX compiler. It uses the \pdffilemoddate primitive of pdfLaTeX
to receive the file modification date as PDF date string, parses it and returns
-the value to the user. This package will also work for DVI output with recent
-versions of the LaTeX compiler which uses pdfLTEX in DVI mode. The functionality
-is provided by purely expandable macros or by faster but non-expandable ones.
+the value to the user.
+The functionality is provided by purely expandable macros or by faster but non-expandable ones.
+
+This package will work with LaTeX and plain eTeX as long pdf(La)TeX (in
+PDF or DVI mode) or Lua(La)TeX is used. Xe(La)TeX is not supported because it
+does not provide \pdffilemoddate.
Examples:
% Prints file modification date and time of main file
@@ -18,3 +20,39 @@ Examples:
% Include newest of a set of files:
\input{\filemodNewest{{file1}{file2}{file3}}}
+ % Include newest of a set of images:
+ % (\includegraphics doesn't expand its fully before parsing it)
+ \FilemodNewest{{file1}{file2}{file3}}
+ \includegraphics{\filemodresultfile}
+
+
+REQUIREMENTS:
+=============
+pdflatex v1.30.0 or later is required.
+Alternative LuaTeX can be used together with the `pdftexcmds` package.
+
+
+INSTALLATION:
+=============
+Compile the DTX file (with included INS file) through pdflatex:
+
+ pdflatex filemod.dtx
+ pdflatex filemod.dtx
+ pdflatex filemod.dtx
+
+Copy the files to the following directories which must be created beforehand.
+Example for a Unix/Linux OS, change accordantly for MS Windows and Mac, e.g.
+copy it using a graphics interface.
+
+ cp filemod*.sty ${TEXMF}/tex/latex/filemod/
+ cp filemod*.tex ${TEXMF}/tex/generic/filemod/
+
+OPTIONAL:
+The documentation can be installed by:
+ cp filemod.pdf README ${TEXMF}/doc/latex/filemod/
+
+The source can be installed by:
+ cp filemod.dtx ${TEXMF}/source/latex/filemod/
+
+The TEXMF is /usr/local/texlive/2010/texmf-dist, ${HOME}/texmf or similar.
+