From: David Bremner <david@tethera.net>
Date: Sat, 28 Mar 2015 09:16:38 +0000 (+0100)
Subject: split off bug reporting info to it's own page
X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=commitdiff_plain;h=69d72fd1ebebcddf32cf3ca199efe214ce1f11c4

split off bug reporting info to it's own page
---

diff --git a/bugs.mdwn b/bugs.mdwn
new file mode 100644
index 0000000..0331997
--- /dev/null
+++ b/bugs.mdwn
@@ -0,0 +1,40 @@
+[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
+# Troubleshooting and Bug reporting
+
+## Deciding what level the problem lives at
+
+If you are experiencing a crash or very slow performance with a
+particular query, please try it on the command line using "notmuch
+search" or "notmuch show"; it's easier for us to debug if the problem
+is there, and it's useful to know if the problem is introduced by a
+front end.
+
+## Troubleshooting the Emacs interface
+
+It's very easy for Emacs packages to interfere with each other. For
+this reason we ask you to try and find the problem with only notmuch
+loaded.  You can do this with
+
+    emacs -Q -L /path/to/your/notmuch/lisp --eval "(require 'notmuch)"
+
+where `/path/to/your/notmuch/lisp` is either to the emacs directory in the source, or the installed (and possibly compiled) version installed by your package manager, e.g. `/usr/share/emacs/site-lisp/notmuch`.  After Emacs starts, run the command that is giving you trouble using e.g.
+
+    M-x notmuch
+
+or
+
+    M-x notmuch-mua-mail
+
+## Bug and patch tracking
+
+Bug reports should be sent to the Notmuch mailing list notmuch@notmuchmail.org.
+
+Bugs are tracked using a collaborative tagging tool call [[nmbug]].
+If you submit lots of bugs and/or patches, you may want become
+involved with this tagging process, but feel free to just send mail to
+the list; someone will tag messages appropriately.  The status of bugs
+and current patches can also be followed
+[online](http://nmbug.tethera.net/status).
+
+
+
diff --git a/index.mdwn b/index.mdwn
index 29c1ae5..742f482 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -123,15 +123,11 @@ its
 Contributions, such as patches, to Notmuch are most welcome. Please refer to the
 [[guide to contributing|contributing]].
 
-## Bug and patch tracking
+## Troubleshooting and reporting bugs
 
-The tagging and filtering features of notmuch make it quite suitable
-for use as a bug- and patch-tracker. We are currently experimenting
-with using it for this purpose for notmuch development, using a
-utility called [[nmbug]]. The status of bugs and current patches can also be
-followed [online](http://nmbug.tethera.net/status).
+For hints about troubleshooting and bug reporting see [[bugs]].
 
-Bug reports should be sent to the Notmuch mailing list notmuch@notmuchmail.org.
+For a list of known bugs see the [[nmbug status page|http://nmbug.tethera.net/status/#Bugs]]
 
 ## Contact: Email & IRC