add gmailieer: Fast email-fetching and two-way tag synchronization between notmuch...

[notmuch-wiki] / howto.mdwn

diff --git a/howto.mdwn b/howto.mdwn
index 1b143a91d22958de328f5b9f7b9607e7c1541263..155fc1a93fcdc1fe1ec18af92a932a5e7f70df12 100644 (file)
--- a/howto.mdwn
+++ b/howto.mdwn
@@ -6,12 +6,6 @@ various "third party" notmuch utilities.
 
 [[!toc levels=2]]
 
 
 [[!toc levels=2]]
 

-## <span id="debian_packages">**Debian squeeze packages outdated**</span>
-
-The notmuch package(s) in Debian squeeze are very old (version 0.3).
-It's better to start off with an up to date version from
-[backports](http://backports-master.debian.org/).
-

 ## <span id="receive_mail">**Receive mail**</span>
 
 Notmuch does not fetch mail for you.  For that, you need to use an
 ## <span id="receive_mail">**Receive mail**</span>
 
 Notmuch does not fetch mail for you.  For that, you need to use an


@@ -38,13 +32,30 @@ utilities support these formats:
 
 * [getmail](http://pyropus.ca/software/getmail/)
 
 
 * [getmail](http://pyropus.ca/software/getmail/)
 

-* [fetchmail](http://fetchmail.berlios.de/)
+* [fetchmail](http://www.fetchmail.info/)

 
 * [muchsync](http://www.muchsync.org/) - replicate and synchronize
   your notmuch database (mail and tags) across machines
 
 
 * [muchsync](http://www.muchsync.org/) - replicate and synchronize
   your notmuch database (mail and tags) across machines
 

-See the [[initial_tagging]] page for more info on initial tagging of
-messages.
+* [gmailieer](https://github.com/gauteh/gmailieer) - Fast email-fetching and two-way tag synchronization between notmuch and GMail
+
+See more exhaustive list of [[software]] notmuch works with and the
+[[initial_tagging]] page for more info on initial tagging of messages.
+
+
+## <span id="send_mail">**Send mail**</span>
+
+Notmuch does not send your mail. The frontends (MUAs) that utilize notmuch
+does that. Often these MUAs use sendmail(8) to send your mail.
+
+If you prefer a simpler solution like msmtp, first
+[install and configure msmtp](http://msmtp.sourceforge.net/).
+
+Then create a symbolic link so that msmtp will be called instead of sendmail
+when you press the keyboard shortcut to send your message.
+
+    $ sudo ln -s /usr/bin/msmtp /usr/sbin/sendmail
+

 
 ## <span id="sync_maildir_flags">**Sync notmuch tags and maildir flags**</span>
 
 
 ## <span id="sync_maildir_flags">**Sync notmuch tags and maildir flags**</span>
 


@@ -66,21 +77,7 @@ refer to the mailing list.
 
 ## <span id="python">**Use notmuch from python**</span>
 
 
 ## <span id="python">**Use notmuch from python**</span>
 

-Notmuch includes python bindings to the notmuch shared library. Please
-refer to the nice and extensive
-[notmuch python API documentation](http://notmuch.readthedocs.org/).
-
-The bindings are very simple to use.  As an example, given you have
-the python bindings installed (or simply set your PYTHONPATH
-environment variable to point to the .../bindings/python directory),
-this snippet will produce a list of mails matching the given
-expression:
-
-        >>> import notmuch
-        >>> db = notmuch.Database()
-        >>> query = db.create_query('tag:inbox AND NOT tag:killed')
-        >>> list(query.search_messages()) # doctest:+ELLIPSIS
-        [...]
+See the [[Notmuch Library Language Bindings|bindings]] page.

 
 ## <span id="print_filenames">**Using notmuch with Mutt**</span>
 
 
 ## <span id="print_filenames">**Using notmuch with Mutt**</span>
 


@@ -94,15 +91,15 @@ However, for users running with databases created in older versions of
 notmuch, these tags are missing in pre-existing messages and need to be
 added.  One way to do this is as follows:
 
 notmuch, these tags are missing in pre-existing messages and need to be
 added.  One way to do this is as follows:
 

-        $ notmuch dump --output=~/out.nm
+        $ notmuch dump --output=$HOME/out.nm

         $ mv ~/Mail/.notmuch ~/.notmuch.bak
         $ notmuch new
         $ notmuch tag -inbox -unread '*'
         $ mv ~/Mail/.notmuch ~/.notmuch.bak
         $ notmuch new
         $ notmuch tag -inbox -unread '*'

-        $ notmuch restore --accumulate --input=~/out.nm
+        $ notmuch restore --accumulate --input=$HOME/out.nm

 
 At this point, one should run a sanity check on the tags, and if everything
 has merged correctly, the ~/.notmuch.bak directory is expendable, as is
 
 At this point, one should run a sanity check on the tags, and if everything
 has merged correctly, the ~/.notmuch.bak directory is expendable, as is

-~/out.nm.
+$HOME/out.nm.

 
 ## <span id="mbox">**Dealing with mbox and other formats**</span>
 
 
 ## <span id="mbox">**Dealing with mbox and other formats**</span>
 


@@ -148,3 +145,6 @@ in a scenario where you have encrypted your hard disk anyway and are
 comfortable with the security implications (and until notmuch can index
 encrypted email itself).
 
 comfortable with the security implications (and until notmuch can index
 encrypted email itself).
 

+## Translations
+
+- A translation of this page into [[Russian|howto-ru]]