powerdot (6jan11)

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

5 files changed, 101 insertions, 34 deletions

diff --git a/Master/texmf-dist/doc/latex/powerdot/README b/Master/texmf-dist/doc/latex/powerdot/README
index ef1214af8d1..aba6aa31a17 100644
--- a/Master/texmf-dist/doc/latex/powerdot/README
+++ b/Master/texmf-dist/doc/latex/powerdot/README
@@ -1,4 +1,4 @@
-powerdot v1.4d
+powerdot v1.4e
 --------------
 
 powerdot is a presentation class for LaTeX that allows for the quick
@@ -33,7 +33,7 @@ powerdot into your LaTeX distribution
 License
 -------
 
-Copyright (C) 2005-2010 Hendri Adriaens and Christopher Ellison
+Copyright (C) 2005-2011 Hendri Adriaens and Christopher Ellison
 
 This work may be distributed and/or modified under the
 conditions of the LaTeX Project Public License, either version 1.3
diff --git a/Master/texmf-dist/doc/latex/powerdot/RunSlideDoc b/Master/texmf-dist/doc/latex/powerdot/RunSlideDoc
new file mode 100755
index 00000000000..c7bfd8db135
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/powerdot/RunSlideDoc
@@ -0,0 +1,25 @@
+#!/bin/bash
+# To generate style examples, do
+# (after extracting powerdot-styleexample.tex):
+# Do this for all available styles (replace `default' by any
+# other style name) to generate .001 and .002 files which
+# will be included by the documentation.
+
+latex powerdotSlide.tex
+latex powerdotSlide.tex
+#bibtex powerdot
+#makeindex -s gglo.ist -o powerdot.gls powerdot.glo
+#makeindex -s gind.ist -o powerdot.ind powerdot.idx
+#latex powerdot.tex
+#latex powerdot.tex
+dvips powerdotSlide.dvi
+ps2pdf powerdotSlide.ps
+
+rm *.aux *.log *.i?? *.g?? *.toc *.dvi *.blg *.ps  *.bm *.bbl
+rm powerdot-styleexample-*
+
+
+# If you also want to generate the source code documentation,
+# remove \OnlyDescription from the preamble of powerdot.dtx
+# prior to compiling the source.
+#
diff --git a/Master/texmf-dist/doc/latex/powerdot/powerdot.bib b/Master/texmf-dist/doc/latex/powerdot/powerdot.bib
index c62cec7a975..c32474f8672 100644
--- a/Master/texmf-dist/doc/latex/powerdot/powerdot.bib
+++ b/Master/texmf-dist/doc/latex/powerdot/powerdot.bib
@@ -50,7 +50,7 @@
 @MISC{PSTricksWeb,
   author       = {Herbert Vo\ss},
   title        = {\pf{PSTricks} website},
-  howpublished = {\url{http://pstricks.tug.org}}
+  howpublished = {\url{http://tug.org/pstricks/}}
 }
 
 @MISC{xkeyval,
@@ -130,6 +130,13 @@
   title        = {{\LyX\ website}},
   howpublished = {\url{http://www.lyx.org}}
 }
+
+@MISC{javascript,
+  author       = {Adobe Solutions Network},
+  title        = {{Acrobat JavaScript Scripting Reference}},
+  howpublished = {\url{http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/javascript/AcroJS.pdf}}
+}
+
 \endinput
 %%
 %% End of file `powerdot.bib'.
diff --git a/Master/texmf-dist/doc/latex/powerdot/powerdot.pdf b/Master/texmf-dist/doc/latex/powerdot/powerdot.pdf
index 8ddfc20bbf4..a7de4d5ca11 100644
--- a/Master/texmf-dist/doc/latex/powerdot/powerdot.pdf
+++ b/Master/texmf-dist/doc/latex/powerdot/powerdot.pdf
diff --git a/Master/texmf-dist/doc/latex/powerdot/powerdot.tex b/Master/texmf-dist/doc/latex/powerdot/powerdot.tex
index 7b1a02bee08..ac398e67f0c 100644
--- a/Master/texmf-dist/doc/latex/powerdot/powerdot.tex
+++ b/Master/texmf-dist/doc/latex/powerdot/powerdot.tex
@@ -2,7 +2,8 @@
 %% Copyright (C) 2005-2010 Hendri Adriaens and Christopher Ellison
 %% ---------------------------------------------------------------
 %%
-%% Version 1.4d prepared by Herbert Voss
+%% Version 1.4e prepared by Herbert Voss
+%% Additional work for the documentation by Patrice Mégret
 %%
 %% This work may be distributed and/or modified under the
 %% conditions of the LaTeX Project Public License, either version 1.3
@@ -21,7 +22,7 @@
 \usepackage{xcolor}
 \usepackage{enumitem}
 \usepackage{graphicx}
-\usepackage{pst-char}
+\usepackage{pst-text}
 \usepackage{listings}
 \usepackage{array}
 \usepackage{xkeyval}
@@ -164,8 +165,8 @@
   }{\textbf{No example files found for style \pf{#1}.}}%
 }
 
-\def\fileversion{v1.4b}
-\def\filedate{2010/10/07}
+\def\fileversion{v1.4e}
+\def\filedate{2010/12/18}
 
  \changes{v1.0}{2005/09/04}{Initial release}
  \changes{v1.1}{2005/09/19}{Fixed some small bugs}
@@ -203,16 +204,27 @@
  \changes{v1.3}{2005/12/06}{Added logo feature}
  \changes{v1.3}{2005/12/06}{Added examples and example file}
  \changes{v1.3}{2005/12/06}{Added two slide processing methods to do verbatim on slides easily}
- \changes{v1.4}{2005/12/10}{Moved \texttt{lf} and \texttt{rf} keys from
-   \texttt{global} to \texttt{glslide} family}
- \changes{v1.4}{2005/12/10}{Added \texttt{cf} option}
- \changes{v1.4}{2005/12/10}{Updated styles}
- \changes{v1.4}{2005/12/10}{Solved some small bugs}
- \changes{v1.4}{2005/12/10}{Moved footers out of slide box in handout mode}
+
+ \changes{v1.4 }{2005/12/10}{Moved \texttt{lf} and \texttt{rf} keys from \texttt{global} to \texttt{glslide} family}
+ \changes{v1.4 }{2005/12/10}{Added \texttt{cf} option}
+ \changes{v1.4 }{2005/12/10}{Updated styles}
+ \changes{v1.4 }{2005/12/10}{Solved some small bugs}
+ \changes{v1.4 }{2005/12/10}{Moved footers out of slide box in handout mode}
+ \changes{v1.4 }{2008/08/24}{Added \texttt{clockformat} and \texttt{clockrefresh} keys to \texttt{global} family}
+ \changes{v1.4 }{2008/08/24}{\texttt{blackslide} replaced by the more general \texttt{pauseslide}}
+ \changes{v1.4 }{2008/08/24}{\texttt{pauseslide} does not get randomdots anymore}
+ \changes{v1.4 }{2008/08/24}{Renames \texttt{nopagebreaks} option to \texttt{nohandoutpagebreaks}}
+ \changes{v1.4 }{2008/08/24}{Added option for no frames in handout mode}
+
  \changes{v1.4a}{2010/10/07}{fixed bug with geometry 5.x (hv)}
  \changes{v1.4b}{2010/11/16}{fixed bug with centered footnote (hv)}
  \changes{v1.4c}{2010/11/16}{fixed bug with missing macros for centered footer (hv)}
- \changes{v1.4d}{2012/12/03}{fixed missleading comment header of powerdot.cls (hv)}
+ \changes{v1.4d}{2010/12/03}{fixed misleading comment header of powerdot.cls (hv)}
+ \changes{v1.4e}{2010/12/18}{fixed bugs with enumitem (hv)}
+
+
+
+
 
 
 \begin{document}
@@ -344,12 +356,14 @@ This mode will produce a black and white overview of your slides that
 can be used to make personal notes on, for distribution to students,
 a personal guide during your talk, etcetera.
 \begin{description}
-\item\option{nopagebreaks}\\
+\item\DescribeOption{nohandoutpagebreaks}\option{nohandoutpagebreaks}\\
 By default, the handout mode produces a document with two slides per
 page. If you want to fit more slides on a page, specify this option
 in the |\documentclass| command and \pf{powerdot} will let \LaTeX\
 decide on the places to insert a page break, namely when a page is
 full.
+\item\DescribeOption{nohandoutframes}\option{nohandoutframes}\\
+In handout mode, each slide is contained in a frame by default. This option turns the frames off.
 \end{description}
 \end{description}
 
@@ -435,15 +449,16 @@ with the current section in the presentation and is preset to |false|.
 See also section~\ref{sec:structure}. Specifying this
 option turns highlighting of sections on. This could be useful when
 you are using a style that implements a split table of contents.
-\item\DescribeOption{blackslide}\option{blackslide}\\
-This option inserts a black slide in the presentation on page 1 and
+\item\DescribeOption{pauseslide}\option{pauseslide}\\
+This option inserts an empty slide (black by default) in the presentation on page 1 and
 will automatically advance to page 2 when opening the presentation
 in a PDF viewer like Acrobat (Reader). The option also inserts a
 link behind every slide or section title that brings you to the
-black slide when clicked. When you click anywhere in the black
+pause slide when clicked. When you click anywhere in the pause
 slide, you will go back to the originating slide. This option can be
 used to temporarily pause a presentation, for instance, to do a
-proof on the black board.
+proof on the black board. You can use a different color than black
+by specifying it after the option, for instance, |pauseslide=white|.
 \item\DescribeOptions{clock}\option{clock}\\
 This displays a small digital clock on slides which you can use to
 check the time left for your presentation.
@@ -457,8 +472,8 @@ Here is an example of a |\documentclass| command.
    mode=present,
    display=slidesnotes,
    style=tycja,
-   nopagebreaks,
-   blackslide,
+   nohandoutpagebreaks,
+   pauseslide,
    fleqn
  ]{powerdot}
 \end{example}
@@ -471,13 +486,13 @@ slide, normal size 12 points and flushed left equations.
    mode=handout,
    display=slidesnotes,
    style=tycja,
-   nopagebreaks,
-   blackslide,
+   nohandoutpagebreaks,
+   pauseslide,
    fleqn
  ]{powerdot}
 \end{example}
 Changing the |paper| and |mode| options, now produces a handout with
-possibly more than two slides per page due to the |nopagebreaks|
+possibly more than two slides per page due to the |nohandoutpagebreaks|
 option.
 
 \subsection{Setup options}\label{sec:pdsetup}
@@ -540,6 +555,27 @@ See for more information on controlling the layout of lists the
 \item\DescribeOptions{enumerate,itemize}\option{enumerate,itemize}\\
 As the |list| option, but only control |enumerate| and |itemize|
 environments respectively.
+\item\DescribeOption{clockformat}\option{clockformat}\\
+This option specifies the format of the clock. The format is set using
+Acrobat's |util.printd| function.\footnote{For a complete listing of
+allowable formats, consult the \textit{Acrobat JavaScript Scripting
+Reference}\cite{javascript}.} The default value is |HH:MM:ss|, which
+shows a 00-23 hour, 00-59 minute, 00-59 second clock. Example:
+\begin{example}
+clockformat=h:MM tt
+\end{example}
+The above setting will display a 1-12 hour, 00-59 minute, am/pm clock.
+That is, the clock might show |5:53 pm|.
+\item\DescribeOption{clockrefresh}\option{clockrefresh}\\
+This option should be a number which specifies how often
+the clock is refreshed in milliseconds. The default behavior is to refresh
+the clock every second. Thus, the default value is 1000. Notice, if the
+|clockformat| is such that seconds are not shown, then it makes no sense
+to update that clock every second.  A corresponding example:
+\begin{example}
+clockrefresh=60000
+\end{example}
+The interpretation of this is that the clock will be updated every minute.
 \end{description}
 
 \subsubsection{Global and local options}\label{sec:glopts}
@@ -651,7 +687,7 @@ black. If the number is positive, the color will be adjusted towards
 white, with 100 giving white. With a light background, you may want
 to choose |bright| to be positive. With a dark background, you may
 want to set it negative. The preset value is |60|, meaning a mixture
-of 40\ of the original color and 60\ white.
+of 40\% of the original color and 60\% white.
 \item\DescribeOption{dprop}\option{dprop}\\
 This option is used for passing extra parameters to the |\psdot|
 command, which creates the random dots. You could, for instance,
@@ -668,7 +704,7 @@ Here are two examples for the use of random dots.
    randomdots,dminwidth=.2\slidewidth
  }
 \end{example}
-This turns on random dots and doesn't use the left 20\ of the slide
+This turns on random dots and doesn't use the left 20\% of the slide
 for placing random dots.
 \begin{example}
  \pdsetup{
@@ -1265,7 +1301,7 @@ using BiB\TeX\ or not):\\
  \begin{slide}{Slide}
    \cite{someone}
   \end{slide}
- \begin{slide}{References}
+\begin{slide}{References}
    \begin{thebibliography}{1}
    \bibitem{someone} Article of someone.
    \end{thebibliography}
@@ -1826,7 +1862,7 @@ template.
 
 Make sure you choose a \emph{proper} name for the template, and
 avoid redefining existing templates or environments. \pf{powerdot}
-defines |blackslide|, |note| and |emptyslide| internally, so you
+defines |pauseslide|, |note| and |emptyslide| internally, so you
 shouldn't use these names unless you know what you're doing.
 Furthermore, each style needs to define at least the templates
 |slide| and |titleslide|. The |titleslide| environment will be used
@@ -1964,7 +2000,7 @@ documentation for more information.
 This defines the position of the |hook| on the paper. The lower left
 corner of the paper is given by the point |{0,0}| and the upper right
 corner by the point |{\slidewidth,\slideheight}|. So if you want to
-position the main text box at 20\ from the left edge and 30\ from
+position the main text box at 20\% from the left edge and 30\% from
 the top edge of the paper, you have to do the following.
 \begin{example}
  textpos={.2\slidewidth,.7\slideheight}
@@ -2644,16 +2680,15 @@ want to have a look at the source code description, locate
 |powerdot.dtx|, search in the file for |\OnlyDescription| and remove
 that and do
 \begin{example}
- latex powerdot.dtx
- latex powerdot.dtx
+ latex powerdot.tex
+ latex powerdot.tex
  bibtex powerdot
  makeindex -s gglo.ist -o powerdot.gls powerdot.glo
  makeindex -s gind.ist -o powerdot.ind powerdot.idx
- latex powerdot.dtx
- latex powerdot.dtx
+ latex powerdot.tex
+ latex powerdot.tex
 \end{example}
 
-\StopEventually{}
 
 \section{Implementation}\label{sec:imple}
 \subsection{General construction}