From d042d8be898ad2df572273bf72ae551728d023e1 Mon Sep 17 00:00:00 2001
From: djcb <djcb@djcbsoftware.nl>
Date: Tue, 23 Sep 2014 07:52:15 +0300
Subject: [PATCH] Document that mu4e-maildir must not be a symlink ('fixes'
 #453)

mu doesn't support symlinks; document this. You can use hardlinks
instead of course.
---
 mu4e/mu4e-vars.el | 3 ++-
 mu4e/mu4e.texi    | 6 ++++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/mu4e/mu4e-vars.el b/mu4e/mu4e-vars.el
index 2e9962b4..ea4c9048 100644
--- a/mu4e/mu4e-vars.el
+++ b/mu4e/mu4e-vars.el
@@ -49,7 +49,8 @@ path."
   :safe 'stringp)
 
 (defcustom mu4e-maildir (expand-file-name "~/Maildir")
-  "The file system path to your Maildir."
+  "The file system path to your Maildir. Must not be a symbolic
+link."
   :type 'directory
   :safe 'stringp
   :group 'mu4e)
diff --git a/mu4e/mu4e.texi b/mu4e/mu4e.texi
index 323e1e23..de8046aa 100644
--- a/mu4e/mu4e.texi
+++ b/mu4e/mu4e.texi
@@ -444,8 +444,9 @@ runtime. This allows for dynamically changing them depending on context. See
     mu4e-refile-folder "/archive")   ;; saved messages
 @end lisp
 
-Note, @code{mu4e-maildir} takes an actual filesystem-path, the other folder
-names are all relative to @code{mu4e-maildir}.
+Note, @code{mu4e-maildir} takes an actual filesystem-path, the other
+folder names are all relative to @code{mu4e-maildir}. Also note that
+this must @emph{not} be a symbolic link.
 
 @node Retrieval and indexing
 @section Retrieval and indexing
@@ -2675,6 +2676,7 @@ see most is commented-out.
 (require 'mu4e)
 
 ;; Only needed if your maildir is _not_ ~/Maildir
+;; Must be a real dir, not a symlink
 ;;(setq mu4e-maildir "/home/user/Maildir")
 
 ;; these must start with a "/", and must exist