animate update (10may07)

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

3 files changed, 10 insertions, 8 deletions

diff --git a/Master/texmf-dist/doc/latex/animate/README b/Master/texmf-dist/doc/latex/animate/README
index 2ab44324c3a..432c0e5b31e 100644
--- a/Master/texmf-dist/doc/latex/animate/README
+++ b/Master/texmf-dist/doc/latex/animate/README
@@ -60,9 +60,9 @@ Usage:
 
  \begin{animateinline}[<options>]{<frame rate>}
      ... typeset material ...
- \newframe
+ \newframe[<frame rate>]
      ... typeset material ...
- \newframe*
+ \newframe*[<frame rate>]
      ... typeset material ...
  \end{animateinline}
 
diff --git a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf b/Master/texmf-dist/doc/latex/animate/doc/animate.pdf
index c46cab4a786..8d59b124085 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf
+++ b/Master/texmf-dist/doc/latex/animate/doc/animate.pdf
diff --git a/Master/texmf-dist/doc/latex/animate/doc/animate.tex b/Master/texmf-dist/doc/latex/animate/doc/animate.tex
index 0a811854fe5..59662947087 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/animate.tex
+++ b/Master/texmf-dist/doc/latex/animate/doc/animate.tex
@@ -108,16 +108,18 @@ and the environment
 \begin{verbatim}
 \begin{animateinline}[<options>]{<frame rate>}
     ... typeset material ...
-\newframe
+\newframe[<frame rate>]
     ... typeset material ...
-\newframe*
+\newframe*[<frame rate>]
     ... typeset material ...
 \end{animateinline}
 \end{verbatim}
 
-While \verb+\animategraphics+ can be used to assemble animations from sets of existing graphics files, the environment `\verb+animateinline+' is intended to create the animation from the typeset material it encloses. This material can be pictures drawn within the \LaTeX{} \verb+picture+ environment or using the advanced capabilities of PSTricks or pgf/TikZ. Even ordinary textual material may be animated in this way. The command \verb+\newframe+ terminates a frame and starts the next one. There is a starred version, \verb+\newframe*+. If placed after a particular frame it causes the animation to pause at that frame. The animation continues normally after clicking it again.
+While \verb+\animategraphics+ can be used to assemble animations from sets of existing graphics files, the environment `\verb+animateinline+' is intended to create the animation from the typeset material it encloses. This material can be pictures drawn within the \LaTeX{} \verb+picture+ environment or using the advanced capabilities of PSTricks or pgf/TikZ. Even ordinary textual material may be animated in this way. The parameter \verb+<frame rate>+ specifies the number of frames per second of the animation. 
 
-The parameter \verb+<frame rate>+ specifies the number of frames per second of the animation. All files of the sequence must be consecutively numbered. {\tt <file base\-name>} is the leftmost part of the file name that all members of the sequence have in common. \verb+<first>+ is the number of the first and \verb+<last>+ the number of the last file in the set. \verb+<first>+ and \verb+<last>+ must have the same number of digits to ensure proper sorting. If necessary, rename the files with zeros padded to the left.
+The command \verb+\newframe+ terminates a frame and starts the next one. It can be used inside the `\verb+animateinline+' environment only. There is a starred version, \verb+\newframe*+. If placed after a particular frame it causes the animation to pause at that frame. The animation continues normally after clicking it again. Both \verb+\newframe+ variants take an optional argument that allows to change the frame rate in the middle of an animation.
+
+All files of the sequence must be consecutively numbered. {\tt <file base\-name>} is the leftmost part of the file name that all members of the sequence have in common. \verb+<first>+ is the number of the first and \verb+<last>+ the number of the last file in the set. \verb+<first>+ and \verb+<last>+ must have the same number of digits to ensure proper sorting. If necessary, rename the files with zeros padded to the left.
 
 There is no file name extension to be specified as parameter. The possible file formats depend on whether \LaTeX{} or pdf\LaTeX{} is used. In the case of \LaTeX{}, files with the extension `\verb+eps+' are searched for at first, followed by `\verb+mps+' (\MP-generated Postscript) and `\verb+ps+'. With pdf\LaTeX{} the searching order is: (1)~`\verb+pdf+', (2)~`\verb+mps+', (3)~`\verb+png+', (4)~`\verb+jpg+', (5)~`\verb+jpeg+', (6)~`\verb+jbig2+' and (7)~`\verb+jb2+'. That is, files capable to store vector graphics are found first. Make sure that all file names have \emph{lower case} extensions.
 
@@ -323,13 +325,13 @@ Specifies which frame (first, last or none) to display and print if the animatio
 \end{verbatim}
 \normalsize
 
-  \item Currently, animations cannot be placed on multilayered slides created with the Beamer class. Put animations on flat slides only. (Of course, slides without animations may still have overlays.)
+  \item Currently, animations should not be placed on \emph{multilayered} slides created with the Beamer class. Although possible, the result might be disappointing. Put animations on flat slides only. (Of course, slides without animations may still have overlays.)
 
   \item The \verb+dvips+ option `\verb+-Ppdf+' should be avoided entirely or followed by `\verb+-X 2400+ \verb+-Y 2400+' on the command line in order to set a sensible DVI resolution. In times of Type-1 fonts, this does \emph{not} degrade the output quality! The configuration file `\verb+config.pdf+' loaded by option `\verb+-Ppdf+' specifies an excessively high DVI resolution that will be passed on to the final PDF. Eventually, Adobe Reader gets confused and will not display the frames within the animation widget.
 
   \item Animations with complex graphics and/or many frames may cause \LaTeX{} to fail with a `\verb+TeX capacity exceeded+' error. Enlarge \TeX{}'s memory with command line option `\verb+--mem-max=...+'.
 
-  \item Originally, package `\verb+animate+' was based on a method suggested by Jan Hole\v{c}ek and Petr Soika~\cite{hol04}, but was rewritten to use Optional Content Groups (OCG). OCG-based animations are fully supported in Adobe Reader 8, but have some performance issues. Playback is usually slower in Reader 8 than in older Reader versions, which is probably a bug. The non-OCG approach performs better in Adobe Reader 8, but package/command options `\verb+autoplay+', `\verb+autopause+' and `\verb+autoresume+' do not work. Moreover, the animation position and the play/pause' buttons are not properly reset on page change. This is due to usage restrictions that Adobe imposed on some important JavaScript methods in Reader 8. A non-OCG version of the package is still available as `\verb+animate-noocg.sty+'.
+  \item Originally, package `\verb+animate+' was based on a method suggested by Jan Hole\v{c}ek and Petr Soika~\cite{hol04}, but was rewritten to use Optional Content Groups (OCG). OCG-based animations are fully supported in Adobe Reader 8, but have some performance issues. Playback is usually slower in Reader 8 than in older Reader versions, which is probably a bug. The non-OCG approach performs better in Adobe Reader 8, but package/command options `\verb+autoplay+', `\verb+autopause+' and `\verb+autoresume+' do not work. Moreover, the animation position and the play/pause' buttons are not properly reset on page change. This is due to usage restrictions that Adobe imposed on some important JavaScript methods in Reader 8. An old, non-OCG version of the package is still available as `\verb+animate-noocg.sty+'.
 \end{itemize}
 
 \section{Acknowledgements}