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

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index d834ade..a9210fb 100644 (file)
--- 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 081614a..b2eb68d 100644 (file)
--- 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