1 [[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
2 # Troubleshooting and Bug Reporting
6 ## Deciding what level the problem lives at
8 If you are experiencing a crash or very slow performance with a
9 particular query, please try it on the command line using "notmuch
10 search" or "notmuch show"; it's easier for us to debug if the problem
11 is there, and it's useful to know if the problem is introduced by a
14 ## Understanding the structure of a problematic message
17 [print-mime-structure](https://git.spwhitton.name/mailscripts/plain/email-print-mime-structure)
18 prints out the mime structure of an email message as a (text)
19 tree. This is usually safe to share and can help people understand
22 ## Troubleshooting the Emacs interface
24 It's very easy for Emacs packages to interfere with each other. For
25 this reason we ask you to try and find the problem with only notmuch
26 loaded. You can do this with
28 emacs -Q -L /path/to/your/notmuch/lisp --eval "(require 'notmuch)"
30 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.
38 ## Bug and patch tracking
40 Bug reports should be sent to the Notmuch mailing list notmuch@notmuchmail.org.
42 Bugs are tracked using a collaborative tagging tool call [[nmbug]].
43 If you submit lots of bugs and/or patches, you may want become
44 involved with this tagging process, but feel free to just send mail to
45 the list; someone will tag messages appropriately. The status of bugs
46 and current patches can also be followed
47 [online](https://nmbug.notmuchmail.org/status).
51 If a search doesn't seem to do what you want, you can enable query debugging to
52 print the Xapian queries the Notmuch library constructs by setting the
53 `NOTMUCH_DEBUG_QUERY` environment variable to a non-empty value.
57 $ NOTMUCH_DEBUG_QUERY=1 notmuch search big brown fox
63 Xapian::Query((Tmail AND Zbig:(pos=1) AND Zbrown:(pos=2) AND Zfox:(pos=3)))
65 ## Rescuing your tags.
67 If you're database is corrupt and you don't have a backup, a modified version of [xapian-check](https://git.xapian.org/?p=xapian;a=blob;f=README.notmuch;hb=refs/heads/notmuch-tag-rescue-hack) might still save your tags.