Some doc for image-format-suffixes

* doc/lispref/display.texi (ImageMagick Images):
Expand on image-format-suffixes.

* lisp/image.el (image-format-suffixes): Doc fix.

* etc/NEWS: Related markup.

2 files changed, 8 insertions, 4 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 106e12e88b7..974cd2223ef 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2014-01-22  Glenn Morris  <rgm@gnu.org>
 
+        * image.el (image-format-suffixes): Doc fix.
+
         * international/quail.el (quail-define-package): Doc fix.
 
         * emacs-lisp/authors.el (authors-valid-file-names):
diff --git a/lisp/image.el b/lisp/image.el
index dec6991666a..d16fe4fb0ba 100644
--- a/lisp/image.el
+++ b/lisp/image.el
@@ -104,11 +104,13 @@ AUTODETECT can be
 
 (defvar image-format-suffixes
   '((image/x-icon "ico"))
-  "Alist of MIME Content-Type headers to file name suffixes.
+  "An alist associating image types with file name suffixes.
 This is used as a hint by the ImageMagick library when detecting
-image types.  If `create-image' is called with a :format
-matching found in this alist, the ImageMagick library will be
-told that the data would have this suffix if saved to a file.")
+the type of image data (that does not have an associated file name).
+Each element has the form (MIME-CONTENT-TYPE EXTENSION).
+If `create-image' is called with a :format attribute whose value
+equals a content-type found in this list, the ImageMagick library is
+told that the data would have the associated suffix if saved to a file.")
 
 (defcustom image-load-path
   (list (file-name-as-directory (expand-file-name "images" data-directory))