* doc/emacs/files.texi (File Conveniences): Mention image animation.

2 files changed, 13 insertions, 1 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index d834aded164..a9210fbefe6 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2012-02-04  Glenn Morris  <rgm@gnu.org>
+
+        * files.texi (File Conveniences): Mention image animation.
+
 2012-01-31  Chong Yidong  <cyd@gnu.org>
 
         * windows.texi (Split Window): C-mouse-2 doesn't work on GTK+
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi
index 081614aa3b9..b2eb68d2812 100644
--- a/doc/emacs/files.texi
+++ b/doc/emacs/files.texi
@@ -1907,7 +1907,10 @@ point.  Partial Completion mode offers other features extending
 
 @findex image-mode
 @findex image-toggle-display
+@findex image-toggle-animation
 @cindex images, viewing
+@cindex image animation
+@cindex animated images
   Visiting image files automatically selects Image mode.  This major
 mode allows you to toggle between displaying the file as an image in
 the Emacs buffer, and displaying its underlying text representation,
@@ -1915,7 +1918,12 @@ using the command @kbd{C-c C-c} (@code{image-toggle-display}).  This
 works only when Emacs can display the specific image type.  If the
 displayed image is wider or taller than the frame, the usual point
 motion keys (@kbd{C-f}, @kbd{C-p}, and so forth) cause different parts
-of the image to be displayed.
+of the image to be displayed.  If the image can be animated, then
+the command @kbd{RET} (@code{image-toggle-animation}), will start (or
+stop) animating it.  Animation plays once, unless the option
+@code{image-animate-loop} is non-@code{nil}.  Currently, Emacs only
+supports animated GIF files (@pxref{Animated Images,,, elisp, The Emacs
+Lisp Reference Manual}).
 
 @findex thumbs-mode
 @findex mode, thumbs