Function: rmail-set-header

rmail-set-header is a byte-compiled function defined in rmail.el.gz.

Signature

(rmail-set-header NAME &optional MSGNUM VALUE)

Documentation

Set message header NAME to VALUE in message number MSGNUM.

If MSGNUM is nil, use the current message. NAME and VALUE are strings. VALUE may also be nil, meaning to remove the header.

Probably introduced at or before Emacs version 23.1.

Source Code

;; Defined in /usr/src/emacs/lisp/mail/rmail.el.gz
(defun rmail-set-header (name &optional msgnum value)
  "Set message header NAME to VALUE in message number MSGNUM.
If MSGNUM is nil, use the current message.  NAME and VALUE are strings.
VALUE may also be nil, meaning to remove the header."
  (rmail-apply-in-message msgnum 'rmail-set-header-1 name value)
  (with-current-buffer rmail-buffer
    ;; Ensure header changes get saved.
    ;; (Note replacing a header with an identical copy modifies.)
    (set-buffer-modified-p t)
    ;; However: don't save in mbox format over a Babyl file
    ;; merely because of this.
    (rmail-dont-modify-format)))