[Emacs-diffs] Changes to emacs/lispref/display.texi,v

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      07/06/14 02:22:13

Index: display.texi
===================================================================
RCS file: /sources/emacs/emacs/lispref/display.texi,v
retrieving revision 1.263
retrieving revision 1.264
diff -u -b -r1.263 -r1.264
--- display.texi        9 Jun 2007 03:18:59 -0000       1.263
+++ display.texi        14 Jun 2007 02:22:13 -0000      1.264
@@ -4276,13 +4276,43 @@
 @subsection Image Cache
 @cindex image cache
 
-  Emacs stores images in an image cache when it displays them, so it can
-display them again more efficiently.  It removes an image from the cache
-when it hasn't been displayed for a specified period of time.
-
-When an image is looked up in the cache, its specification is compared
-with cached image specifications using @code{equal}.  This means that
-all images with equal specifications share the same image in the cache.
+  Emacs stores images in an image cache so that it can display them
+again more efficiently.  When Emacs displays an image, it searches the
+image cache for an existing image specification @code{equal} to the
+desired specification.  If a match is found, the image is displayed
+from the cache; otherwise, Emacs loads the image normally.
+
+  Occasionally, you may need to tell Emacs to refresh the images
+associated with a given image specification.  For example, suppose you
+display an image using a specification that contains a @code{:file}
+property.  The image is loaded from the given file and stored in the
+image cache.  If you later display the image again, using the same
+image specification, the image is displayed from the image cache.
+Normally, this is not a problem.  However, if the image file has
+changed in the meantime, Emacs would be displaying the old version of
+the image.  In such a situation, it is necessary to ``refresh'' the
+image using @code{image-refresh}.
+
address@hidden image-refresh spec &optional frame
+This function refreshes any images having image specifications
address@hidden to @var{spec} on frame @var{frame}.  If @var{frame} is
address@hidden, the selected frame is used.  If @var{frame} is @code{t},
+the refresh is applied to all existing frames.
+
+This works by removing all image with image specifications matching
address@hidden from the image cache.  Thus, the next time the image is
+displayed, Emacs will load the image again.
address@hidden defun
+
address@hidden clear-image-cache &optional frame
+This function clears the entire image cache.  If @var{frame} is
address@hidden, only the cache for that frame is cleared.  Otherwise,
+all frames' caches are cleared.
address@hidden defun
+
+If an image in the image cache has not been displayed for a specified
+period of time, Emacs removes it from the cache and frees the
+associated memory.
 
 @defvar image-cache-eviction-delay
 This variable specifies the number of seconds an image can remain in the
@@ -4294,12 +4324,6 @@
 debugging.
 @end defvar
 
address@hidden clear-image-cache &optional frame
-This function clears the image cache.  If @var{frame} is address@hidden,
-only the cache for that frame is cleared.  Otherwise all frames' caches
-are cleared.
address@hidden defun
-
 @node Buttons
 @section Buttons
 @cindex buttons in buffers