Document Image Mode's new animation features.

* etc/NEWS: Better document the speed up, slow down, or reverse
animation in Image Mode.
* files.texi (File Conveniences): Document `image-next-frame',
`image-previous-frame', `image-goto-frame',
`image-increase-speed', `image-decrease-speed',
`image-reverse-speed', and `image-reset-speed'.

4 files changed, 39 insertions, 5 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 8db5ab808ce..3b81e731640 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,10 @@
+2014-01-09  Rüdiger Sonderfeld  <ruediger@c-plusplus.de>
+
+        * files.texi (File Conveniences): Document `image-next-frame',
+        `image-previous-frame', `image-goto-frame',
+        `image-increase-speed', `image-decrease-speed',
+        `image-reverse-speed', and `image-reset-speed'.
+
 2014-01-07  Bastien Guerry  <bzg@gnu.org>
 
         * buffers.texi (Buffers): Fix display of @math content by using
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 78a820b4efc..449ad9f2aa1 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -1944,12 +1944,9 @@ point.  Partial Completion mode offers other features extending
 
 @findex image-mode
 @findex image-toggle-display
-@findex image-toggle-animation
 @findex image-next-file
 @findex image-previous-file
 @cindex images, viewing
-@cindex image animation
-@cindex animated images
   Visiting image files automatically selects Image mode.  In this
 major mode, you can type @kbd{C-c C-c} (@code{image-toggle-display})
 to toggle between displaying the file as an image in the Emacs buffer,
@@ -1962,10 +1959,29 @@ displayed.  You can press @kbd{n} (@code{image-next-file}) and @kbd{p}
 (@code{image-previous-file}) to visit the next image file and the
 previous image file in the same directory, respectively.
 
-If the image can be animated, the command @kbd{RET}
+@findex image-toggle-animation
+@findex image-next-frame
+@findex image-previous-frame
+@findex image-goto-frame
+@findex image-increase-speed
+@findex image-decrease-speed
+@findex image-reset-speed
+@findex image-reverse-speed
+@vindex image-animate-loop
+@cindex image animation
+@cindex animated images
+  If the image can be animated, the command @kbd{RET}
 (@code{image-toggle-animation}) starts or stops the animation.
 Animation plays once, unless the option @code{image-animate-loop} is
-non-@code{nil}.
+non-@code{nil}.  With @kbd{f} (@code{image-next-frame}) and @kbd{b}
+(@code{image-previous-frame}) you can step through the individual
+frames.  Both commands accept a numeric prefix to step through several
+frames at once.  You can go to a specific frame with @kbd{F}
+(@code{image-goto-frame}).  The speed of the animation can be
+increased by pressing @kbd{a +} (@code{image-increase-speed}) and
+decreased by pressing @kbd{a -} (@code{image-decrease-speed}).  With
+@kbd{a r} (@code{image-reverse-speed}) the speed is reversed.  You can
+reset the speed with @kbd{a 0} (@code{image-reset-speed}).
 
 @cindex ImageMagick support
 @vindex imagemagick-enabled-types
diff --git a/etc/ChangeLog b/etc/ChangeLog
index d952550832e..54603a72aaa 100644
--- a/etc/ChangeLog
+++ b/etc/ChangeLog
@@ -1,3 +1,8 @@
+2014-01-09  Rüdiger Sonderfeld  <ruediger@c-plusplus.de>
+
+        * NEWS: Better document the speed up, slow down, or reverse
+        animation in Image Mode.
+
 2014-01-05  Tassilo Horn  <tsdh@gnu.org>
 
         * themes/tsdh-light-theme.el (tsdh-light): Define org-level-*
diff --git a/etc/NEWS b/etc/NEWS
index 9044481742c..4d5af74c75a 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -574,11 +574,17 @@ will revert to the old behavior.
 visit the next image file and the previous image file in the same
 directory, respectively.
 
++++
 *** New commands to show specific frames of multi-frame images.
 `f' (`image-next-frame') and `b' (`image-previous-frame') visit the
 next or previous frame.  `F' (`image-goto-frame') shows a specific frame.
 
++++
 *** New commands to speed up, slow down, or reverse animation.
+`a +' (`image-increase-speed') and `a -' (`image-decrease-speed') to
+speed up and slow down the animation.  `a r' (`image-reverse-speed')
+to reverse it and `a 0' (`image-reset-speed') to reset it.
+
 ---
 *** The command `image-mode-fit-frame' deletes other windows.
 When toggling, it restores the frame's previous window configuration.