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

[Miles Bader]

Index: emacs/lispref/display.texi
diff -c emacs/lispref/display.texi:1.83.2.12 
emacs/lispref/display.texi:1.83.2.13
*** emacs/lispref/display.texi:1.83.2.12        Tue Jul  6 10:00:05 2004
--- emacs/lispref/display.texi  Tue Jul  6 10:14:26 2004
***************
*** 2875,2882 ****
  @code{display} property, this feature is available starting in Emacs 21.
  
    Emacs can display a number of different image formats; some of them
! are supported only if particular support libraries are installed on your
! machine.  The supported image formats include XBM, XPM (needing the
  libraries @code{libXpm} version 3.4k and @code{libz}), GIF (needing
  @code{libungif} 4.1.0), Postscript, PBM, JPEG (needing the
  @code{libjpeg} library version v6a), TIFF (needing @code{libtiff} v3.4),
--- 2875,2887 ----
  @code{display} property, this feature is available starting in Emacs 21.
  
    Emacs can display a number of different image formats; some of them
! are supported only if particular support libraries are installed on
! your machine.  In some environments, Emacs allows loading image
! libraries on demand; if so, the variable @code{image-library-alist}
! can be used to modify the set of known names for these dynamic
! libraries (though it is not posible to add new image formats).
! 
!   The supported image formats include XBM, XPM (needing the
  libraries @code{libXpm} version 3.4k and @code{libz}), GIF (needing
  @code{libungif} 4.1.0), Postscript, PBM, JPEG (needing the
  @code{libjpeg} library version v6a), TIFF (needing @code{libtiff} v3.4),
***************
*** 2887,2896 ****
  @code{pbm}, @code{jpeg}, @code{tiff}, and @code{png}.
  
  @defvar image-types
  This variable contains a list of those image type symbols that are
! supported in the current configuration.
  @end defvar
  
  @menu
  * Image Descriptors::   How to specify an image for use in @code{:display}.
  * XBM Images::          Special features for XBM format.
--- 2892,2939 ----
  @code{pbm}, @code{jpeg}, @code{tiff}, and @code{png}.
  
  @defvar image-types
+ @vindex image-types
  This variable contains a list of those image type symbols that are
! potentially supported in the current configuration.
! @emph{Potentially} here means that Emacs knows about the image types,
! not necessarily that they can be loaded (they could depend on
! unavailable dynamic libraries, for example).
! 
! To know which image types are really available, use
! @code{image-type-available-p}.
! @end defvar
! 
! @defvar image-library-alist
! @vindex image-library-alist
! This in an alist of image types vs external libraries needed to
! display them.
! 
! Each element is a list @code{(@var{IMAGE-TYPE} @var{LIBRARY}...)},
! where the car is a supported image format from @code{image-types}, and
! the rest are strings giving alternate filenames for the corresponding
! external libraries to load.
! 
! They are tried in the order they appear on the list; if none of them
! can be loaded, the running session of Emacs won't support the image
! type.  No entries are needed for @code{pbm} and @code{xbm} images;
! they're always supported.
! 
! This variable is ignored if the image libraries are statically linked
! into Emacs.
  @end defvar
  
+ @defun  image-type-available-p type
+ @findex image-type-available-p
+ 
+ This function returns non-nil if image type TYPE is available, i.e.,
+ if images of this type can be loaded and displayed in Emacs.  TYPE
+ should be one of the types contained in @code{image-types}.
+ 
+ For image types whose support libraries are statically linked, this
+ function always returns @code{t}; for other image types, it returns
+ @code{t} if the dynamic library could be loaded, @code{nil} otherwise.
+ @end defun
+ 
  @menu
  * Image Descriptors::   How to specify an image for use in @code{:display}.
  * XBM Images::          Special features for XBM format.