cgit.sxemacs.org Git - gnus/blob - lisp/gnus-msg.el

   1 ;;; gnus-msg.el --- mail and post interface for Gnus
   2
   3 ;; Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
   4 ;;   2004, 2005, 2006 Free Software Foundation, Inc.
   5
   6 ;; Author: Masanobu UMEDA <umerin@flab.flab.fujitsu.junet>
   7 ;;      Lars Magne Ingebrigtsen <larsi@gnus.org>
   8 ;; Keywords: news
   9
  10 ;; This file is part of GNU Emacs.
  11
  12 ;; GNU Emacs is free software; you can redistribute it and/or modify
  13 ;; it under the terms of the GNU General Public License as published by
  14 ;; the Free Software Foundation; either version 2, or (at your option)
  15 ;; any later version.
  16
  17 ;; GNU Emacs is distributed in the hope that it will be useful,
  18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 ;; GNU General Public License for more details.
  21
  22 ;; You should have received a copy of the GNU General Public License
  23 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
  24 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  25 ;; Boston, MA 02110-1301, USA.
  26
  27 ;;; Commentary:
  28
  29 ;;; Code:
  30
  31 (eval-when-compile (require 'cl))
  32
  33 (require 'gnus)
  34 (require 'gnus-ems)
  35 (require 'message)
  36 (require 'gnus-art)
  37 (require 'gnus-util)
  38
  39 (defcustom gnus-post-method 'current
  40   "*Preferred method for posting USENET news.
  41
  42 If this variable is `current' (which is the default), Gnus will use
  43 the \"current\" select method when posting.  If it is `native', Gnus
  44 will use the native select method when posting.
  45
  46 This method will not be used in mail groups and the like, only in
  47 \"real\" newsgroups.
  48
  49 If not `native' nor `current', the value must be a valid method as discussed
  50 in the documentation of `gnus-select-method'.  It can also be a list of
  51 methods.  If that is the case, the user will be queried for what select
  52 method to use when posting."
  53   :group 'gnus-group-foreign
  54   :link '(custom-manual "(gnus)Posting Server")
  55   :type `(choice (const native)
  56                  (const current)
  57                  (sexp :tag "Methods" ,gnus-select-method)))
  58
  59 (defcustom gnus-outgoing-message-group nil
  60   "*All outgoing messages will be put in this group.
  61 If you want to store all your outgoing mail and articles in the group
  62 \"nnml:archive\", you set this variable to that value.  This variable
  63 can also be a list of group names.
  64
  65 If you want to have greater control over what group to put each
  66 message in, you can set this variable to a function that checks the
  67 current newsgroup name and then returns a suitable group name (or list
  68 of names)."
  69   :group 'gnus-message
  70   :type '(choice (const nil)
  71                  (function)
  72                  (string :tag "Group")
  73                  (repeat :tag "List of groups" (string :tag "Group"))))
  74
  75 (defcustom gnus-mailing-list-groups nil
  76   "*If non-nil a regexp matching groups that are really mailing lists.
  77 This is useful when you're reading a mailing list that has been
  78 gatewayed to a newsgroup, and you want to followup to an article in
  79 the group."
  80   :group 'gnus-message
  81   :type '(choice (regexp)
  82                  (const nil)))
  83
  84 (defcustom gnus-add-to-list nil
  85   "*If non-nil, add a `to-list' parameter automatically."
  86   :group 'gnus-message
  87   :type 'boolean)
  88
  89 (defcustom gnus-crosspost-complaint
  90   "Hi,
  91
  92 You posted the article below with the following Newsgroups header:
  93
  94 Newsgroups: %s
  95
  96 The %s group, at least, was an inappropriate recipient
  97 of this message.  Please trim your Newsgroups header to exclude this
  98 group before posting in the future.
  99
 100 Thank you.
 101
 102 "
 103   "Format string to be inserted when complaining about crossposts.
 104 The first %s will be replaced by the Newsgroups header;
 105 the second with the current group name."
 106   :group 'gnus-message
 107   :type 'string)
 108
 109 (defcustom gnus-message-setup-hook nil
 110   "Hook run after setting up a message buffer."
 111   :group 'gnus-message
 112   :type 'hook)
 113
 114 (defcustom gnus-bug-create-help-buffer t
 115   "*Should we create the *Gnus Help Bug* buffer?"
 116   :group 'gnus-message
 117   :type 'boolean)
 118
 119 (defcustom gnus-posting-styles nil
 120   "*Alist of styles to use when posting.
 121 See Info node `(gnus)Posting Styles'."
 122   :group 'gnus-message
 123   :link '(custom-manual "(gnus)Posting Styles")
 124   :type '(repeat (cons (choice (regexp)
 125                                (variable)
 126                                (list (const header)
 127                                      (string :tag "Header")
 128                                      (regexp :tag "Regexp"))
 129                                (function)
 130                                (sexp))
 131                        (repeat (list
 132                                 (choice (const signature)
 133                                         (const signature-file)
 134                                         (const organization)
 135                                         (const address)
 136                                         (const x-face-file)
 137                                         (const name)
 138                                         (const body)
 139                                         (symbol)
 140                                         (string :tag "Header"))
 141                                 (choice (string)
 142                                         (function)
 143                                         (variable)
 144                                         (sexp)))))))
 145
 146 (defcustom gnus-gcc-mark-as-read nil
 147   "If non-nil, automatically mark Gcc articles as read."
 148   :version "22.1"
 149   :group 'gnus-message
 150   :type 'boolean)
 151
 152 (make-obsolete-variable 'gnus-inews-mark-gcc-as-read
 153                         'gnus-gcc-mark-as-read)
 154
 155 (defcustom gnus-gcc-externalize-attachments nil
 156   "Should local-file attachments be included as external parts in Gcc copies?
 157 If it is `all', attach files as external parts;
 158 if a regexp and matches the Gcc group name, attach files as external parts;
 159 if nil, attach files as normal parts."
 160   :version "22.1"
 161   :group 'gnus-message
 162   :type '(choice (const nil :tag "None")
 163                  (const all :tag "Any")
 164                  (string :tag "Regexp")))
 165
 166 (gnus-define-group-parameter
 167  posting-charset-alist
 168  :type list
 169  :function-document
 170  "Return the permitted unencoded charsets for posting of GROUP."
 171  :variable gnus-group-posting-charset-alist
 172  :variable-default
 173   '(("^\\(no\\|fr\\)\\.[^,]*\\(,[ \t\n]*\\(no\\|fr\\)\\.[^,]*\\)*$" iso-8859-1 (iso-8859-1))
 174     ("^\\(fido7\\|relcom\\)\\.[^,]*\\(,[ \t\n]*\\(fido7\\|relcom\\)\\.[^,]*\\)*$" koi8-r (koi8-r))
 175     (message-this-is-mail nil nil)
 176     (message-this-is-news nil t))
 177  :variable-document
 178   "Alist of regexps and permitted unencoded charsets for posting.
 179 Each element of the alist has the form (TEST HEADER BODY-LIST), where
 180 TEST is either a regular expression matching the newsgroup header or a
 181 variable to query,
 182 HEADER is the charset which may be left unencoded in the header (nil
 183 means encode all charsets),
 184 BODY-LIST is a list of charsets which may be encoded using 8bit
 185 content-transfer encoding in the body, or one of the special values
 186 nil (always encode using quoted-printable) or t (always use 8bit).
 187
 188 Note that any value other than nil for HEADER infringes some RFCs, so
 189 use this option with care."
 190  :variable-group gnus-charset
 191  :variable-type
 192  '(repeat (list :tag "Permitted unencoded charsets"
 193                 (choice :tag "Where"
 194                         (regexp :tag "Group")
 195                         (const :tag "Mail message" :value message-this-is-mail)
 196                         (const :tag "News article" :value message-this-is-news))
 197                 (choice :tag "Header"
 198                         (const :tag "None" nil)
 199                         (symbol :tag "Charset"))
 200                 (choice :tag "Body"
 201                         (const :tag "Any" :value t)
 202                         (const :tag "None" :value nil)
 203                         (repeat :tag "Charsets"
 204                                 (symbol :tag "Charset")))))
 205  :parameter-type '(choice :tag "Permitted unencoded charsets"
 206                           :value nil
 207                           (repeat (symbol)))
 208  :parameter-document       "\
 209 List of charsets that are permitted to be unencoded.")
 210
 211 (defcustom gnus-debug-files
 212   '("gnus.el" "gnus-sum.el" "gnus-group.el"
 213     "gnus-art.el" "gnus-start.el" "gnus-async.el"
 214     "gnus-msg.el" "gnus-score.el" "gnus-win.el" "gnus-topic.el"
 215     "gnus-agent.el" "gnus-cache.el" "gnus-srvr.el"
 216     "mm-util.el" "mm-decode.el" "nnmail.el" "message.el")
 217   "Files whose variables will be reported in `gnus-bug'."
 218   :version "22.1"
 219   :group 'gnus-message
 220   :type '(repeat (string :tag "File")))
 221
 222 (defcustom gnus-debug-exclude-variables
 223   '(mm-mime-mule-charset-alist
 224     nnmail-split-fancy message-minibuffer-local-map)
 225   "Variables that should not be reported in `gnus-bug'."
 226   :version "22.1"
 227   :group 'gnus-message
 228   :type '(repeat (symbol :tag "Variable")))
 229
 230 (defcustom gnus-discouraged-post-methods
 231   '(nndraft nnml nnimap nnmaildir nnmh nnfolder nndir)
 232   "A list of back ends that are not used in \"real\" newsgroups.
 233 This variable is used only when `gnus-post-method' is `current'."
 234   :version "22.1"
 235   :group 'gnus-group-foreign
 236   :type '(repeat (symbol :tag "Back end")))
 237
 238 (defcustom gnus-message-replysign
 239   nil
 240   "Automatically sign replies to signed messages.
 241 See also the `mml-default-sign-method' variable."
 242   :group 'gnus-message
 243   :type 'boolean)
 244
 245 (defcustom gnus-message-replyencrypt
 246   nil
 247   "Automatically encrypt replies to encrypted messages.
 248 See also the `mml-default-encrypt-method' variable."
 249   :group 'gnus-message
 250   :type 'boolean)
 251
 252 (defcustom gnus-message-replysignencrypted
 253   t
 254   "Setting this causes automatically encrypted messages to also be signed."
 255   :group 'gnus-message
 256   :type 'boolean)
 257
 258 (defcustom gnus-confirm-mail-reply-to-news (and gnus-novice-user
 259                                                 (not gnus-expert-user))
 260   "If non-nil, Gnus requests confirmation when replying to news.
 261 This is done because new users often reply by mistake when reading
 262 news.
 263 This can also be a function receiving the group name as the only
 264 parameter which should return non-nil iff a confirmation is needed, or
 265 a regexp, in which case a confirmation is asked for iff the group name
 266 matches the regexp."
 267   :version "22.1"
 268   :group 'gnus-message
 269   :type '(choice (const :tag "No" nil)
 270                  (const :tag "Yes" t)
 271                  (regexp :tag "Iff group matches regexp")
 272                  (function :tag "Iff function evaluates to non-nil")))
 273
 274 (defcustom gnus-confirm-treat-mail-like-news
 275   nil
 276   "If non-nil, Gnus will treat mail like news with regard to confirmation
 277 when replying by mail.  See the `gnus-confirm-mail-reply-to-news' variable
 278 for fine-tuning this.
 279 If nil, Gnus will never ask for confirmation if replying to mail."
 280   :version "22.1"
 281   :group 'gnus-message
 282   :type 'boolean)
 283
 284 (defcustom gnus-summary-resend-default-address t
 285   "If non-nil, Gnus tries to suggest a default address to resend to.
 286 If nil, the address field will always be empty after invoking
 287 `gnus-summary-resend-message'."
 288   :version "22.1"
 289   :group 'gnus-message
 290   :type 'boolean)
 291
 292 ;;; Internal variables.
 293
 294 (defvar gnus-inhibit-posting-styles nil
 295   "Inhibit the use of posting styles.")
 296
 297 (defvar gnus-article-yanked-articles nil)
 298 (defvar gnus-message-buffer "*Mail Gnus*")
 299 (defvar gnus-article-copy nil)
 300 (defvar gnus-check-before-posting nil)
 301 (defvar gnus-last-posting-server nil)
 302 (defvar gnus-message-group-art nil)
 303
 304 (defvar gnus-msg-force-broken-reply-to nil)
 305
 306 (defconst gnus-bug-message
 307   "Sending a bug report to the Gnus Towers.
 308 ========================================
 309
 310 The buffer below is a mail buffer.  When you press `C-c C-c', it will
 311 be sent to the Gnus Bug Exterminators.
 312
 313 The thing near the bottom of the buffer is how the environment
 314 settings will be included in the mail.  Please do not delete that.
 315 They will tell the Bug People what your environment is, so that it
 316 will be easier to locate the bugs.
 317
 318 If you have found a bug that makes Emacs go \"beep\", set
 319 debug-on-error to t (`M-x set-variable RET debug-on-error RET t RET')
 320 and include the backtrace in your bug report.
 321
 322 Please describe the bug in annoying, painstaking detail.
 323
 324 Thank you for your help in stamping out bugs.
 325 ")
 326
 327 (eval-and-compile
 328   (autoload 'gnus-uu-post-news "gnus-uu" nil t))
 329
 330 \f
 331 ;;;
 332 ;;; Gnus Posting Functions
 333 ;;;
 334
 335 (gnus-define-keys (gnus-summary-send-map "S" gnus-summary-mode-map)
 336   "p" gnus-summary-post-news
 337   "i" gnus-summary-news-other-window
 338   "f" gnus-summary-followup
 339   "F" gnus-summary-followup-with-original
 340   "c" gnus-summary-cancel-article
 341   "s" gnus-summary-supersede-article
 342   "r" gnus-summary-reply
 343   "y" gnus-summary-yank-message
 344   "R" gnus-summary-reply-with-original
 345   "w" gnus-summary-wide-reply
 346   "W" gnus-summary-wide-reply-with-original
 347   "v" gnus-summary-very-wide-reply
 348   "V" gnus-summary-very-wide-reply-with-original
 349   "n" gnus-summary-followup-to-mail
 350   "N" gnus-summary-followup-to-mail-with-original
 351   "m" gnus-summary-mail-other-window
 352   "u" gnus-uu-post-news
 353   "\M-c" gnus-summary-mail-crosspost-complaint
 354   "Br" gnus-summary-reply-broken-reply-to
 355   "BR" gnus-summary-reply-broken-reply-to-with-original
 356   "om" gnus-summary-mail-forward
 357   "op" gnus-summary-post-forward
 358   "Om" gnus-uu-digest-mail-forward
 359   "Op" gnus-uu-digest-post-forward)
 360
 361 (gnus-define-keys (gnus-send-bounce-map "D" gnus-summary-send-map)
 362   "b" gnus-summary-resend-bounced-mail
 363   ;; "c" gnus-summary-send-draft
 364   "r" gnus-summary-resend-message
 365   "e" gnus-summary-resend-message-edit)
 366
 367 ;;; Internal functions.
 368
 369 (defun gnus-inews-make-draft (articles)
 370   `(lambda ()
 371      (gnus-inews-make-draft-meta-information
 372       ,gnus-newsgroup-name ',articles)))
 373
 374 (defvar gnus-article-reply nil)
 375 (defmacro gnus-setup-message (config &rest forms)
 376   (let ((winconf (make-symbol "gnus-setup-message-winconf"))
 377         (buffer (make-symbol "gnus-setup-message-buffer"))
 378         (article (make-symbol "gnus-setup-message-article"))
 379         (yanked (make-symbol "gnus-setup-yanked-articles"))
 380         (group (make-symbol "gnus-setup-message-group")))
 381     `(let ((,winconf (current-window-configuration))
 382            (,buffer (buffer-name (current-buffer)))
 383            (,article gnus-article-reply)
 384            (,yanked gnus-article-yanked-articles)
 385            (,group gnus-newsgroup-name)
 386            (message-header-setup-hook
 387             (copy-sequence message-header-setup-hook))
 388            (mbl mml-buffer-list)
 389            (message-mode-hook (copy-sequence message-mode-hook)))
 390        (setq mml-buffer-list nil)
 391        (add-hook 'message-header-setup-hook 'gnus-inews-insert-gcc)
 392        (add-hook 'message-header-setup-hook 'gnus-inews-insert-archive-gcc)
 393        ;; #### FIXME: for a reason that I did not manage to identify yet,
 394        ;; the variable `gnus-newsgroup-name' does not honor a dynamically
 395        ;; scoped or setq'ed value from a caller like `C-u gnus-summary-mail'.
 396        ;; After evaluation of @forms below, it gets the value we actually want
 397        ;; to override, and the posting styles are used. For that reason, I've
 398        ;; added an optional argument to `gnus-configure-posting-styles' to
 399        ;; make sure that the correct value for the group name is used. -- drv
 400        (add-hook 'message-mode-hook
 401                  (if (memq ,config '(reply-yank reply))
 402                      (lambda ()
 403                        (gnus-configure-posting-styles ,group))
 404                    (lambda ()
 405                      ;; There may be an old " *gnus article copy*" buffer.
 406                      (let (gnus-article-copy)
 407                        (gnus-configure-posting-styles ,group)))))
 408        (gnus-pull ',(intern gnus-draft-meta-information-header)
 409                   message-required-headers)
 410        (when (and ,group
 411                   (not (string= ,group "")))
 412          (push (cons
 413                 (intern gnus-draft-meta-information-header)
 414                 (gnus-inews-make-draft (or ,yanked ,article)))
 415                message-required-headers))
 416        (unwind-protect
 417            (progn
 418              ,@forms)
 419          (gnus-inews-add-send-actions ,winconf ,buffer ,article ,config
 420                                       ,yanked)
 421          (setq gnus-message-buffer (current-buffer))
 422          (set (make-local-variable 'gnus-message-group-art)
 423               (cons ,group ,article))
 424          (set (make-local-variable 'gnus-newsgroup-name) ,group)
 425          (gnus-run-hooks 'gnus-message-setup-hook)
 426          (if (eq major-mode 'message-mode)
 427              (let ((mbl1 mml-buffer-list))
 428                (setq mml-buffer-list mbl)  ;; Global value
 429                (set (make-local-variable 'mml-buffer-list) mbl1);; Local value
 430                (gnus-make-local-hook 'kill-buffer-hook)
 431                (gnus-make-local-hook 'change-major-mode-hook)
 432                (add-hook 'change-major-mode-hook 'mml-destroy-buffers nil t)
 433                (add-hook 'kill-buffer-hook 'mml-destroy-buffers t t))
 434            (mml-destroy-buffers)
 435            (setq mml-buffer-list mbl)))
 436        (message-hide-headers)
 437        (gnus-add-buffer)
 438        (gnus-configure-windows ,config t)
 439        (run-hooks 'post-command-hook)
 440        (set-buffer-modified-p nil))))
 441
 442 (defun gnus-inews-make-draft-meta-information (group articles)
 443   (when (numberp articles)
 444     (setq articles (list articles)))
 445   (concat "(\"" group "\""
 446           (if articles
 447               (concat " "
 448                       (mapconcat
 449                        (lambda (elem)
 450                          (number-to-string
 451                           (if (consp elem)
 452                               (car elem)
 453                             elem)))
 454                        articles " "))
 455             "")
 456           ")"))
 457
 458 ;;;###autoload
 459 (defun gnus-msg-mail (&optional to subject other-headers continue
 460                                 switch-action yank-action send-actions)
 461   "Start editing a mail message to be sent.
 462 Like `message-mail', but with Gnus paraphernalia, particularly the
 463 Gcc: header for archiving purposes."
 464   (interactive)
 465   (let ((buf (current-buffer))
 466         mail-buf)
 467     (gnus-setup-message 'message
 468       (message-mail to subject other-headers continue
 469                     nil yank-action send-actions))
 470     (when switch-action
 471       (setq mail-buf (current-buffer))
 472       (switch-to-buffer buf)
 473       (apply switch-action mail-buf nil)))
 474   ;; COMPOSEFUNC should return t if succeed.  Undocumented ???
 475   t)
 476
 477 ;;;###autoload
 478 (defun gnus-button-mailto (address)
 479   "Mail to ADDRESS."
 480   (set-buffer (gnus-copy-article-buffer))
 481   (gnus-setup-message 'message
 482     (message-reply address)))
 483
 484 ;;;###autoload
 485 (defun gnus-button-reply (&optional to-address wide)
 486   "Like `message-reply'."
 487   (interactive)
 488   (gnus-setup-message 'message
 489     (message-reply to-address wide)))
 490
 491 ;;;###autoload
 492 (define-mail-user-agent 'gnus-user-agent
 493   'gnus-msg-mail 'message-send-and-exit
 494   'message-kill-buffer 'message-send-hook)
 495
 496 (defun gnus-setup-posting-charset (group)
 497   (let ((alist gnus-group-posting-charset-alist)
 498         (group (or group ""))
 499         elem)
 500     (when group
 501       (catch 'found
 502         (while (setq elem (pop alist))
 503           (when (or (and (stringp (car elem))
 504                          (string-match (car elem) group))
 505                     (and (functionp (car elem))
 506                          (funcall (car elem) group))
 507                     (and (symbolp (car elem))
 508                          (symbol-value (car elem))))
 509             (throw 'found (cons (cadr elem) (caddr elem)))))))))
 510
 511 (defun gnus-inews-add-send-actions (winconf buffer article
 512                                             &optional config yanked)
 513   (gnus-make-local-hook 'message-sent-hook)
 514   (add-hook 'message-sent-hook (if gnus-agent 'gnus-agent-possibly-do-gcc
 515                                  'gnus-inews-do-gcc) nil t)
 516   (when gnus-agent
 517     (gnus-make-local-hook 'message-header-hook)
 518     (add-hook 'message-header-hook 'gnus-agent-possibly-save-gcc nil t))
 519   (setq message-post-method
 520         `(lambda (&optional arg)
 521            (gnus-post-method arg ,gnus-newsgroup-name)))
 522   (setq message-newsreader (setq message-mailer (gnus-extended-version)))
 523   (message-add-action
 524    `(when (gnus-buffer-exists-p ,buffer)
 525       (set-window-configuration ,winconf))
 526    'exit 'postpone 'kill)
 527   (let ((to-be-marked (cond
 528                        (yanked
 529                         (mapcar
 530                          (lambda (x) (if (listp x) (car x) x)) yanked))
 531                        (article (if (listp article) article (list article)))
 532                        (t nil))))
 533     (message-add-action
 534      `(when (gnus-buffer-exists-p ,buffer)
 535         (save-excursion
 536           (set-buffer ,buffer)
 537           ,(when to-be-marked
 538              (if (eq config 'forward)
 539                  `(gnus-summary-mark-article-as-forwarded ',to-be-marked)
 540                `(gnus-summary-mark-article-as-replied ',to-be-marked)))))
 541      'send)))
 542
 543 (put 'gnus-setup-message 'lisp-indent-function 1)
 544 (put 'gnus-setup-message 'edebug-form-spec '(form body))
 545
 546 ;;; Post news commands of Gnus group mode and summary mode
 547
 548 (defun gnus-group-mail (&optional arg)
 549   "Start composing a mail.
 550 If ARG, use the group under the point to find a posting style.
 551 If ARG is 1, prompt for a group name to find the posting style."
 552   (interactive "P")