emacs: drop setting mail-user-agent, and document how to set it

After some discussion [1], I decided it is better to make notmuch users
who rely on this behaviour customize mail-user-agent. This is
consistent with the behaviour of other emacs mail packages.

[1]: id:87k0nuhfrk.fsf@toryanderson.com

diff --git a/NEWS b/NEWS
index 35b57cefc2ff7eb592a4dee1928504cb8005da1f..538ec168baaef0a16b666f39856312e856225020 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,6 +1,13 @@
 Notmuch 0.33 (UNRELEASED)
 =========================
 
+Emacs
+-----
+
+`notmuch` no longer sets `mail-user-agent` on load. To restore the
+previous behaviour of using notmuch to send mail by default, customize
+`mail-user-agent` to `notmuch-user-agent`.
+
 Vim
 ---
 

diff --git a/doc/notmuch-emacs.rst b/doc/notmuch-emacs.rst
index d9b497a3e8ad079412e59a1675a40763d5873102..7772871b3eba99b696b51e5979a33c85c08bec85 100644 (file)
--- a/doc/notmuch-emacs.rst
+++ b/doc/notmuch-emacs.rst
@@ -366,6 +366,16 @@ Importing Mail
 :index:`notmuch-poll-script`
    |docstring::notmuch-poll-script|
 
+Sending Mail
+------------
+
+:index:`mail-user-agent`
+
+       Emacs consults the variable :ref:`mail-user-agent` to choose a mail
+       sending package for commands like :ref:`report-emacs-bug` and
+       :ref:`compose-mail`.  To use ``notmuch`` for this, customize this
+       variable to the symbol :ref:`notmuch-user-agent`.
+
 Init File
 ---------
 

diff --git a/emacs/notmuch.el b/emacs/notmuch.el
index 6d37c623e6597cb4f43c0d6029b2f9502f93c89f..3e2713e231290b2d80c4f7a35d7587cc437a79dc 100644 (file)
--- a/emacs/notmuch.el
+++ b/emacs/notmuch.el
@@ -1162,8 +1162,6 @@ Point should be at the beginning of the line."
 
 ;;; _
 
-(setq mail-user-agent 'notmuch-user-agent)
-
 (provide 'notmuch)
 
 ;; After provide to avoid loops if notmuch was require'd via notmuch-init-file.