diff options
| -rw-r--r-- | lispref/ChangeLog | 4 | ||||
| -rw-r--r-- | lispref/display.texi | 23 |
2 files changed, 25 insertions, 2 deletions
diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 82cfcab4699..3252e671c11 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,7 @@ +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. diff --git a/lispref/display.texi b/lispref/display.texi index b6348800fad..96aa2335a6a 100644 --- a/lispref/display.texi +++ b/lispref/display.texi @@ -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 |