procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; 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
Show stats 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})
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}