* display.texi (Showing Images): Mention the point of sliced images (bug bug#7836).

2 files changed, 12 insertions, 0 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index ab17e455f75..6e7ef2bbb7d 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-07-02  Lars Magne Ingebrigtsen  <larsi@gnus.org>
+
+        * display.texi (Showing Images): Mention the point of sliced
+        images (bug bug#7836).
+
 2011-07-02  Eli Zaretskii  <eliz@gnu.org>
 
         * variables.texi (Defining Variables, Void Variables)
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 069b3c91d7b..6d19d73545e 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -4700,10 +4700,17 @@ it a @code{display} property which specifies @var{image}.  @xref{Display
 Property}.
 @end defun
 
+@cindex slice, image
+@cindex image slice
 @defun insert-sliced-image image &optional string area rows cols
 This function inserts @var{image} in the current buffer at point, like
 @code{insert-image}, but splits the image into @var{rows}x@var{cols}
 equally sized slices.
+
+If an image is inserted ``sliced'', then the Emacs display engine will
+treat each slice as a separate image, and allow more intuitive
+scrolling up/down, instead of jumping up/down the entire image when
+paging through a buffer that displays (large) images.
 @end defun
 
 @defun put-image image pos &optional string area