animate update (26mar08)

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

3 files changed, 19 insertions, 13 deletions

diff --git a/Master/texmf-dist/doc/latex/animate/README b/Master/texmf-dist/doc/latex/animate/README
index 96465dcfd14..ba97e38b990 100644
--- a/Master/texmf-dist/doc/latex/animate/README
+++ b/Master/texmf-dist/doc/latex/animate/README
@@ -41,10 +41,14 @@ Description:
     command options. Please refer to the documentation `animate.pdf' in the
     `doc/' directory for details and examples.
 
-    Keywords: include portable PDF animation animating embed animated
-    graphics LaTeX pdfLaTeX PSTricks pgf TikZ MetaPost LaTeX-picture
-    inline graphics vector graphics animated GIF LaTeX dvips ps2pdf
-    JavaScript Adobe Reader
+    Keywords: include portable PDF animated PDF animation animating
+    embed animated
+ graphics LaTeX pdfLaTeX PSTricks pgf TikZ MetaPost
+    LaTeX-picture
+ inline graphics vector graphics animated GIF LaTeX
+    dvips ps2pdf
+ JavaScript Adobe Reader
+
 
 
 Usage:
@@ -79,6 +83,7 @@ Usage:
 
 Requirements:
 
+  e-TeX
   pdfTeX, version >= 1.20
   Ghostscript, version >= 8.31 or Adobe Distiller
   Adobe Reader, version >= 6, but not 8
diff --git a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf b/Master/texmf-dist/doc/latex/animate/doc/animate.pdf
index ac3d7dda27a..e265ea3e808 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 4d54878d528..76305195f24 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/animate.tex
+++ b/Master/texmf-dist/doc/latex/animate/doc/animate.tex
@@ -31,7 +31,7 @@
   \makeatother
 \fi
 
-\def\keywords{include portable PDF animation animating embed animated graphics LaTeX pdfLaTeX PSTricks pgf TikZ LaTeX-picture MetaPost inline graphics vector graphics animated GIF LaTeX dvips ps2pdf JavaScript Adobe Reader}
+\def\keywords{include portable PDF animation animated PDF animating embed animated graphics LaTeX pdfLaTeX PSTricks pgf TikZ LaTeX-picture MetaPost inline graphics vector graphics animated GIF LaTeX dvips ps2pdf JavaScript Adobe Reader}
 \hypersetup{
   bookmarksnumbered,linktocpage,breaklinks,
   pdftitle={The animate Package},
@@ -75,6 +75,7 @@ The `animate' package relies on Optional Content Groups (OCG), also known as PDF
 
 \section{Requirements}
 \begin{trivlist}
+\item $\varepsilon$-\TeX
 \item pdf\TeX{}, version $\ge1.20$ for direct PDF output
 \item Ghostscript, version $\ge8.31$ or Adobe Distiller for PS to PDF conversion
 \item Adobe Reader, version $\ge6$, but not $8$
@@ -108,7 +109,7 @@ poster[=first | none | last]
 \end{verbatim}
 The same options (among others) are also available 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.
 
-If PDF is generated via DVI and Postscript by the command sequence \verb+latex+ $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+, the `graphicx' package is required. \emph{Important:} The \verb+dvips+ option `\verb+-Ppdf+' should \emph{not} be set when converting the intermediate DVI into Postscript. If you cannot do without, put `\verb+-X 2400 -Y 2400+' \emph{after} `\verb+-Ppdf+' on the command line.
+If PDF is generated via DVI and Postscript by the command sequence \verb+latex+ $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+, the `graphicx' package is required. \emph{Important:} The \verb+dvips+ option `\verb+-Ppdf+' should \emph{not} be set when converting the intermediate DVI into Postscript. If you cannot do without, put `\verb+-X 2400 -Y 2400+' \emph{after} `\verb+-Ppdf+' on the command line. Sometimes, if the same animation sequence made from graphics files is to be embedded multiple times into the document, more compact PDF output may be obtained by passing option `\verb+-dMaxInlineImageSize=0+' to \verb+ps2pdf+.
 
 \section{The user interface}
 Package `animate' provides the command
@@ -280,7 +281,7 @@ and
 \normalsize
 In the first example, transparency No. 0 appears in the foreground throughout the animation; it will never be obscured by other transparencies' content. In the second example it is put to the background, because it is the first transparency specification in the file, and stays there for the rest of the animation.
 
-When designing the timeline, care should be taken not to include a transparency more than once into the \emph{same} animation frame. Besides the useless redundancy, this may slow down the animation speed in the Reader, because the graphical objects of a multiply included transparency have to be rendered unnecessarily often at the same time. `animate' is smart enough to detect multiple inclusion and issues a warning message along with the transparency ID and the frame number if it occurs. Also, `animate' finds and lists transparencies that have never been used in an animation timeline in order to avoid dead code in the final PDF. Here is an example of a poorly designed timeline:
+When designing the timeline, care should be taken not to include a transparency more than once into the \emph{same} animation frame. Besides the useless redundancy, this may slow down the animation speed in the Reader, because the graphical objects of a multiply included transparency have to be rendered unnecessarily often at the same time. `animate' is smart enough to detect multiple inclusion and issues a warning message along with the transparency ID and the frame number if it occurs. Also, `animate' finds and lists transparencies that have never been used in an animation timeline. This may help to avoid dead code in the final PDF. Here is an example of a poorly designed timeline:
 \small
 \begin{verbatim}
   ::0
@@ -298,13 +299,13 @@ When designing the timeline, care should be taken not to include a transparency
 The stack-like concept of animations, where transparencies are always put on top such that they overprint the content of previously deposited transparencies, can be inconvenient in certain situations. For example, it might be desirable to allow for changing the background image in the middle of an animation without affecting objects that are located in the foreground. For this purpose, transparency specifications can be grouped into \emph{layers} using the semicolon (\verb+;+) as a separator instead of the comma. This is best illustrated by an example:
 \small
 \begin{verbatim}
-  ::0x49;2x0,3x0
-  ::    ;4x0,5x0
+  ::0x49;2x0,3x0    % first background image, transparency `0', used in
+  ::    ;4x0,5x0    % the first 49 frames
   ::    ;6x0,7x0
   ...
   ::   ;98x0,99x0
-  ::1x0;100x0,101x0
-  ::   ;102x0,103x0
+  ::1x0;100x0,101x0 % new background image, transparency `1', until end
+  ::   ;102x0,103x0 % of animation
   ::   ;104x0,105x0
   ...
 \end{verbatim}
@@ -569,8 +570,8 @@ Fig.~\ref{fig:torus} is an inline graphics example adapted from \cite{gilg05}.
 
   \item Animations do not work if the PDF has been produced with Ghostscript versions older than 8.31. This applies to all versions of ESP Ghostscript that comes with many Linux distributions.
 
-  \item Animations with complex graphics, many frames or complicated timelines may cause \LaTeX{} to fail with a `\verb+TeX capacity exceeded+' error. The following steps should fix most of the memory related problems.
-
+  \item Animations with complex graphics and/or many frames may cause \LaTeX{} to fail with a `\verb+TeX capacity exceeded+' error. The following steps should fix most of the memory related problems.
+  
   MiK\TeX:
   \begin{enumerate}
     \item Open a command line window.