message.el 286 KB
Newer Older
1
;;; message.el --- composing mail and news messages
2 3

;; Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
Glenn Morris's avatar
Glenn Morris committed
4
;;   2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
5

6
;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
7 8 9 10
;; Keywords: mail, news

;; This file is part of GNU Emacs.

11
;; GNU Emacs is free software: you can redistribute it and/or modify
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
12
;; it under the terms of the GNU General Public License as published by
13 14
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
15 16 17

;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
19 20 21
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
22
;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
23 24 25 26 27 28 29 30 31

;;; Commentary:

;; This mode provides mail-sending facilities from within Emacs.  It
;; consists mainly of large chunks of code from the sendmail.el,
;; gnus-msg.el and rnewspost.el files.

;;; Code:

32
;; For Emacs <22.2 and XEmacs.
33 34
(eval-and-compile
  (unless (fboundp 'declare-function) (defmacro declare-function (&rest r))))
35
(eval-when-compile
Dan Nicolaescu's avatar
Dan Nicolaescu committed
36
  (require 'cl))
37

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
38
(require 'mailheader)
39
(require 'gmm-utils)
40 41 42 43
(require 'mail-utils)
;; Only for the trivial macros mail-header-from, mail-header-date
;; mail-header-references, mail-header-subject, mail-header-id
(eval-when-compile (require 'nnheader))
44 45 46
;; This is apparently necessary even though things are autoloaded.
;; Because we dynamically bind mail-abbrev-mode-regexp, we'd better
;; require mailabbrev here.
47
(if (featurep 'xemacs)
48 49
    (require 'mail-abbrevs)
  (require 'mailabbrev))
50 51
(require 'mail-parse)
(require 'mml)
52
(require 'rfc822)
53

54 55
(autoload 'mailclient-send-it "mailclient") ;; Emacs 22 or contrib/

Dan Nicolaescu's avatar
Dan Nicolaescu committed
56 57 58
(defvar gnus-message-group-art)
(defvar gnus-list-identifiers) ; gnus-sum is required where necessary
(defvar rmail-enable-mime-composing)
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
59 60 61 62 63 64 65 66 67 68 69 70

(defgroup message '((user-mail-address custom-variable)
		    (user-full-name custom-variable))
  "Mail and news message composing."
  :link '(custom-manual "(message)Top")
  :group 'mail
  :group 'news)

(put 'user-mail-address 'custom-type 'string)
(put 'user-full-name 'custom-type 'string)

(defgroup message-various nil
71
  "Various Message Variables."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
72 73 74 75
  :link '(custom-manual "(message)Various Message Variables")
  :group 'message)

(defgroup message-buffers nil
76
  "Message Buffers."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
77 78 79 80
  :link '(custom-manual "(message)Message Buffers")
  :group 'message)

(defgroup message-sending nil
81
  "Message Sending."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
82 83 84 85
  :link '(custom-manual "(message)Sending Variables")
  :group 'message)

(defgroup message-interface nil
86
  "Message Interface."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
87 88 89 90
  :link '(custom-manual "(message)Interface")
  :group 'message)

(defgroup message-forwarding nil
91
  "Message Forwarding."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
92 93 94 95
  :link '(custom-manual "(message)Forwarding")
  :group 'message-interface)

(defgroup message-insertion nil
96
  "Message Insertion."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
97 98 99 100
  :link '(custom-manual "(message)Insertion")
  :group 'message)

(defgroup message-headers nil
101
  "Message Headers."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
102 103 104 105
  :link '(custom-manual "(message)Message Headers")
  :group 'message)

(defgroup message-news nil
106
  "Composing News Messages."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
107 108 109
  :group 'message)

(defgroup message-mail nil
110
  "Composing Mail Messages."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130
  :group 'message)

(defgroup message-faces nil
  "Faces used for message composing."
  :group 'message
  :group 'faces)

(defcustom message-directory "~/Mail/"
  "*Directory from which all other mail file variables are derived."
  :group 'message-various
  :type 'directory)

(defcustom message-max-buffers 10
  "*How many buffers to keep before starting to kill them off."
  :group 'message-buffers
  :type 'integer)

(defcustom message-send-rename-function nil
  "Function called to rename the buffer after sending it."
  :group 'message-buffers
Dave Love's avatar
Dave Love committed
131
  :type '(choice function (const nil)))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
132 133 134 135 136 137 138 139 140 141

(defcustom message-fcc-handler-function 'message-output
  "*A function called to save outgoing articles.
This function will be called with the name of the file to store the
article in.  The default function is `message-output' which saves in Unix
mailbox format."
  :type '(radio (function-item message-output)
		(function :tag "Other"))
  :group 'message-sending)

142 143
(defcustom message-fcc-externalize-attachments nil
  "If non-nil, attachments are included as external parts in Fcc copies."
144
  :version "22.1"
145 146 147
  :type 'boolean
  :group 'message-sending)

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
148
(defcustom message-courtesy-message
149
  "The following message is a courtesy copy of an article\nthat has been posted to %s as well.\n\n"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
150 151 152 153 154
  "*This is inserted at the start of a mailed copy of a posted message.
If the string contains the format spec \"%s\", the Newsgroups
the article has been posted to will be inserted there.
If this variable is nil, no such courtesy message will be added."
  :group 'message-sending
155
  :type '(radio string (const nil)))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
156

157 158
(defcustom message-ignored-bounced-headers
  "^\\(Received\\|Return-Path\\|Delivered-To\\):"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
159 160 161 162
  "*Regexp that matches headers to be removed in resent bounced mail."
  :group 'message-interface
  :type 'regexp)

163
(defcustom message-from-style mail-from-style
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
164 165
  "*Specifies how \"From\" headers look.

Dave Love's avatar
Dave Love committed
166
If nil, they contain just the return address like:
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
167 168 169 170 171 172 173 174
	king@grassland.com
If `parens', they look like:
	king@grassland.com (Elvis Parsley)
If `angles', they look like:
	Elvis Parsley <king@grassland.com>

Otherwise, most addresses look like `angles', but they look like
`parens' if `angles' would need quoting and `parens' would not."
175
  :version "23.2"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
176 177 178 179 180 181
  :type '(choice (const :tag "simple" nil)
		 (const parens)
		 (const angles)
		 (const default))
  :group 'message-headers)

182 183
(defcustom message-insert-canlock t
  "Whether to insert a Cancel-Lock header in news postings."
184
  :version "22.1"
185 186 187 188 189
  :group 'message-headers
  :type 'boolean)

(defcustom message-syntax-checks
  (if message-insert-canlock '((sender . disabled)) nil)
190
  ;; Guess this one shouldn't be easy to customize...
191
  "*Controls what syntax checks should not be performed on outgoing posts.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
192 193 194 195 196
To disable checking of long signatures, for instance, add
 `(signature . disabled)' to this list.

Don't touch this variable unless you really know what you're doing.

Miles Bader's avatar
Miles Bader committed
197 198
Checks include `approved', `bogus-recipient', `continuation-headers',
`control-chars', `empty', `existing-newsgroups', `from', `illegible-text',
Miles Bader's avatar
Miles Bader committed
199 200
`invisible-text', `long-header-lines', `long-lines', `message-id',
`multiple-headers', `new-text', `newsgroups', `quoting-style',
Miles Bader's avatar
Miles Bader committed
201
`repeated-newsgroups', `reply-to', `sender', `sendsys', `shoot',
Miles Bader's avatar
Miles Bader committed
202 203
`shorten-followup-to', `signature', `size', `subject', `subject-cmsg'
and `valid-newsgroups'."
204
  :group 'message-news
Dave Love's avatar
Dave Love committed
205
  :type '(repeat sexp))			; Fixme: improve this
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
206

207 208 209 210 211
(defcustom message-required-headers '((optional . References)
				      From)
  "*Headers to be generated or prompted for when sending a message.
Also see `message-required-news-headers' and
`message-required-mail-headers'."
212
  :version "22.1"
213 214 215 216 217
  :group 'message-news
  :group 'message-headers
  :link '(custom-manual "(message)Message Headers")
  :type '(repeat sexp))

218
(defcustom message-draft-headers '(References From Date)
219
  "*Headers to be generated when saving a draft message."
220
  :version "22.1"
221 222 223 224 225
  :group 'message-news
  :group 'message-headers
  :link '(custom-manual "(message)Message Headers")
  :type '(repeat sexp))

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
226 227
(defcustom message-required-news-headers
  '(From Newsgroups Subject Date Message-ID
228
	 (optional . Organization)
229
	 (optional . User-Agent))
230
  "*Headers to be generated or prompted for when posting an article.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
231 232
RFC977 and RFC1036 require From, Date, Newsgroups, Subject,
Message-ID.  Organization, Lines, In-Reply-To, Expires, and
Miles Bader's avatar
Miles Bader committed
233
User-Agent are optional.  If you don't want message to insert some
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
234 235 236
header, remove it from this list."
  :group 'message-news
  :group 'message-headers
237
  :link '(custom-manual "(message)Message Headers")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
238 239 240
  :type '(repeat sexp))

(defcustom message-required-mail-headers
241
  '(From Subject Date (optional . In-Reply-To) Message-ID
242
	 (optional . User-Agent))
243
  "*Headers to be generated or prompted for when mailing a message.
244 245
It is recommended that From, Date, To, Subject and Message-ID be
included.  Organization and User-Agent are optional."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
246 247
  :group 'message-mail
  :group 'message-headers
248
  :link '(custom-manual "(message)Message Headers")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
249 250
  :type '(repeat sexp))

251 252 253
(defcustom message-prune-recipient-rules nil
  "Rules for how to prune the list of recipients when doing wide replies.
This is a list of regexps and regexp matches."
254
  :version "24.1"
255 256 257 258 259
  :group 'message-mail
  :group 'message-headers
  :link '(custom-manual "(message)Wide Reply")
  :type '(repeat regexp))

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
260 261 262
(defcustom message-deletable-headers '(Message-ID Date Lines)
  "Headers to be deleted if they already exist and were generated by message previously."
  :group 'message-headers
263
  :link '(custom-manual "(message)Message Headers")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
264 265 266
  :type 'sexp)

(defcustom message-ignored-news-headers
267
  "^NNTP-Posting-Host:\\|^Xref:\\|^[BGF]cc:\\|^Resent-Fcc:\\|^X-Draft-From:\\|^X-Gnus-Agent-Meta-Information:"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
268 269 270
  "*Regexp of headers to be removed unconditionally before posting."
  :group 'message-news
  :group 'message-headers
271
  :link '(custom-manual "(message)Message Headers")
272 273 274 275 276 277
  :type '(repeat :value-to-internal (lambda (widget value)
				      (custom-split-regexp-maybe value))
		 :match (lambda (widget value)
			  (or (stringp value)
			      (widget-editable-list-match widget value)))
		 regexp))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
278

279 280
(defcustom message-ignored-mail-headers
  "^[GF]cc:\\|^Resent-Fcc:\\|^Xref:\\|^X-Draft-From:\\|^X-Gnus-Agent-Meta-Information:"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
281 282 283
  "*Regexp of headers to be removed unconditionally before mailing."
  :group 'message-mail
  :group 'message-headers
284
  :link '(custom-manual "(message)Mail Headers")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
285 286
  :type 'regexp)

287
(defcustom message-ignored-supersedes-headers "^Path:\\|^Date\\|^NNTP-Posting-Host:\\|^Xref:\\|^Lines:\\|^Received:\\|^X-From-Line:\\|^X-Trace:\\|^X-ID:\\|^X-Complaints-To:\\|Return-Path:\\|^Supersedes:\\|^NNTP-Posting-Date:\\|^X-Trace:\\|^X-Complaints-To:\\|^Cancel-Lock:\\|^Cancel-Key:\\|^X-Hashcash:\\|^X-Payment:\\|^Approved:\\|^Injection-Date:\\|^Injection-Info:"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
288 289 290 291
  "*Header lines matching this regexp will be deleted before posting.
It's best to delete old Path and Date headers before posting to avoid
any confusion."
  :group 'message-interface
292
  :link '(custom-manual "(message)Superseding")
293 294 295 296 297 298
  :type '(repeat :value-to-internal (lambda (widget value)
				      (custom-split-regexp-maybe value))
		 :match (lambda (widget value)
			  (or (stringp value)
			      (widget-editable-list-match widget value)))
		 regexp))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
299

300 301
(defcustom message-subject-re-regexp
  "^[ \t]*\\([Rr][Ee]\\(\\[[0-9]*\\]\\)*:[ \t]*\\)*[ \t]*"
302 303
  "*Regexp matching \"Re: \" in the subject line."
  :group 'message-various
304
  :link '(custom-manual "(message)Message Headers")
305 306
  :type 'regexp)

307 308 309 310 311 312 313 314 315 316
;;; Start of variables adopted from `message-utils.el'.

(defcustom message-subject-trailing-was-query 'ask
  "*What to do with trailing \"(was: <old subject>)\" in subject lines.
If nil, leave the subject unchanged.  If it is the symbol `ask', query
the user what do do.  In this case, the subject is matched against
`message-subject-trailing-was-ask-regexp'.  If
`message-subject-trailing-was-query' is t, always strip the trailing
old subject.  In this case, `message-subject-trailing-was-regexp' is
used."
317
  :version "22.1"
318 319
  :type '(choice (const :tag "never" nil)
		 (const :tag "always strip" t)
320
		 (const ask))
321 322 323 324 325 326 327 328 329 330 331 332 333
  :link '(custom-manual "(message)Message Headers")
  :group 'message-various)

(defcustom message-subject-trailing-was-ask-regexp
  "[ \t]*\\([[(]+[Ww][Aa][Ss][ \t]*.*[\])]+\\)"
  "*Regexp matching \"(was: <old subject>)\" in the subject line.

The function `message-strip-subject-trailing-was' uses this regexp if
`message-subject-trailing-was-query' is set to the symbol `ask'.  If
the variable is t instead of `ask', use
`message-subject-trailing-was-regexp' instead.

It is okay to create some false positives here, as the user is asked."
334
  :version "22.1"
335 336 337 338 339 340 341 342 343 344 345 346
  :group 'message-various
  :link '(custom-manual "(message)Message Headers")
  :type 'regexp)

(defcustom message-subject-trailing-was-regexp
  "[ \t]*\\((*[Ww][Aa][Ss]:[ \t]*.*)\\)"
  "*Regexp matching \"(was: <old subject>)\" in the subject line.

If `message-subject-trailing-was-query' is set to t, the subject is
matched against `message-subject-trailing-was-regexp' in
`message-strip-subject-trailing-was'.  You should use a regexp creating very
few false positives here."
347
  :version "22.1"
348 349 350 351 352 353 354
  :group 'message-various
  :link '(custom-manual "(message)Message Headers")
  :type 'regexp)

;;; marking inserted text

(defcustom message-mark-insert-begin
355
  "--8<---------------cut here---------------start------------->8---\n"
356
  "How to mark the beginning of some inserted text."
357
  :version "22.1"
358 359 360 361 362
  :type 'string
  :link '(custom-manual "(message)Insertion Variables")
  :group 'message-various)

(defcustom message-mark-insert-end
363
  "--8<---------------cut here---------------end--------------->8---\n"
364
  "How to mark the end of some inserted text."
365
  :version "22.1"
366 367 368 369
  :type 'string
  :link '(custom-manual "(message)Insertion Variables")
  :group 'message-various)

370
(defcustom message-archive-header "X-No-Archive: Yes\n"
371 372
  "Header to insert when you don't want your article to be archived.
Archives \(such as groups.google.com\) respect this header."
373
  :version "22.1"
374 375 376 377 378 379 380 381
  :type 'string
  :link '(custom-manual "(message)Header Commands")
  :group 'message-various)

(defcustom message-archive-note
  "X-No-Archive: Yes - save http://groups.google.com/"
  "Note to insert why you wouldn't want this posting archived.
If nil, don't insert any text in the body."
382
  :version "22.1"
383
  :type '(radio string (const nil))
384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399
  :link '(custom-manual "(message)Header Commands")
  :group 'message-various)

;;; Crossposts and Followups
;; inspired by JoH-followup-to by Jochem Huhman <joh  at gmx.de>
;; new suggestions by R. Weikusat <rw at another.de>

(defvar message-cross-post-old-target nil
  "Old target for cross-posts or follow-ups.")
(make-variable-buffer-local 'message-cross-post-old-target)

(defcustom message-cross-post-default t
  "When non-nil `message-cross-post-followup-to' will perform a crosspost.
If nil, `message-cross-post-followup-to' will only do a followup.  Note that
you can explicitly override this setting by calling
`message-cross-post-followup-to' with a prefix."
400
  :version "22.1"
401 402 403
  :type 'boolean
  :group 'message-various)

404
(defcustom message-cross-post-note "Crosspost & Followup-To: "
405
  "Note to insert before signature to notify of cross-post and follow-up."
406
  :version "22.1"
407 408 409
  :type 'string
  :group 'message-various)

410
(defcustom message-followup-to-note "Followup-To: "
411
  "Note to insert before signature to notify of follow-up only."
412
  :version "22.1"
413 414 415
  :type 'string
  :group 'message-various)

416
(defcustom message-cross-post-note-function 'message-cross-post-insert-note
417 418 419 420
  "Function to use to insert note about Crosspost or Followup-To.
The function will be called with four arguments.  The function should not only
insert a note, but also ensure old notes are deleted.  See the documentation
for `message-cross-post-insert-note'."
421
  :version "22.1"
422 423 424 425 426
  :type 'function
  :group 'message-various)

;;; End of variables adopted from `message-utils.el'.

Miles Bader's avatar
Miles Bader committed
427 428 429 430 431 432 433 434 435 436
(defcustom message-signature-separator "^-- $"
  "Regexp matching the signature separator.
This variable is used to strip off the signature from quoted text
when `message-cite-function' is
`message-cite-original-without-signature'.  Most useful values
are \"^-- $\" (strict) and \"^-- *$\" (loose; allow missing
whitespace)."
  :type '(choice (const :tag "strict" "^-- $")
		 (const :tag "loose" "^-- *$")
		 regexp)
Miles Bader's avatar
Miles Bader committed
437
  :version "22.3" ;; Gnus 5.10.12 (changed default)
438
  :link '(custom-manual "(message)Various Message Variables")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
439 440
  :group 'message-various)

441
(defcustom message-elide-ellipsis "\n[...]\n\n"
442 443
  "*The string which is inserted for elided text."
  :type 'string
444
  :link '(custom-manual "(message)Various Commands")
445
  :group 'message-various)
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
446

447
(defcustom message-interactive mail-interactive
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
448
  "Non-nil means when sending a message wait for and display errors.
Juanma Barranquero's avatar
Juanma Barranquero committed
449
A value of nil means let mailer mail back a message to report errors."
450
  :version "23.2"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
451 452
  :group 'message-sending
  :group 'message-mail
453
  :link '(custom-manual "(message)Sending Variables")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
454 455
  :type 'boolean)

Miles Bader's avatar
Miles Bader committed
456
(defcustom message-confirm-send nil
Miles Bader's avatar
Miles Bader committed
457
  "When non-nil, ask for confirmation when sending a message."
Miles Bader's avatar
Miles Bader committed
458 459
  :group 'message-sending
  :group 'message-mail
Miles Bader's avatar
Miles Bader committed
460
  :version "23.1" ;; No Gnus
Miles Bader's avatar
Miles Bader committed
461 462 463
  :link '(custom-manual "(message)Sending Variables")
  :type 'boolean)

464
(defcustom message-generate-new-buffers 'unsent
Miles Bader's avatar
Miles Bader committed
465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486
  "*Say whether to create a new message buffer to compose a message.
Valid values include:

nil
  Generate the buffer name in the Message way (e.g., *mail*, *news*,
  *mail to whom*, *news on group*, etc.) and continue editing in the
  existing buffer of that name.  If there is no such buffer, it will
  be newly created.

`unique' or t
  Create the new buffer with the name generated in the Message way.

`unsent'
  Similar to `unique' but the buffer name begins with \"*unsent \".

`standard'
  Similar to nil but the buffer name is simpler like *mail message*.

function
  If this is a function, call that function with three parameters:
  The type, the To address and the group name (any of these may be nil).
  The function should return the new buffer name."
487
  :version "24.1"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
488
  :group 'message-buffers
489
  :link '(custom-manual "(message)Message Buffers")
Miles Bader's avatar
Miles Bader committed
490 491 492 493 494 495
  :type '(choice (const nil)
		 (sexp :tag "unique" :format "unique\n" :value unique
		       :match (lambda (widget value) (memq value '(unique t))))
		 (const unsent)
		 (const standard)
		 (function :format "\n    %{%t%}: %v")))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
496 497 498 499

(defcustom message-kill-buffer-on-exit nil
  "*Non-nil means that the message buffer will be killed after sending a message."
  :group 'message-buffers
500
  :link '(custom-manual "(message)Message Buffers")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
501 502
  :type 'boolean)

503 504 505
(defcustom message-kill-buffer-query t
  "*Non-nil means that killing a modified message buffer has to be confirmed.
This is used by `message-kill-buffer'."
506
  :version "23.1" ;; No Gnus
507 508 509
  :group 'message-buffers
  :type 'boolean)

Dan Nicolaescu's avatar
Dan Nicolaescu committed
510
(defvar gnus-local-organization)
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
511 512 513 514 515 516 517 518 519 520 521 522
(defcustom message-user-organization
  (or (and (boundp 'gnus-local-organization)
	   (stringp gnus-local-organization)
	   gnus-local-organization)
      (getenv "ORGANIZATION")
      t)
  "*String to be used as an Organization header.
If t, use `message-user-organization-file'."
  :group 'message-headers
  :type '(choice string
		 (const :tag "consult file" t)))

523 524 525 526 527 528 529 530
(defcustom message-user-organization-file
  (let (orgfile)
    (dolist (f (list "/etc/organization"
		     "/etc/news/organization"
		     "/usr/lib/news/organization"))
      (when (file-readable-p f)
	(setq orgfile f)))
    orgfile)
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
531 532
  "*Local news organization file."
  :type 'file
533
  :link '(custom-manual "(message)News Headers")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
534 535
  :group 'message-headers)

536
(defcustom message-make-forward-subject-function
537
  #'message-forward-subject-name-subject
Dave Love's avatar
Dave Love committed
538
  "*List of functions called to generate subject headers for forwarded messages.
539 540 541 542 543
The subject generated by the previous function is passed into each
successive function.

The provided functions are:

544 545 546 547 548
* `message-forward-subject-author-subject' Source of article (author or
      newsgroup), in brackets followed by the subject
* `message-forward-subject-name-subject' Source of article (name of author
      or newsgroup), in brackets followed by the subject
* `message-forward-subject-fwd' Subject of article with 'Fwd:' prepended
549
      to it."
550
  :group 'message-forwarding
551
  :link '(custom-manual "(message)Forwarding")
552
  :type '(radio (function-item message-forward-subject-author-subject)
Dave Love's avatar
Dave Love committed
553
		(function-item message-forward-subject-fwd)
554
		(function-item message-forward-subject-name-subject)
Dave Love's avatar
Dave Love committed
555
		(repeat :tag "List of functions" function)))
556 557

(defcustom message-forward-as-mime t
558 559
  "*Non-nil means forward messages as an inline/rfc822 MIME section.
Otherwise, directly inline the old message in the forwarded message."
560
  :version "21.1"
561
  :group 'message-forwarding
562
  :link '(custom-manual "(message)Forwarding")
563 564
  :type 'boolean)

565 566 567 568 569 570 571 572
(defcustom message-forward-show-mml 'best
  "*Non-nil means show forwarded messages as MML (decoded from MIME).
Otherwise, forwarded messages are unchanged.
Can also be the symbol `best' to indicate that MML should be
used, except when it is a bad idea to use MML.  One example where
it is a bad idea is when forwarding a signed or encrypted
message, because converting MIME to MML would invalidate the
digital signature."
573
  :version "21.1"
574
  :group 'message-forwarding
575 576 577
  :type '(choice (const :tag "use MML" t)
		 (const :tag "don't use MML " nil)
		 (const :tag "use MML when appropriate" best)))
578 579

(defcustom message-forward-before-signature t
580
  "*Non-nil means put forwarded message before signature, else after."
581 582
  :group 'message-forwarding
  :type 'boolean)
583 584

(defcustom message-wash-forwarded-subjects nil
585 586
  "*Non-nil means try to remove as much cruft as possible from the subject.
Done before generating the new subject of a forward."
587
  :group 'message-forwarding
588
  :link '(custom-manual "(message)Forwarding")
589 590
  :type 'boolean)

591 592 593 594 595 596 597
(defcustom message-ignored-resent-headers
  ;; `Delivered-To' needs to be removed because some mailers use it to
  ;; detect loops, so if you resend a message to an address that ultimately
  ;; comes back to you (e.g. a mailing-list to which you subscribe, in which
  ;; case you may be removed from the list on the grounds that mail to you
  ;; bounced with a "mailing loop" error).
  "^Return-receipt\\|^X-Gnus\\|^Gnus-Warning:\\|^>?From \\|^Delivered-To:"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
598 599
  "*All headers that match this regexp will be deleted when resending a message."
  :group 'message-interface
600
  :link '(custom-manual "(message)Resending")
601 602 603 604 605 606
  :type '(repeat :value-to-internal (lambda (widget value)
				      (custom-split-regexp-maybe value))
		 :match (lambda (widget value)
			  (or (stringp value)
			      (widget-editable-list-match widget value)))
		 regexp))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
607

608 609
(defcustom message-forward-ignored-headers "^Content-Transfer-Encoding:\\|^X-Gnus"
  "*All headers that match this regexp will be deleted when forwarding a message."
610
  :version "21.1"
611
  :group 'message-forwarding
612 613 614 615 616
  :type '(repeat :value-to-internal (lambda (widget value)
				      (custom-split-regexp-maybe value))
		 :match (lambda (widget value)
			  (or (stringp value)
			      (widget-editable-list-match widget value)))
617 618
		 regexp))

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
619 620 621
(defcustom message-ignored-cited-headers "."
  "*Delete these headers from the messages you yank."
  :group 'message-insertion
622 623 624
  :link '(custom-manual "(message)Insertion Variables")
  :type 'regexp)

625
(defcustom message-cite-prefix-regexp mail-citation-prefix-regexp
626
  "*Regexp matching the longest possible citation prefix on a line."
627
  :version "24.1"
628 629
  :group 'message-insertion
  :link '(custom-manual "(message)Insertion Variables")
630 631 632 633 634 635 636
  :type 'regexp
  :set (lambda (symbol value)
	 (prog1
	     (custom-set-default symbol value)
	   (if (boundp 'gnus-message-cite-prefix-regexp)
	       (setq gnus-message-cite-prefix-regexp
		     (concat "^\\(?:" value "\\)"))))))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
637

638
(defcustom message-cancel-message "I am canceling my own article.\n"
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
639 640
  "Message to be inserted in the cancel message."
  :group 'message-interface
641
  :link '(custom-manual "(message)Canceling News")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
642 643
  :type 'string)

644 645
(defun message-send-mail-function ()
  "Return suitable value for the variable `message-send-mail-function'."
646 647 648
  (cond ((and (require 'sendmail)
	      (boundp 'sendmail-program)
	      sendmail-program
649
	      (executable-find sendmail-program))
650
	 'message-send-mail-with-sendmail)
651
	((and (locate-library "smtpmail")
652
	      (boundp 'smtpmail-default-smtp-server)
653 654 655
	      smtpmail-default-smtp-server)
	 'message-smtpmail-send-it)
	((locate-library "mailclient")
656 657
	 'message-send-mail-with-mailclient)
	(t
658
	 (error "Don't know how to send mail.  Please customize `message-send-mail-function'"))))
659

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
660
;; Useful to set in site-init.el
Glenn Morris's avatar
Glenn Morris committed
661 662 663 664 665 666
(defcustom message-send-mail-function
  (cond ((eq send-mail-function 'smtpmail-send-it) 'message-smtpmail-send-it)
	((eq send-mail-function 'feedmail-send-it) 'feedmail-send-it)
	((eq send-mail-function 'mailclient-send-it)
	 'message-send-mail-with-mailclient)
	(t (message-send-mail-function)))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
667 668 669 670
  "Function to call to send the current buffer as mail.
The headers should be delimited by a line whose contents match the
variable `mail-header-separator'.

671
Valid values include `message-send-mail-with-sendmail'
Dave Love's avatar
Dave Love committed
672
`message-send-mail-with-mh', `message-send-mail-with-qmail',
673 674
`message-smtpmail-send-it', `smtpmail-send-it',
`feedmail-send-it' and `message-send-mail-with-mailclient'.  The
Miles Bader's avatar
Miles Bader committed
675 676
default is system dependent and determined by the function
`message-send-mail-function'.
Dave Love's avatar
Dave Love committed
677 678

See also `send-mail-function'."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
679 680 681
  :type '(radio (function-item message-send-mail-with-sendmail)
		(function-item message-send-mail-with-mh)
		(function-item message-send-mail-with-qmail)
682
		(function-item message-smtpmail-send-it)
683
		(function-item smtpmail-send-it)
Dave Love's avatar
Dave Love committed
684
		(function-item feedmail-send-it)
685 686 687
		(function-item message-send-mail-with-mailclient
			       :tag "Use Mailclient package")
 		(function :tag "Other"))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
688
  :group 'message-sending
Glenn Morris's avatar
Glenn Morris committed
689
  :version "23.2"
690
  :initialize 'custom-initialize-default
691
  :link '(custom-manual "(message)Mail Variables")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
692 693 694 695 696 697 698 699
  :group 'message-mail)

(defcustom message-send-news-function 'message-send-news
  "Function to call to send the current buffer as news.
The headers should be delimited by a line whose contents match the
variable `mail-header-separator'."
  :group 'message-sending
  :group 'message-news
700
  :link '(custom-manual "(message)News Variables")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
701 702 703
  :type 'function)

(defcustom message-reply-to-function nil
Dave Love's avatar
Dave Love committed
704
  "If non-nil, function that should return a list of headers.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
705 706 707
This function should pick out addresses from the To, Cc, and From headers
and respond with new To and Cc headers."
  :group 'message-interface
708
  :link '(custom-manual "(message)Reply")
Dave Love's avatar
Dave Love committed
709
  :type '(choice function (const nil)))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
710 711

(defcustom message-wide-reply-to-function nil
Dave Love's avatar
Dave Love committed
712
  "If non-nil, function that should return a list of headers.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
713 714 715
This function should pick out addresses from the To, Cc, and From headers
and respond with new To and Cc headers."
  :group 'message-interface
716
  :link '(custom-manual "(message)Wide Reply")
Dave Love's avatar
Dave Love committed
717
  :type '(choice function (const nil)))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
718 719

(defcustom message-followup-to-function nil
Dave Love's avatar
Dave Love committed
720
  "If non-nil, function that should return a list of headers.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
721 722 723
This function should pick out addresses from the To, Cc, and From headers
and respond with new To and Cc headers."
  :group 'message-interface
724
  :link '(custom-manual "(message)Followup")
Dave Love's avatar
Dave Love committed
725
  :type '(choice function (const nil)))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
726

727 728 729 730 731 732
(defcustom message-extra-wide-headers nil
  "If non-nil, a list of additional address headers.
These are used when composing a wide reply."
  :group 'message-sending
  :type '(repeat string))

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
733 734 735 736 737 738 739
(defcustom message-use-followup-to 'ask
  "*Specifies what to do with Followup-To header.
If nil, always ignore the header.  If it is t, use its value, but
query before using the \"poster\" value.  If it is the symbol `ask',
always query the user whether to use the value.  If it is the symbol
`use', always use the value."
  :group 'message-interface
740
  :link '(custom-manual "(message)Followup")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
741
  :type '(choice (const :tag "ignore" nil)
742
		 (const :tag "use & query" t)
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
743 744 745
		 (const use)
		 (const ask)))

746 747 748 749 750
(defcustom message-use-mail-followup-to 'use
  "*Specifies what to do with Mail-Followup-To header.
If nil, always ignore the header.  If it is the symbol `ask', always
query the user whether to use the value.  If it is the symbol `use',
always use the value."
751
  :version "22.1"
752 753 754 755 756 757 758 759 760 761 762 763 764
  :group 'message-interface
  :link '(custom-manual "(message)Mailing Lists")
  :type '(choice (const :tag "ignore" nil)
		 (const use)
		 (const ask)))

(defcustom message-subscribed-address-functions nil
  "*Specifies functions for determining list subscription.
If nil, do not attempt to determine list subscription with functions.
If non-nil, this variable contains a list of functions which return
regular expressions to match lists.  These functions can be used in
conjunction with `message-subscribed-regexps' and
`message-subscribed-addresses'."
765
  :version "22.1"
766 767 768 769 770 771 772 773
  :group 'message-interface
  :link '(custom-manual "(message)Mailing Lists")
  :type '(repeat sexp))

(defcustom message-subscribed-address-file nil
  "*A file containing addresses the user is subscribed to.
If nil, do not look at any files to determine list subscriptions.  If
non-nil, each line of this file should be a mailing list address."
774
  :version "22.1"
775 776
  :group 'message-interface
  :link '(custom-manual "(message)Mailing Lists")
777
  :type '(radio file (const nil)))
778 779 780 781 782 783

(defcustom message-subscribed-addresses nil
  "*Specifies a list of addresses the user is subscribed to.
If nil, do not use any predefined list subscriptions.  This list of
addresses can be used in conjunction with
`message-subscribed-address-functions' and `message-subscribed-regexps'."
784
  :version "22.1"
785 786 787 788 789 790 791 792 793
  :group 'message-interface
  :link '(custom-manual "(message)Mailing Lists")
  :type '(repeat string))

(defcustom message-subscribed-regexps nil
  "*Specifies a list of addresses the user is subscribed to.
If nil, do not use any predefined list subscriptions.  This list of
regular expressions can be used in conjunction with
`message-subscribed-address-functions' and `message-subscribed-addresses'."
794
  :version "22.1"
795 796 797 798 799 800 801 802 803
  :group 'message-interface
  :link '(custom-manual "(message)Mailing Lists")
  :type '(repeat regexp))

(defcustom message-allow-no-recipients 'ask
  "Specifies what to do when there are no recipients other than Gcc/Fcc.
If it is the symbol `always', the posting is allowed.  If it is the
symbol `never', the posting is not allowed.  If it is the symbol
`ask', you are prompted."
804
  :version "22.1"
805 806 807 808 809 810
  :group 'message-interface
  :link '(custom-manual "(message)Message Headers")
  :type '(choice (const always)
		 (const never)
		 (const ask)))

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
811
(defcustom message-sendmail-f-is-evil nil
Dave Love's avatar
Dave Love committed
812
  "*Non-nil means don't add \"-f username\" to the sendmail command line.
813
Doing so would be even more evil than leaving it out."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
814
  :group 'message-sending
815
  :link '(custom-manual "(message)Mail Variables")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
816 817
  :type 'boolean)

818
(defcustom message-sendmail-envelope-from
819
  ;; `mail-envelope-from' is unavailable unless sendmail.el is loaded.
820
  (if (boundp 'mail-envelope-from) mail-envelope-from)
821 822 823
  "*Envelope-from when sending mail with sendmail.
If this is nil, use `user-mail-address'.  If it is the symbol
`header', use the From: header of the message."
824
  :version "23.2"
825 826 827 828 829 830
  :type '(choice (string :tag "From name")
		 (const :tag "Use From: header from message" header)
		 (const :tag "Use `user-mail-address'" nil))
  :link '(custom-manual "(message)Mail Variables")
  :group 'message-sending)

831 832 833
(defcustom message-sendmail-extra-arguments nil
  "Additional arguments to `sendmail-program'."
  ;; E.g. '("-a" "account") for msmtp
834
  :version "23.1" ;; No Gnus
835 836 837 838
  :type '(repeat string)
  ;; :link '(custom-manual "(message)Mail Variables")
  :group 'message-sending)

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
839 840 841 842
;; qmail-related stuff
(defcustom message-qmail-inject-program "/var/qmail/bin/qmail-inject"
  "Location of the qmail-inject program."
  :group 'message-sending
843
  :link '(custom-manual "(message)Mail Variables")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
844 845 846 847
  :type 'file)

(defcustom message-qmail-inject-args nil
  "Arguments passed to qmail-inject programs.
Juanma Barranquero's avatar
Juanma Barranquero committed
848 849
This should be a list of strings, one string for each argument.
It may also be a function.
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
850 851 852 853 854

For e.g., if you wish to set the envelope sender address so that bounces
go to the right place or to deal with listserv's usage of that address, you
might set this variable to '(\"-f\" \"you@some.where\")."
  :group 'message-sending
855 856 857
  :link '(custom-manual "(message)Mail Variables")
  :type '(choice (function)
		 (repeat string)))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
858

Dan Nicolaescu's avatar
Dan Nicolaescu committed
859 860
(defvar gnus-post-method)
(defvar gnus-select-method)
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
861 862
(defcustom message-post-method
  (cond ((and (boundp 'gnus-post-method)
863
	      (listp gnus-post-method)
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
864 865 866 867 868
	      gnus-post-method)
	 gnus-post-method)
	((boundp 'gnus-select-method)
	 gnus-select-method)
	(t '(nnspool "")))
869 870 871
  "*Method used to post news.
Note that when posting from inside Gnus, for instance, this
variable isn't used."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
872 873 874 875 876 877
  :group 'message-news
  :group 'message-sending
  ;; This should be the `gnus-select-method' widget, but that might
  ;; create a dependence to `gnus.el'.
  :type 'sexp)

878 879 880 881 882 883
;; FIXME: This should be a temporary workaround until someone implements a
;; proper solution.  If a crash happens while replying, the auto-save file
;; will *not* have a `References:' header if `message-generate-headers-first'
;; is nil.  See: http://article.gmane.org/gmane.emacs.gnus.general/51138
(defcustom message-generate-headers-first '(references)
  "Which headers should be generated before starting to compose a message.
884
If t, generate all required headers.  This can also be a list of headers to
885 886 887 888 889 890
generate.  The variables `message-required-news-headers' and
`message-required-mail-headers' specify which headers to generate.

Note that the variable `message-deletable-headers' specifies headers which
are to be deleted and then re-generated before sending, so this variable
will not have a visible effect for those headers."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
891
  :group 'message-headers
892 893
  :link '(custom-manual "(message)Message Headers")
  :type '(choice (const :tag "None" nil)
894 895 896 897 898 899 900 901 902 903 904 905
		 (const :tag "References" '(references))
		 (const :tag "All" t)
		 (repeat (sexp :tag "Header"))))

(defcustom message-fill-column 72
  "Column beyond which automatic line-wrapping should happen.
Local value for message buffers.  If non-nil, also turn on
auto-fill in message buffers."
  :group 'message-various
  ;; :link '(custom-manual "(message)Message Headers")
  :type '(choice (const :tag "Don't turn on auto fill" nil)
		 (integer)))
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
906

907 908 909 910 911 912
(defcustom message-setup-hook nil
  "Normal hook, run each time a new outgoing message is initialized.
The function `message-setup' runs this hook."
  :group 'message-various
  :link '(custom-manual "(message)Various Message Variables")
  :type 'hook)
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
913

914 915 916
(defcustom message-cancel-hook nil
  "Hook run when cancelling articles."
  :group 'message-various
917
  :link '(custom-manual "(message)Various Message Variables")
918 919
  :type 'hook)

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
920 921 922 923 924
(defcustom message-signature-setup-hook nil
  "Normal hook, run each time a new outgoing message is initialized.
It is run after the headers have been inserted and before
the signature is inserted."
  :group 'message-various
925
  :link '(custom-manual "(message)Various Message Variables")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
926 927 928 929 930 931 932 933 934 935 936 937 938
  :type 'hook)

(defcustom message-mode-hook nil
  "Hook run in message mode buffers."
  :group 'message-various
  :type 'hook)

(defcustom message-header-hook nil
  "Hook run in a message mode buffer narrowed to the headers."
  :group 'message-various
  :type 'hook)

(defcustom message-header-setup-hook nil
939
  "Hook called narrowed to the headers when setting up a message buffer."
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
940
  :group 'message-various
941
  :link '(custom-manual "(message)Various Message Variables")
Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
942 943
  :type 'hook)

944 945 946 947
(defcustom message-minibuffer-local-map
  (let ((map (make-sparse-keymap 'message-minibuffer-local-map)))
    (set-keymap-parent map minibuffer-local-map)
    map)
948
  "Keymap for `message-read-from-minibuffer'."
949 950
  :version "22.1"
  :group 'message-various)
951

Lars Magne Ingebrigtsen's avatar
Lars Magne Ingebrigtsen committed
952
(defcustom message-citation-line-function 'message-insert-citation-line
953 954
  "*Function called to insert the \"Whomever writes:\" line.

955
Predefined functions include `message-insert-citation-line' and
Miles Bader's avatar
Miles Bader committed
956
`message-insert-formatted-citation-line' (see the variable
957 958
`message-citation-line-format').

959