[Emacs-diffs] /srv/bzr/emacs/trunk r107156: * doc/lispref/display.texi (ImageMagick Images): General update.

[Glenn Morris]

------------------------------------------------------------
revno: 107156
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Mon 2012-02-06 20:20:16 -0800
message:
  * doc/lispref/display.texi (ImageMagick Images): General update.
modified:
  doc/lispref/ChangeLog
  doc/lispref/display.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-02-07 03:31:29 +0000
+++ b/doc/lispref/ChangeLog     2012-02-07 04:20:16 +0000
@@ -1,6 +1,6 @@
 2012-02-07  Glenn Morris  <address@hidden>
 
-       * display.texi (ImageMagick Images):
+       * display.texi (ImageMagick Images): General update.
        Move most details of imagemagick-render-type to the variable's doc.
 
 2012-02-06  Glenn Morris  <address@hidden>

=== modified file 'doc/lispref/display.texi'
--- a/doc/lispref/display.texi  2012-02-07 03:31:29 +0000
+++ b/doc/lispref/display.texi  2012-02-07 04:20:16 +0000
@@ -4527,21 +4527,45 @@
 support, you can use the ImageMagick library to load many image formats.
 
 @findex imagemagick-types
address@hidden imagemagick-register-types
 The function @code{imagemagick-types} returns a list of image file
 extensions that your installation of ImageMagick supports.  To enable
 support, you must call the function @code{imagemagick-register-types}.
+This enables Emacs to visit these file types in @code{image-mode}
+(@pxref{File Conveniences,,, emacs, The GNU Emacs Manual}).
+If your Emacs was not compiled with ImageMagick support, then
address@hidden will be undefined and
address@hidden will do nothing.
 
 @vindex imagemagick-types-inhibit
 The variable @code{imagemagick-types-inhibit} specifies a list of
-image types that you do @emph{not} want ImageMagick to handle.  There
-may be overlap between image loaders in your Emacs installation, and
-you may prefer to use a different one for a given image type (which
address@hidden FIXME how is this priority determined?
-loader will be used in practice depends on the priority of the loaders).
address@hidden FIXME why are these uppercase when image-types is lower-case?
address@hidden FIXME what are the possible options?  Are these actually file 
extensions?
-For example, if you never want to use the ImageMagick loader to use
-JPEG files, add @code{JPG} to this list.
+image types that you do @emph{not} want ImageMagick to handle.  It is
+a list of symbols, each of which has the same name as one of the
+format tags used internally by ImageMagick (i.e., as
address@hidden returns).  ImageMagick has a very broad
+definition of what an image is, for example it includes such file
+types as C files and HTML files.  It is not appropriate to treat these
+as images in Emacs.  You can add any other ImageMagick type that you
+wish to this list.
address@hidden
address@hidden I don't know what this means.  I suspect it means eg loading jpg
address@hidden images via libjpeg or ImageMagick.  But it doesn't work.
address@hidden If you don't have libjpeg support compiled in, you cannot
address@hidden view jpeg images, even if you have imagemagick support:
address@hidden http://debbugs.gnu.org/9045
address@hidden And if you have both compiled in, then you always get
address@hidden the libjpeg version:
address@hidden http://debbugs.gnu.org/10746
+There may be overlap between image loaders in your Emacs installation,
+and you may prefer to use a different one for a given image type
+(which loader will be used in practice depends on the priority of the
+loaders).  
address@hidden ignore
+For example, if you never want to use the ImageMagick loader to view
+JPEG files, add @code{JPG} to this list.  Note that ImageMagick often
+distinguishes between several different types of a particular format
+(e.g., @code{JPG}, @code{JPEG}, @code{PJPEG}, etc.), and you may need
+to add all versions to this list.
 
 @c Not sure this should even be in the manual at all.
 @vindex imagemagick-render-type
@@ -4561,10 +4585,11 @@
 Specifies a rotation angle in degrees.
 
 @item :index
-Specifies which image to view inside an image bundle file format, such
-as TIFF or DJVM.  You can use the @code{image-metadata} function to
-retrieve the total number of images in an image bundle (this is
-similar to how GIF files work).
address@hidden Doesn't work: http://debbugs.gnu.org/7978
+This has the same meaning as it does for GIF images (@pxref{GIF Images}),
+i.e. it specifies which image to view inside an image bundle file format
+such as DJVM.  You can use the @code{image-metadata} function to
+retrieve the total number of images in an image bundle.
 @end table