One of the more popular notmuch message reading clients is
**notmuch.el**, an [emacs](http://www.gnu.org/software/emacs/) major
mode for interacting with notmuch. It is included in the notmuch
-package. This page goes over some usage tips for using notmuch with
-Emacs.
+package (notmuch-emacs in Debian). This page goes over some usage
+tips for using notmuch with Emacs.
[[!toc levels=2]]
## Setup
+Have a look at the [Howto](http://notmuchmail.org/howto/) for
+prerequisites. Be sure you have done the general setup using the
+notmuch cli command!
+
To use the Notmuch emacs mode, first add the following line to your
`.emacs` rc file:
## Navigating & reading mails
When first starting notmuch in emacs, you will be presented with the
-notmuch "hello" page. From here you can do searches, see lists of
-recent searches, saved searches, message tags, help information, etc.
+notmuch "hello" page. If it exits with an error after writing
+"Welcome to notmutch. You have" you need to do the basic notmuch setup
+first (see above).
+From here you can do searches, see lists of recent
+searches, saved searches, message tags, help information, etc.
Executing a search will open a new buffer in `notmuch-search-mode`
displaying the search results. Each line in the search results
Mailman mailing list software rewrites and rewraps long message subjects in
a way that causes TABs to appear in the middle of the subject and header
-lines. Add this to your .emacs to replace tabs with spaces in subject
+lines. Add this to your `.emacs` to replace tabs with spaces in subject
lines:
(defun notmuch-show-subject-tabs-to-spaces ()
(defun notmuch-show-header-tabs-to-spaces ()
"Replace tabs with spaces in header line."
(setq header-line-format
- (notmuch-show-strip-re
- (replace-regexp-in-string "\t" " " (notmuch-show-get-subject)))))
+ (notmuch-show-strip-re
+ (replace-regexp-in-string "\t" " " (notmuch-show-get-subject)))))
(add-hook 'notmuch-show-hook 'notmuch-show-header-tabs-to-spaces)