getting-started: on message delivery

[notmuch-wiki] / getting-started.mdwn

diff --git a/getting-started.mdwn b/getting-started.mdwn
index 0482abd6cfce823d31a17c944e319150dc982e87..fac7d8fa08b6db073a55182e760520e0696efa70 100644 (file)
--- a/getting-started.mdwn
+++ b/getting-started.mdwn
@@ -8,6 +8,9 @@
 This is your friendly guide and tutorial to getting started with Notmuch. It
 will help you through the first steps of setting up Notmuch.
 
+All Notmuch commands have [[manual pages|manpages]]. Please refer to them for
+details.
+
 ## Prerequisites
 
 In order to use Notmuch, you will need to have your email messages stored in
@@ -68,8 +71,30 @@ interface|manpages]], or [[Notmuch Emacs interface|notmuch-emacs]].
 
 ## Delivering New Messages
 
+Notmuch itself does not receive messages. There is no IMAP or POP support. You
+will need to set up other tools, such as fetchmail, offlineimap, or mbsync, to
+receive the messages.
+
+There is two ways to deliver and index the messages:
+
+* Use an external tool (such as offlineimap or mbsync) to deliver the messages
+  to your mail store, and call `notmuch new` to discover and index the newly
+  delivered messages (and any other changes in the mail store).
+
+* Use an external tool (such as fetchmail) receive the messages, and configure
+  the tool to use `notmuch insert` to deliver the messages to your mail store
+  and index them.
+
 ## Automation Via Hooks
 
 ## Backing up and Restoring the Database
 
 ## Removing Notmuch
+
+Did not like it after all? All you need to do is remove the database and the
+configuration file. The database is stored in the `.notmuch` directory under
+your mail store. And your mail store is at `notmuch config get database.path`.
+
+Note that the database is where the tags are stored. Everything else can be
+regenerated by indexing again, but the tags will be lost when the database is
+removed. Use the `notmuch dump` command to create a backup of the tags.