# Notmuch Emacs Interface
One of the more popular Notmuch message reading clients is **notmuch.el**, or
-`notmuch-emacs`, an [emacs](http://www.gnu.org/software/emacs/) major mode for
+`notmuch-emacs`, an [Emacs](http://www.gnu.org/software/emacs/) major mode for
interacting with Notmuch. It is included in the Notmuch package (`notmuch-emacs`
-in Debian).
+in Debian). The [[screenshots|screenshots]] give a good overview of the mode.
This page is a basic guide for setting up and using Notmuch with Emacs. See also
the [[tips and tricks page|emacstips]] for more advanced details.
## Setup
Have a look at the [[Howto|howto]] for prerequisites. Be sure you have done the
-general setup using the notmuch cli command!
+general setup using the Notmuch cli command!
-To use the Notmuch emacs mode, first add the following line to your `.emacs` rc
+To use the Notmuch Emacs mode, first add the following line to your `.emacs` rc
file:
(autoload 'notmuch "notmuch" "notmuch mail" t)
-or if you always want to load notmuch when you start emacs:
+or if you always want to load Notmuch when you start Emacs:
(require 'notmuch)
Then, either run `emacs -f notmuch`, or execute the command `M-x notmuch` from
-within a running emacs.
+within a running Emacs.
### <span id="notmuch_init_file"> Notmuch Emacs configuration file: </span>
(Since Notmuch 0.18)
-After notmuch is loaded `notmuch-init-file` (typically
+After Notmuch is loaded `notmuch-init-file` (typically
`~/.emacs.d/notmuch-config.el`) is checked out. If such file exists
-it is loaded. Most emacs lisp based configuration not suitable via
+it is loaded. Most Emacs lisp based configuration not suitable via
customization can be put there instead of `~/.emacs`.
## Navigating & reading mails
-When first starting notmuch in emacs, you will be presented with the
-notmuch "hello" page. If it exits with an error after writing
-"Welcome to notmutch. You have" you need to do the basic notmuch setup
+When first starting Notmuch in Emacs, you will be presented with the
+Notmuch "hello" page. If it exits with an error after writing
+"Welcome to notmuch. 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.
represents a message thread. Hitting the '?' key will show help for
this mode.
-In general, the 'q' will kill the current notmuch buffer and return
+In general, the 'q' will kill the current Notmuch buffer and return
you to the previous buffer (sort of like a 'pop').
In search mode, navigating to a thread and hitting return will then
## Sending mail
-In any notmuch mode, you can start a new message by hitting the 'm'
+In any Notmuch mode, you can start a new message by hitting the 'm'
key. To reply to a message or thread, just hit the 'r' key.
-When composing new messages, you will be entered in emacs's
+When composing new messages, you will be entered in Emacs's
`message-mode`, which is a powerful mode for composing and sending
messages. When in message mode, you can type `C-c ?` for help.
When you are ready to send a message, type `C-c C-c`. By default
message mode will use your sendmail command to send mail, so make sure
that works. One annoying standard configuration of message mode is
-that it will hide the sent mail in your emacs frame stack, but it will
-not close it. If you type several mails in an emacs session they will
+that it will hide the sent mail in your Emacs frame stack, but it will
+not close it. If you type several mails in an Emacs session they will
accumulate and make switching between buffers more annoying. You can
avoid that behavior by adding `(setq message-kill-buffer-on-exit t)`
in your `.emacs` file
if files are dragged from the file manager.
And for those who prefer working from command line, the following
-script opens new emacs window with empty message and attaches files
+script opens new Emacs window with empty message and attaches files
mentioned as script arguments. (Note: The script expects that you have
`(server-start)` in your `.emacs` file.)