Commit 5b51c037 authored by Chong Yidong's avatar Chong Yidong
Browse files

Document `image-load-path'.

parent 979f56ac
2005-09-15 Chong Yidong <cyd@stupidchicken.com>
* display.texi (Defining Images): Document `image-load-path'.
2005-09-15 Richard M. Stallman <rms@gnu.org>
* objects.texi (Printed Representation): Minor cleanup.
......
......@@ -3946,10 +3946,29 @@ The first specification in the list whose @var{type} is supported, and
@var{file} exists, is used to construct the image specification to be
returned. If no specification is satisfied, @code{nil} is returned.
The image is looked for first on @code{load-path} and then in
@code{data-directory}.
The image is looked for in @code{image-load-path}.
@end defun
@defvar image-load-path
@tindex image-load-path
This variable's value is a list of locations in which to search for
image files. If an element is a string, it is taken to be the name of
a directory to search. If an element is a variable symbol, the value
of that variable is used as a list of directories to search.
The default is to search in @file{@code{data-directory}/images}, then
in @code{data-directory}, and finally in the directories specified by
@code{load-path}. Subdirectories are not automatically included in
the search, so if you put an image file in a subdirectory, you have to
supply the subdirectory name explicitly. For example, if you put an
image file @file{bar.xpm} in @file{@code{data-directory}/images/foo/},
you should define the image as:
@example
(defimage foo-image '((:type xpm :file "foo/bar.xpm")))
@end example
@end defvar
@node Showing Images
@subsection Showing Images
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment