[Emacs-diffs] Changes to emacs/lispref/display.texi

[Chong Yidong]

Index: emacs/lispref/display.texi
diff -c emacs/lispref/display.texi:1.184 emacs/lispref/display.texi:1.185
*** emacs/lispref/display.texi:1.184    Thu Sep  8 22:00:57 2005
--- emacs/lispref/display.texi  Thu Sep 15 14:02:34 2005
***************
*** 3946,3954 ****
  @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}.
  @end defun
  
  @node Showing Images
  @subsection Showing Images
--- 3946,3973 ----
  @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 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 @address@hidden/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 @address@hidden/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