X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=bugs.mdwn;h=87948d61c1c565df6be9247410aeb138e98b6f56;hb=2e54b3e9e9faac1e0a7b3a10596a2ed8dc663bb1;hp=0331997691e320a495ef1db96bd9b7a0faa1229c;hpb=69d72fd1ebebcddf32cf3ca199efe214ce1f11c4;p=notmuch-wiki

diff --git a/bugs.mdwn b/bugs.mdwn
index 0331997..87948d6 100644
--- a/bugs.mdwn
+++ b/bugs.mdwn
@@ -1,5 +1,7 @@
 [[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
-# Troubleshooting and Bug reporting
+# Troubleshooting and Bug Reporting
+
+[[!toc levels=2]]
 
 ## Deciding what level the problem lives at
 
@@ -34,7 +36,20 @@ 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).
+[online](https://nmbug.notmuchmail.org/status).
+
+## Debugging Queries
 
+If a search doesn't seem to do what you want, you can enable query debugging to
+print the Xapian queries the Notmuch library constructs by setting the
+`NOTMUCH_DEBUG_QUERY` environment variable to a non-empty value.
 
+For example:
 
+        $ NOTMUCH_DEBUG_QUERY=1 notmuch search big brown fox
+        Query string is:
+        big brown fox
+        Exclude query is:
+        Xapian::Query()
+        Final query is:
+        Xapian::Query((Tmail AND Zbig:(pos=1) AND Zbrown:(pos=2) AND Zfox:(pos=3)))