NEWS for version 0.23.6

[notmuch-wiki] / bugs.mdwn

diff --git a/bugs.mdwn b/bugs.mdwn
index 0331997691e320a495ef1db96bd9b7a0faa1229c..d1b6d5f1702ce818d3011b22c138e82976794509 100644 (file)
--- a/bugs.mdwn
+++ b/bugs.mdwn
@@ -1,5 +1,7 @@
 [[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
 [[!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
 
 
 ## 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
 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](http://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)))