[Emacs-diffs] master c61bfe0: Mention image caching in the `image-size' doc string

[Lars Ingebrigtsen]

branch: master
commit c61bfe0a3adab1a9fd0dc283cbf8291a78ed6da1
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>

    Mention image caching in the `image-size' doc string
    
    * src/image.c (Fimage_size): Mention that this function caches
    images, and what to do about that (bug#33275).
---
 src/image.c | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/image.c b/src/image.c
index fe7bd90..5183558 100644
--- a/src/image.c
+++ b/src/image.c
@@ -1050,8 +1050,13 @@ DEFUN ("image-size", Fimage_size, Simage_size, 1, 3, 0,
        doc: /* Return the size of image SPEC as pair (WIDTH . HEIGHT).
 PIXELS non-nil means return the size in pixels, otherwise return the
 size in canonical character units.
+
 FRAME is the frame on which the image will be displayed.  FRAME nil
-or omitted means use the selected frame.  */)
+or omitted means use the selected frame.
+
+Calling this function will result in the image being stored in the
+image cache.  If this is not desirable, call `image-flush' after
+calling this function.  */)
   (Lisp_Object spec, Lisp_Object pixels, Lisp_Object frame)
 {
   Lisp_Object size;