Date UT
[elisp/mu-cite.git] / mu-cite.el
index c2fa92b..0d92d77 100644 (file)
@@ -1,6 +1,6 @@
 ;;; mu-cite.el --- yet another citation tool for GNU Emacs
-
-;; Copyright (C) 1995,1996,1997,1998,1999 Free Software Foundation, Inc.
+;; Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2005, 2007
+;;        Free Software Foundation, Inc.
 
 ;; Author: MORIOKA Tomohiko <tomo@m17n.org>
 ;;         Shuhei KOBAYASHI <shuhei@aqua.ocn.ne.jp>
 
 ;; You should have received a copy of the GNU General Public License
 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
-;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-;; Boston, MA 02111-1307, USA.
+;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+;; Boston, MA 02110-1301, USA.
 
 ;;; Commentary:
 
 ;; - How to use
-;;   1. bytecompile this file and copy it to the apropriate directory.
-;;   2. put the following lines to your ~/.emacs:
-;;      for EMACS 19 or later and XEmacs
+;;   1. Bytecompile this file and copy it to the apropriate directory.
+;;   2. Put the following lines in your ~/.emacs file:
+;;      For EMACS 19 or later and XEmacs
 ;;             (autoload 'mu-cite-original "mu-cite" nil t)
 ;;             ;; for all but message-mode
 ;;             (add-hook 'mail-citation-hook (function mu-cite-original))
 ;;             ;; for message-mode only
 ;;             (setq message-cite-function (function mu-cite-original))
-;;      for EMACS 18
+;;      For EMACS 18
 ;;             ;; for all but mh-e
 ;;             (add-hook 'mail-yank-hooks (function mu-cite-original))
 ;;             ;; for mh-e only
 
 ;;; Code:
 
-;; Pickup some macros, e.g. `with-temp-buffer', for old Emacsen.
-(require 'poe)
+;; For picking up the macros `char-next-index', `with-temp-buffer', etc.
+(require 'poem)
 
 (require 'pcustom)
-(require 'widget)
 (require 'std11)
 (require 'alist)
 
 ;;; @ version
 ;;;
 
-(defconst mu-cite-version "8.0")
+(defconst mu-cite-version "8.1")
 
 
-;;; @ obsoletes
+;;; @ macro
 ;;;
 
-;; This part will be abolished in the future.
-
-(eval-when-compile (require 'static))
-
-(defconst mu-cite-obsolete-variable-alist
-  '((mu-cite/cited-prefix-regexp       mu-cite-cited-prefix-regexp)
-    (mu-cite/default-methods-alist     mu-cite-default-methods-alist)
-    (mu-cite/get-field-value-method-alist
-     mu-cite-get-field-value-method-alist)
-    (mu-cite/instantiation-hook                mu-cite-instantiation-hook)
-    (mu-cite/ml-count-field-list       mu-cite-ml-count-field-list)
-    (mu-cite/post-cite-hook            mu-cite-post-cite-hook)
-    (mu-cite/pre-cite-hook             mu-cite-pre-cite-hook)
-    (mu-cite/prefix-format             mu-cite-prefix-format)
-    (mu-cite/top-format                        mu-cite-top-format)))
-
-(static-if (featurep 'xemacs)
-    (dolist (def mu-cite-obsolete-variable-alist)
-      (apply (function define-obsolete-variable-alias) def)))
-
-(dolist (def '((mu-cite/cite-original  mu-cite-original)
-              (mu-cite/get-field-value mu-cite-get-field-value)
-              (mu-cite/get-value       mu-cite-get-value)))
-  (apply (function define-obsolete-function-alias) def))
+(defmacro mu-cite-remove-text-properties (string)
+  "Remove text properties from STRING which is read from minibuffer."
+  (cond ((featurep 'xemacs)
+        `(let ((string (copy-sequence ,string)))
+           (map-extents (function (lambda (extent maparg)
+                                    (delete-extent extent)))
+                        string 0 (length string))
+           string))
+       ((or (boundp 'minibuffer-allow-text-properties);; Emacs 20.1 or later.
+            (not (fboundp 'set-text-properties)));; under Emacs 19.7.
+        string)
+       (t
+        `(let ((string (copy-sequence ,string)))
+           (set-text-properties 0 (length string) nil string)
+           string))))
 
 
 ;;; @ set up
 ;;;
 
 (defgroup mu-cite nil
-  "yet another citation tool for GNU Emacs."
+  "Yet another citation tool for GNU Emacs."
   :prefix "mu-cite-"
   :group 'mail
   :group 'news)
        (cons 'id
              (function
               (lambda ()
-                (let ((ml-name (mu-cite-get-value 'ml-name)))
+                (let ((ml-name (mu-cite-get-value 'ml-name))
+                      (ml-count (mu-cite-get-value 'ml-count)))
                   (if ml-name
                       (concat "["
                               ml-name
-                              " : No."
-                              (mu-cite-get-value 'ml-count)
+                              (if ml-count
+                                  (concat " : No." ml-count))
                               "]")
                     (mu-cite-get-value 'message-id))))))
        (cons 'in-id
              (function
               (lambda ()
                 (mu-cite-get-field-value "X-Attribution"))))
+       (cons 'x-cite-me
+             (function
+              (lambda ()
+                (mu-cite-get-field-value "X-Cite-Me"))))
        ;; mu-register
        (cons 'prefix (function mu-cite-get-prefix-method))
        (cons 'prefix-register
              (function mu-bbdb-get-prefix-register-verbose-method))
        ))
 
-(defun mu-cite-method-list ()
-  (mapcar (function car) mu-cite-default-methods-alist))
-
 
 ;;; @ formats
 ;;;
 
-(defvar widget-mu-cite-method-prompt-value-history nil
-  "History of input to `widget-mu-cite-method-prompt-value'.")
-
-(define-widget 'mu-cite-method 'symbol
-  "A mu-cite-method."
-  :format "%{%t%}: %v"
-  :tag "Method"
-  :prompt-history 'widget-mu-cite-method-prompt-value-history
-  :prompt-value 'widget-mu-cite-method-prompt-value
-  :action 'widget-mu-cite-method-action)
-
-(defun widget-mu-cite-method-prompt-value (widget prompt value unbound)
-  ;; Read mu-cite-method from minibuffer.
-  (intern
-   (completing-read (format "%s (default %s) " prompt value)
-                   (mapcar (function
-                            (lambda (sym)
-                              (list (symbol-name sym))
-                              ))
-                           (mu-cite-method-list)))))
-
-(defun widget-mu-cite-method-action (widget &optional event)
-  ;; Read a mu-cite-method from the minibuffer.
-  (let ((answer
-        (widget-mu-cite-method-prompt-value
-         widget
-         (widget-apply widget :menu-tag-get)
-         (widget-value widget)
-         t)))
-    (widget-value-set widget answer)
-    (widget-apply widget :notify widget event)
-    (widget-setup)))
-
 (defcustom mu-cite-cited-prefix-regexp
   "\\(^[^ \t\n<>]+>+[ \t]*\\|^[ \t]*$\\)"
   "Regexp to match the citation prefix.
@@ -227,25 +186,54 @@ If match, mu-cite doesn't insert citation prefix."
 
 (defcustom mu-cite-prefix-format '(prefix-register-verbose "> ")
   "List to represent citation prefix.
-Each elements must be string or method name."
-  :type '(repeat
-         (choice :tag "String or Method name"
-                 mu-cite-method
-                 (item "-")
-                 (choice-item :tag "String: \"> \"" "> ")
-                 (string :tag "Other String")))
+Each elements must be a string or a method name."
+  :type (list
+        'repeat
+        (list
+         'group
+         :convert-widget
+         (function
+          (lambda (widget)
+            (list
+             'choice
+             :tag "Method or String"
+             :args
+             (nconc
+              (mapcar
+               (function (lambda (elem) (list 'choice-item (car elem))))
+               mu-cite-default-methods-alist)
+              '((symbol :tag "Method")
+                (const :tag "-" nil)
+                (choice-item :tag "String: \"> \"" "> ")
+                (string))))))))
+  :set (function (lambda (symbol value)
+                  (set-default symbol (delq nil value))))
   :group 'mu-cite)
 
 (defcustom mu-cite-top-format '(in-id ">>>>>\t" from " wrote:\n")
   "List to represent top string of citation.
-Each elements must be string or method name."
-  :type '(repeat
-         (choice :tag "String or Method name"
-                 mu-cite-method
-                 (item "-")
-                 (choice-item :tag "String: \">>>>>\\t\"" ">>>>>\t")
-                 (choice-item :tag "String: \" wrote:\\n\"" " wrote:\n")
-                 (string :tag "Other String")))
+Each elements must be a string or a method name."
+  :type (list
+        'repeat
+        (list
+         'group
+         :convert-widget
+         (function
+          (lambda (widget)
+            (list 'choice
+                  :tag "Method or String"
+                  :args
+                  (nconc
+                   (mapcar
+                    (function (lambda (elem) (list 'choice-item (car elem))))
+                    mu-cite-default-methods-alist)
+                   '((symbol :tag "Method")
+                     (const :tag "-" nil)
+                     (choice-item :tag "String: \">>>>>\\t\"" ">>>>>\t")
+                     (choice-item :tag "String: \" wrote:\\n\"" " wrote:\n")
+                     (string :tag "String"))))))))
+  :set (function (lambda (symbol value)
+                  (set-default symbol (delq nil value))))
   :group 'mu-cite)
 
 
@@ -292,25 +280,28 @@ registered in variable `mu-cite-get-field-value-method-alist' is called."
 
 (defcustom mu-cite-ml-count-field-list
   '("X-Ml-Count" "X-Mail-Count" "X-Seqno" "X-Sequence" "Mailinglist-Id")
-  "List of header fields which contain sequence number of mailing list."
-  :type '(repeat (choice (choice-item "X-Ml-Count")
+  "List of header fields which contains a sequence number of the mailing list."
+  :type '(repeat (choice :tag "Field Name"
+                        (choice-item "X-Ml-Count")
                         (choice-item "X-Mail-Count")
                         (choice-item "X-Seqno")
                         (choice-item "X-Sequence")
                         (choice-item "Mailinglist-Id")
-                        (item "-")
+                        (const :tag "-" nil)
                         (string :tag "Other")))
+  :set (function (lambda (symbol value)
+                  (set-default symbol (delq nil value))))
   :group 'mu-cite)
 
 (defun mu-cite-get-ml-count-method ()
   "A mu-cite method to return a ML-count.
 This function searches a field about ML-count, which is specified by
-variable `mu-cite-ml-count-field-list', in a header.
+the variable `mu-cite-ml-count-field-list', in a header.
 If the field is found, the function returns a number part of the
 field.
 
 Notice that please use (mu-cite-get-value 'ml-count)
-instead of call the function directly."
+instead of to call the function directly."
   (let ((field-list mu-cite-ml-count-field-list))
     (catch 'tag
       (while field-list
@@ -332,7 +323,7 @@ instead of call the function directly."
   (run-hooks 'mu-cite-instantiation-hook))
 
 (defun mu-cite-get-value (item)
-  "Return current value of ITEM."
+  "Return a current value of ITEM."
   (let ((ret (cdr (assoc item mu-cite-methods-alist))))
     (if (functionp ret)
        (prog1
@@ -373,7 +364,8 @@ function according to the agreed upon standard."
       (insert top)
       (setq last-point (point))
       (while (< (point)(mark t))
-       (or (looking-at mu-cite-cited-prefix-regexp)
+       (or (and mu-cite-cited-prefix-regexp
+                (looking-at mu-cite-cited-prefix-regexp))
            (insert prefix))
        (forward-line 1))
       (goto-char last-point))
@@ -393,30 +385,38 @@ function according to the agreed upon standard."
   :type 'string
   :group 'mu-cite)
 
-(defun-maybe-cond char-category (character)
-  "Return string of category mnemonics for CHAR in TABLE.
-CHAR can be any multilingual character
-TABLE defaults to the current buffer's category table."
-  ((and (subr-fboundp 'char-category-set)
-       (subr-fboundp 'category-set-mnemonics))
-   (category-set-mnemonics (char-category-set character))
-   )
-  ((fboundp 'char-category-list)
-   (mapconcat (lambda (chr)
-               (char-to-string (int-char chr)))
-             (char-category-list character)
-             "")
-   )
-  ((boundp 'NEMACS)
-   (if (< (char-int character) 128)
-       "al"
-     "j")
-   )
-  (t
-   (if (< (char-int character) 128)
-       "al"
-     "l")
-   ))
+(eval-and-compile
+  ;; Don't use the function `char-category' which may have been
+  ;; defined by emu.el.  Anyway, the best way is not to use emu.el.
+  (if (and (fboundp 'char-category)
+          (subrp (symbol-function 'char-category)))
+      (defalias 'mu-cite-char-category 'char-category)
+    (defun-maybe-cond mu-cite-char-category (character &optional table)
+      "Return a string of category mnemonics for CHARACTER in TABLE.
+CHARACTER can be any multilingual characters,
+TABLE defaults to the current buffer's category table (it is currently
+ignored)."
+      ((and (subr-fboundp 'char-category-set)
+           (subr-fboundp 'category-set-mnemonics))
+       (category-set-mnemonics (char-category-set character)))
+      ((and (fboundp 'char-category-list)
+           ;; `char-category-list' returns a list of characters
+           ;; in XEmacs 21.2.25 and later, otherwise integers.
+           (characterp (car-safe (char-category-list ?a))))
+       (concat (char-category-list character)))
+      ((fboundp 'char-category-list)
+       (mapconcat (lambda (chr)
+                   (char-to-string (int-char chr)))
+                 (char-category-list character)
+                 ""))
+      ((boundp 'NEMACS)
+       (if (< (char-int character) 128)
+          "al"
+        "j"))
+      (t
+       (if (< (char-int character) 128)
+          "al"
+        "l")))))
 
 (defun detect-paragraph-cited-prefix ()
   (save-excursion
@@ -424,18 +424,20 @@ TABLE defaults to the current buffer's category table."
     (let ((i 0)
          (prefix
           (buffer-substring (line-beginning-position)
-                            (line-end-position)))
-         str ret)
-      (while (and (= (forward-line) 0)
-                 (setq str (buffer-substring
-                            (progn (beginning-of-line)(point))
-                            (progn (end-of-line)(point))))
-                 (setq ret (string-compare-from-top prefix str)))
-       (setq prefix
-             (if (stringp ret)
-                 ret
-               (cadr ret)))
-       (setq i (1+ i)))
+                            (line-end-position))))
+      (let ((init prefix)
+           str ret)
+       (while (and (= (forward-line) 0)
+                   (setq str (buffer-substring
+                              (progn (beginning-of-line)(point))
+                              (progn (end-of-line)(point))))
+                   (setq ret (string-compare-from-top prefix str)))
+         (setq prefix
+               (if (stringp ret)
+                   ret
+                 (car (cdr ret))))
+         (or (string-equal init prefix)
+             (setq i (1+ i)))))
       (cond ((> i 1) prefix)
            ((> i 0)
             (goto-char (point-min))
@@ -460,9 +462,18 @@ TABLE defaults to the current buffer's category table."
             (goto-char (match-end 0))
             (if (looking-at "[ \t]+")
                 (goto-char (match-end 0)))
-            (buffer-substring (point-min)(point)))
+            (buffer-substring (line-beginning-position)(point)))
            (t "")))))
 
+(defcustom fill-column-for-fill-cited-region nil
+  "Integer to override `fill-column' while `fill-cited-region' is being
+executed.  If you wish people call you ****-san, you may set the value
+of `fill-column' to 60 in the buffer for message sending and set this
+to 70. :-)"
+  :type `(choice (const :tag "Off" nil)
+                (integer ,default-fill-column))
+  :group 'mu-cite)
+
 ;;;###autoload
 (defun fill-cited-region (beg end)
   "Fill each of the paragraphs in the region as a cited text."
@@ -474,15 +485,19 @@ TABLE defaults to the current buffer's category table."
           (setq end (match-end 0)))
       (narrow-to-region beg end)
       (let* ((fill-prefix (detect-paragraph-cited-prefix))
-            (pat (concat fill-prefix "\n")))
+            (fill-column (max (+ 1 (current-left-margin)
+                                 (string-width fill-prefix))
+                              (or fill-column-for-fill-cited-region
+                                  (current-fill-column))))
+            (pat (concat fill-prefix "\n"))
+            filladapt-mode)
        (goto-char (point-min))
        (while (search-forward pat nil t)
          (let ((b (match-beginning 0))
                (e (match-end 0)))
            (delete-region b e)
            (if (and (> b (point-min))
-                    (let ((cat (char-category
-                                (char-before b))))
+                    (let ((cat (mu-cite-char-category (char-before b))))
                       (or (string-match "a" cat)
                           (string-match "l" cat))))
                (insert " "))))
@@ -516,9 +531,11 @@ TABLE defaults to the current buffer's category table."
                             pe (match-beginning 1)
                             s (match-end 0)))
                     i)))
-       (when (and ps (< ps pe))
-         (delete-region b e)
-         (insert (concat (substring prefix ps pe) (make-string nest ?>))))
+       (if (and ps (< ps pe))
+           (progn
+             (delete-region b e)
+             (insert (concat (substring prefix ps pe)
+                             (make-string nest ?>)))))
        ))))
 
 (defun replace-top-string (old new)
@@ -555,23 +572,4 @@ TABLE defaults to the current buffer's category table."
 
 (run-hooks 'mu-cite-load-hook)
 
-;; This part will be abolished in the future.
-
-(static-unless (featurep 'xemacs)
-  (let ((rest mu-cite-obsolete-variable-alist)
-       def new-sym old-sym)
-    (while rest
-      (setq def (car rest))
-      (apply (function make-obsolete-variable) def)
-      (setq old-sym (car def)
-           new-sym (car (cdr def)))
-      (or (get new-sym 'saved-value) ; saved?
-         (not (eq (eval (car (get new-sym 'standard-value)))
-                  (symbol-value new-sym))) ; set as new name?
-         (and (boundp old-sym) ; old name seems used
-              (or (eq (symbol-value new-sym)
-                      (symbol-value old-sym))
-                  (set new-sym (symbol-value old-sym)))))
-      (setq rest (cdr rest)))))
-
 ;;; mu-cite.el ends here