animate (25nov14)

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

4 files changed, 13 insertions, 7 deletions

diff --git a/Master/texmf-dist/doc/latex/animate/ChangeLog b/Master/texmf-dist/doc/latex/animate/ChangeLog
index 57b76557b00..da057819230 100644
--- a/Master/texmf-dist/doc/latex/animate/ChangeLog
+++ b/Master/texmf-dist/doc/latex/animate/ChangeLog
@@ -1,3 +1,7 @@
+2014-11-25
+	* New: In addition to `first', `last' and `none', the `poster' option also
+	takes an integer number to specify the default poster frame.
+
 2014-11-11
 	* Fix: (work-around for) JavaScript NotAllowedError in AR-9 when skimming
 	over pages with icon-based animations
diff --git a/Master/texmf-dist/doc/latex/animate/README b/Master/texmf-dist/doc/latex/animate/README
index 8dd40522376..4ac4cc09b13 100644
--- a/Master/texmf-dist/doc/latex/animate/README
+++ b/Master/texmf-dist/doc/latex/animate/README
@@ -38,7 +38,8 @@ Usage:
                        keepaspectratio, scale=<factor>, nomouse,
                        autopause, autoplay, autoresume, controls, final, draft,
                        buttonsize=<size>, buttonbg=<colour>, buttonfg=<colour>,
-                       loop, palindrome, step, poster[=first | none | last],
+                       loop, palindrome, step,
+                       poster[=first | <num> | last | none],
                        method=icon | widget | ocg, dvipdfmx, xetex
 
 
@@ -61,8 +62,9 @@ Usage:
                        autopause, autoplay, autoresume, final,
                        draft, controls, buttonsize=<size>, buttonbg=<colour>,
                        buttonfg=<colour>, loop, palindrome, step, measure,
-                       poster[=first | none | last], begin={<begin text>},
-                       end={<end text>}, timeline=<timeline file>,
+                       poster[=first | <num> | last | none],
+                       begin={<begin text>}, end={<end text>},
+                       timeline=<timeline file>,
                        method=icon | widget | ocg,
                        every=<number>, bb=<llx> <lly> <urx> <ury>,
                        viewport=<llx> <lly> <urx> <ury>,
diff --git a/Master/texmf-dist/doc/latex/animate/animate.pdf b/Master/texmf-dist/doc/latex/animate/animate.pdf
index 5d808b4f97a..12f10863d3c 100644
--- a/Master/texmf-dist/doc/latex/animate/animate.pdf
+++ b/Master/texmf-dist/doc/latex/animate/animate.pdf
diff --git a/Master/texmf-dist/doc/latex/animate/animate.tex b/Master/texmf-dist/doc/latex/animate/animate.tex
index 89937dea5a8..998d666028c 100644
--- a/Master/texmf-dist/doc/latex/animate/animate.tex
+++ b/Master/texmf-dist/doc/latex/animate/animate.tex
@@ -157,7 +157,7 @@ buttonfg=<colour>
 step
 nomouse
 method=icon | widget | ocg
-poster[=first | none | last]
+poster[=first | <num> | last | none]
 \end{verbatim}
 Except for `\verb+dvipdfmx+' and `\verb+xetex+', the options above are also available (among others) as command options and will be explained shortly. However, if used as package options they have global scope, taking effect on all animations in the document. In turn, command options locally override global settings. Options without an argument are boolean options and can be negated, with the exception of package-only options `\verb+dvipdfmx+' and `\verb+xetex+', by appending `\verb+=false+'.
 
@@ -231,9 +231,9 @@ label=<label text>
 \end{verbatim}
 The animation is given a label, \verb+<label text>+, which should be unique. Labelling an animation enables its JavaScript programming interface by defining \verb+anim['<label text>']+, which is a JavaScript reference to the animation object. The animation object provides a number of properties and methods that can be used for controlling the animation playback from within user defined JavaScript. For details, see Sect.~\ref{sect:api}.
 \begin{verbatim}
-poster[=first | none | last]
+poster[=first | <num> | last | none]
 \end{verbatim}
-Specifies which frame (first, last or none) to display and print if the animation is not activated. The first frame is shown by default. Thus `\verb+poster+' or `\verb+poster=first+' need not be explicitly set.
+Specifies which frame to display and print if the animation is not activated. The first frame is shown by default. Thus `\verb+poster+' or `\verb+poster=first+' need not be explicitly set. A frame number \verb+<num>+ may as well be given; \verb+<num>+ is zero-based, that is, the first frame has number `0'.
 \begin{verbatim}
 every=<num>
 \end{verbatim}
@@ -301,7 +301,7 @@ By default, control button widgets are drawn with black strokes on transparent b
 draft
 final
 \end{verbatim}
-With `\verb+draft+' the animation is not embedded. Instead, a box with the exact dimensions of the animation is inserted. Option `\verb+final+' does the opposite as it forces the animation to be built and embedded. Both options can be used to reduce compilation time during authoring of a document. To get the most out of them it is recommended to set `\verb+draft+' globally as a package or class option and to set `\verb+final+' locally as a command option of the animation that is currently worked on. After the document has been finished, the global `\verb+draft+' option can be removed to embed all animations.
+With `\verb+draft+' the animation is not embedded. Instead, a box with the exact dimensions of the animation is inserted. Option `\verb+final+' does the opposite as it forces the animation to be built and embedded. Both options can be used to reduce compilation time during authoring of a document. To get the most out of them it is recommended to set `\verb+draft+' globally as a package or class option and to set `\verb+final+' locally as a command option of the animation that is currently being worked on. After the document has been finished, the global `\verb+draft+' option can be removed to embed all animations.
 \begin{verbatim}
 nomouse
 \end{verbatim}