git.cworth.org Git - notmuch-wiki/blob - bugs.mdwn

   1 [[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
   2 # Troubleshooting and Bug reporting
   3
   4 ## Deciding what level the problem lives at
   5
   6 If you are experiencing a crash or very slow performance with a
   7 particular query, please try it on the command line using "notmuch
   8 search" or "notmuch show"; it's easier for us to debug if the problem
   9 is there, and it's useful to know if the problem is introduced by a
  10 front end.
  11
  12 ## Troubleshooting the Emacs interface
  13
  14 It's very easy for Emacs packages to interfere with each other. For
  15 this reason we ask you to try and find the problem with only notmuch
  16 loaded.  You can do this with
  17
  18     emacs -Q -L /path/to/your/notmuch/lisp --eval "(require 'notmuch)"
  19
  20 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.
  21
  22     M-x notmuch
  23
  24 or
  25
  26     M-x notmuch-mua-mail
  27
  28 ## Bug and patch tracking
  29
  30 Bug reports should be sent to the Notmuch mailing list notmuch@notmuchmail.org.
  31
  32 Bugs are tracked using a collaborative tagging tool call [[nmbug]].
  33 If you submit lots of bugs and/or patches, you may want become
  34 involved with this tagging process, but feel free to just send mail to
  35 the list; someone will tag messages appropriately.  The status of bugs
  36 and current patches can also be followed
  37 [online](http://nmbug.tethera.net/status).
  38
  39
  40