From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 6 Jul 2019 12:32:20 +0000 (+0300)
Subject: Improve description of image descriptors
X-Git-Tag: emacs-26.3~52
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=faf99dc;p=emacs.git

Improve description of image descriptors

* doc/lispref/display.texi (Image Descriptors): More accurate
description of where image files are looked up.  (Bug#36523)
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index b6fda1cd807..276d60b21a7 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -5055,7 +5055,10 @@ Every image descriptor must include this property.
 
 @item :file @var{file}
 This says to load the image from file @var{file}.  If @var{file} is
-not an absolute file name, it is expanded in @code{data-directory}.
+not an absolute file name, it is expanded relative to the
+@file{images} subdirectory of @code{data-directory}, and failing that,
+relative to the directories listed by @code{x-bitmap-file-path}
+(@pxref{Face Attributes}).
 
 @item :data @var{data}
 This specifies the raw image data.  Each image descriptor must have