[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/display.texi,v
From: |
Chong Yidong |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/display.texi,v |
Date: |
Thu, 14 Jun 2007 02:22:13 +0000 |
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