From effca34174925f2c3be9234b80adfc48c8d01603 Mon Sep 17 00:00:00 2001
From: djcb <djcb@djcbsoftware.nl>
Date: Thu, 19 Apr 2012 08:31:48 +0300
Subject: [PATCH] * add documentation for setting up mail-user-agent

---
 emacs/mu4e.texi | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/emacs/mu4e.texi b/emacs/mu4e.texi
index 3f58c246..5a9bb5f4 100644
--- a/emacs/mu4e.texi
+++ b/emacs/mu4e.texi
@@ -794,6 +794,11 @@ C-c C-w      insert signature
 C-c C-a      attach a file (pro-tip: drag & drop works as well)
 @end verbatim
 
+If you want use @t{mu4e} as the default program for sending mail, please see
+@ref{Setting the default emacs mail program}. With respect to sending mail,
+other interesting topics: @ref{Citations with mu-cite} and @ref{Maintaining an
+address-book with org-contacts}.
+
 @node Searching mail
 @chapter Searching mail
 
@@ -980,6 +985,7 @@ In this chapter we discuss some ways in ways in which @t{mu4e} can cooperate
 with other tools.
 
 @menu
+* Setting the default emacs mail program::
 * Creating org-mode links::
 * Maintaining an address-book with org-contacts::
 * Getting new mail notifications with Sauron::
@@ -987,6 +993,22 @@ with other tools.
 * Citations with mu-cite::
 @end menu
 
+@node Setting the default emacs mail program
+@section Setting the default emacs mail program
+
+@t{emacs} allows you to select an e-mail program as the default program it
+will use when you press @key{C-x m} (@code{compose-mail}), call
+@code{report-emacs-bug} and so on.
+
+If you want to use @t{mu4e} for this, you do so by adding the following to
+your configuration:
+
+@lisp
+(setq mail-user-agent 'mu4e-user-agent)
+@end lisp
+
+At the present time, support is still experimental.
+
 @node Creating org-mode links
 @section Creating org-mode links
 It can be useful to include links to e-mail messages or even search queries in