(rmail-enable-mime): Docstring fixed.

(rmail-mime-feature): Likewise.
(rmail-require-mime-maybe): Use display-warning to show a warning
message.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 9e67c7dacdf1791a8e24cb506fb4bfff93d69b8f..ff40c2a961e1a57c05dab47d3d924a58b6945908 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -6,6 +6,11 @@
        
 2006-01-19  Kenichi Handa  <handa@m17n.org>
 
+       * mail/rmail.el (rmail-enable-mime): Docstring fixed.
+       (rmail-mime-feature): Likewise.
+       (rmail-require-mime-maybe): Use display-warning to show a warning
+       message.
+
        * international/mule.el (auto-coding-regexp-alist-lookup): New
        function.
        (find-auto-coding): Use auto-coding-regexp-alist-lookup.

diff --git a/lisp/mail/rmail.el b/lisp/mail/rmail.el
index 1ab32aba45d583712230465e7c09e7fce41d0b1a..4fe936d9d2d0773c82b5901b009c1e7f72e51337 100644 (file)
--- a/lisp/mail/rmail.el
+++ b/lisp/mail/rmail.el
@@ -543,7 +543,11 @@ This is set to nil by default.")
   "*If non-nil, RMAIL uses MIME feature.
 If the value is t, RMAIL automatically shows MIME decoded message.
 If the value is neither t nor nil, RMAIL does not show MIME decoded message
-until a user explicitly requires it."
+until a user explicitly requires it.
+
+Even if the value is non-nil, you can't use MIME feature
+if the feature specified by `rmail-mime-feature' is not available
+in your session."
   :type '(choice (const :tag "on" t)
                 (const :tag "off" nil)
                 (other :tag "when asked" ask))
@@ -595,7 +599,10 @@ LIMIT is the position specifying the end of header.")
 (defvar rmail-mime-feature 'rmail-mime
   "Feature to require to load MIME support in Rmail.
 When starting Rmail, if `rmail-enable-mime' is non-nil,
-this feature is required with `require'.")
+this feature is required with `require'.
+
+The default value is `rmail-mime'.  This feature is provided by
+the rmail-mime package available at <http://www.m17n.org/rmail-mime/>.")
 
 ;;;###autoload
 (defvar rmail-decode-mime-charset t
@@ -735,8 +742,14 @@ isn't provided."
     (condition-case err
        (require rmail-mime-feature)
       (error
-       (message "Feature `%s' not provided" rmail-mime-feature)
-       (sit-for 1)
+       (display-warning
+       :warning
+       (format "Although MIME support is requested
+by setting `rmail-enable-mime' to non-nil, the required feature
+`%s' (the value of `rmail-mime-feature')
+is not available in the current session.
+So, the MIME support is turned off for the moment." 
+               rmail-mime-feature))
        (setq rmail-enable-mime nil)))))