From: Lars Magne Ingebrigtsen <larsi@gnus.org>
Date: Sat, 2 Jul 2011 21:38:19 +0000 (+0200)
Subject: * display.texi (Showing Images): Mention the point of sliced images (bug bug#7836).
X-Git-Url: https://git.hcoop.net/bpt/emacs.git/commitdiff_plain/f68d76d0d46480317e9edf162ae0f095b92a2b52

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

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index ab17e455f7..6e7ef2bbb7 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 069b3c91d7..6d19d73545 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