tdlock update (23jun09)

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

5 files changed, 86 insertions, 6 deletions

diff --git a/Master/texmf-dist/doc/latex/tdclock/README b/Master/texmf-dist/doc/latex/tdclock/README
index 614b6527437..23d0f1ce1ec 100644
--- a/Master/texmf-dist/doc/latex/tdclock/README
+++ b/Master/texmf-dist/doc/latex/tdclock/README
@@ -1,6 +1,6 @@
 Package name:		tdclock (The LaTeX tdclock)
 Package authors:	Luis Randez, Juan I. Montijano
-Version/Release:	2.0
+Version/Release:	2.2
 
 Features:
 
@@ -14,4 +14,4 @@ Installation:
 Copy the package file tdclock.sty to a directory where LATEX can find it.
 
 
-December 2008
\ No newline at end of file
+June 2009
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/tdclock/tdclock-beamer-example.pdf b/Master/texmf-dist/doc/latex/tdclock/tdclock-beamer-example.pdf
index 249674a467b..2e9628a2600 100644
--- a/Master/texmf-dist/doc/latex/tdclock/tdclock-beamer-example.pdf
+++ b/Master/texmf-dist/doc/latex/tdclock/tdclock-beamer-example.pdf
diff --git a/Master/texmf-dist/doc/latex/tdclock/tdclock-beamer-example.tex b/Master/texmf-dist/doc/latex/tdclock/tdclock-beamer-example.tex
index ff802f4ffef..c90ed74894e 100644
--- a/Master/texmf-dist/doc/latex/tdclock/tdclock-beamer-example.tex
+++ b/Master/texmf-dist/doc/latex/tdclock/tdclock-beamer-example.tex
@@ -2,7 +2,8 @@
 %\usepackage[font=Times, timeinterval=10]{tickingclock}
 %\usepackage[font=Cour, timeinterval=10]{tickingclock}
 %\usepackage[font=Helv, timeinterval=30]{tickingclock}
-\usepackage[timeinterval=10]{tdclock}
+\usepackage[font=Times,timeinterval=10, timeduration=2.0, timedeath=0, fillcolorwarningsecond=white!60!yellow,
+timewarningfirst=50,timewarningsecond=80]{tdclock}
 %\usepackage{times}
 %\usepackage{helvet}
 
diff --git a/Master/texmf-dist/doc/latex/tdclock/tdclock-doc.pdf b/Master/texmf-dist/doc/latex/tdclock/tdclock-doc.pdf
index cab6dbe21a7..8fd4a8d8d35 100644
--- a/Master/texmf-dist/doc/latex/tdclock/tdclock-doc.pdf
+++ b/Master/texmf-dist/doc/latex/tdclock/tdclock-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/tdclock/tdclock-doc.tex b/Master/texmf-dist/doc/latex/tdclock/tdclock-doc.tex
index 35cc0b7041b..2c851f48a9e 100644
--- a/Master/texmf-dist/doc/latex/tdclock/tdclock-doc.tex
+++ b/Master/texmf-dist/doc/latex/tdclock/tdclock-doc.tex
@@ -3,9 +3,10 @@
 \usepackage{xcolor}
 \usepackage{hyperref}
 \usepackage{xkeyval}
-\usepackage[font=Times,timeinterval=1]{tdclock}
+\usepackage[font=Times,timeinterval=10,timeduration=2.0, timewarningfirst=50,timewarningsecond=70,
+fillcolorwarningsecond=white!60!yellow, timedeath=0]{tdclock}
 
