mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 06:20:55 -08:00
Code Issues Projects Releases Wiki Activity

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

Browse source
This commit is contained in:
Eli Zaretskii 2025-03-30 19:27:22 +03:00
parent 3f05b455f7
commit 38fec86281
1 changed files with 14 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

20
doc/lispref/display.texi
View file

@ -5603,12 +5603,20 @@ instead of the text that has the display specification.
@item (slice @var{x} @var{y} @var{width} @var{height}) @item (slice @var{x} @var{y} @var{width} @var{height})
This specification together with @code{image} specifies a @dfn{slice} This specification together with @code{image} specifies a @dfn{slice}
(a partial area) of the image to display. The elements @var{y} and (a partial area) of the image to display. More precisely, the
@var{x} specify the top left corner of the slice, within the image; specification should have the following form:
@var{width} and @var{height} specify the width and height of the
slice. Integers are numbers of pixels. A floating-point number @lisp
in the range 0.0--1.0 stands for that fraction of the width or height ((slice @var{x} @var{y} @var{width} @var{height}) @var{image-desc})
of the entire image. @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}) @item ((margin nil) @var{string})
A display specification of this form means to display @var{string} A display specification of this form means to display @var{string}