From: Eli Zaretskii <eliz@gnu.org>
Date: Sun, 30 Mar 2025 16:27:22 +0000 (+0300)
Subject: ; Improve the documentation of 'slice' display spec (bug#77384).
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a3d8d3d7df2313b45ca88923ec1439a4dc567538;p=emacs.git

; Improve the documentation of 'slice' display spec (bug#77384).

(cherry picked from commit 38fec86281efd78af24cc435307d55a00223db49)
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 19a414fa4f1..14c0eb82077 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -5631,12 +5631,20 @@ instead of the text that has the display specification.
 
 @item (slice @var{x} @var{y} @var{width} @var{height})
 This specification together with @code{image} specifies a @dfn{slice}
-(a partial area) of the image to display.  The elements @var{y} and
-@var{x} specify the top left corner of the slice, within the image;
-@var{width} and @var{height} specify the width and height of the
-slice.  Integers are numbers of pixels.  A floating-point number
-in the range 0.0--1.0 stands for that fraction of the width or height
-of the entire image.
+(a partial area) of the image to display.  More precisely, the
+specification should have the following form:
+
+@lisp
+ ((slice @var{x} @var{y} @var{width} @var{height}) @var{image-desc})
+@end lisp
+
+@noindent
+where @var{image-desc} is an image descriptor described above.  The
+elements @var{x} and @var{y} specify the top left corner of the slice,
+within the image; @var{width} and @var{height} specify the width and
+height of the slice.  Integers are numbers of pixels.  A floating-point
+number in the range 0.0--1.0 stands for that fraction of the width or
+height of the entire image.
 
 @item ((margin nil) @var{string})
 A display specification of this form means to display @var{string}