-\title{The Ticking Digital Clock \texttt{tdclock} package v2.0}
+\title{The Ticking Digital Clock \texttt{tdclock} package v2.2}
 \author{Luis R\'{a}ndez \& Juan I. Montijano}
 %\affiliation[IUMA]{IUMA \\ Universidad de Zaragoza }
 \date{\today}
@@ -51,8 +52,85 @@ Times & TimesI & TimesBI \\
 Cour  & CourI  & CourBI &&&
 \end{tabular}
 
-\item[]By now no other fonts, like \TeX\ ones, can be used.  This restriction comes from the fact that the
+\item[]At the moment no other fonts, like \TeX\ ones, can be used.  This restriction comes from the fact that the
 ``dynamic'' clock is based on javascript code embedded into the pdf document.
+
+\item  timeduration=``time (in mimutes)''
+\item[]
+``time'' can be any integer or decimal number. This option is intended to be used in presentations (beamer for example).
+Its value specifies the time the presentation should last.  This option has sense in conjunction with the next options.
+
+\item  timewarningfirst= $n$
+\item[]
+$n$ can be any integer between 1 and 100. With this option set, after $n$\% of the time specified in  timeduration,
+the color and background of the tdclock time  will change, according to the next options.
+This can be used as a first warning that you are running out time for the presentation.  The default is set to 90.
+
+\item  timewarningsecond= $n$
+\item[]
+$n$ can be any integer between 1 and 100 (usually greater than timewarningfirst). With this option set, after $n$\% of the time specified in  timeduration,
+the color and background of the tdclock time  will change, according to the next options.
+This can be used
+as a second warning that you have little time to finish the presentation.  The default is set to 95.
+
+\item  colorwarningfirst= ``color''
+\item[]
+This option specifies the color for the tdclock time after the time specified by
+timeduration and timewarningfirst options. The default is orange.
+
+\item  fillcolorwarningfirst= ``color''
+\item[]
+This option specifies the color background for the tdclock time after the time specified by
+timeduration and timewarningfirst options. The default is ``transparent''.
+This has only effect on time specified by $\backslash$crono, $\backslash$tdclock and $\backslash$tdtime
+time orders.
+
+\item  colorwarningsecond= ``color''
+\item[]
+This option specifies the color for the tdclock time after the time specified by
+timeduration and timewarningsecond options. The default is red.
+
+\item  fillcolorwarningsecond= ``color''
+\item[]
+This option specifies the color background for the tdclock time after the time specified by
+timeduration and timewarningsecond options. The default is ``transparent''.
+This has only effect on time specified by $\backslash$crono, $\backslash$tdclock and $\backslash$tdtime
+time orders.
+
+\item  timedeath= 0 or 1
+\item[]
+If this option is set to 1, after 110\% of the time specified in  timeduration,
+the pdf document will be closed.  The default is set to 0 (the document is not closed).
+\end{itemize}
+
+Some examples of using the options
+
+\begin{itemize}
+\item
+{\bf $\backslash$usepackage[font=Times, timeinterval=59]\{tdclock\} }
+
+\item[] Only the font (Times) and the time (59 seconds) for updating the clock is specified.  No warning indicating
+that the time for the presentation is finishing will be given.
+
+\item
+{\bf $\backslash$usepackage[font=Times, timeinterval=30, timeduration=20, \\
+timewarningfirst=85, timewarningsecond=90, \\
+fillcolorwarningsecond=white!60!yellow]\{tdclock\} }
+
+\item[] In addition to the font (Times) and the time (30 seconds) for updating the clock, a duration of the presentation of 20 minutes is specified.  The color of the clock font will be set to orange after 17 minutes (85\% of 20).  This color will be changed to red,
+    and the background to white!60!yellow after 18 minutes(90\% of 20).
+
+\item
+{\bf $\backslash$usepackage[timeduration=60, timewarningfirst=90, \\
+timewarningsecond=95, colorwarningfirst=blue, \\
+fillcolorwarningfirst=white!60!yellow, \\
+fillcolorwarningsecond=white!10!yellow, timedeath=1]\{tdclock\} }
+
+\item[] A duration of the presentation of 60 minutes is specified.  The color of the clock font will be set to blue
+after 54 minutes (90\% of 60) with a background white!60!yellow.  The font color will be changed to red after
+57 minutes and the background to white!10!yellow.  The document will close automatically after 66 minutes
+(110\% of 60).
+
 \end{itemize}
 
 \section{Restrictions--requirements}
@@ -221,6 +299,7 @@ macro  &  result  &  action \\
  $\backslash$crono            & \crono                               & stopwatch       \\ \hline
  $\backslash$cronohours       & \cronohours                          & crono hours   \\\hline
  $\backslash$cronominutes     & \cronominutes                        & crono minutes \\\hline
+ $\backslash$tdwarningbox\{$\backslash$cronominutes\}     &  \tdwarningbox{\cronominutes}         & warning boxed crono minutes \\\hline
  $\backslash$cronoseconds     & \cronoseconds                        & crono seconds \\\hline
  $\backslash$resetcrono\{``button''\}       & \resetcrono{\fbox{reset}}     & sets crono time to zero    \\\hline
  $\backslash$toggleclock\{``button''\}      & \toggleclock{\fbox{toggle}}    & toggle time-crono   \\\hline