Add link to bgamari's sorting configuration

[notmuch-wiki] / howto.mdwn

diff --git a/howto.mdwn b/howto.mdwn
index b7cb71f002f7ee952b486c47d21692dbb4ea0174..4d6c53e81988e034e75c21386a4765b6e2185ba6 100644 (file)
--- a/howto.mdwn
+++ b/howto.mdwn
@@ -4,7 +4,7 @@
 Some tips about how to do some useful things with notmuch, and the
 various "third party" notmuch utilities.
 
 Some tips about how to do some useful things with notmuch, and the
 various "third party" notmuch utilities.
 

-* <span id="receive_mail">Receiving mail</span>
+* <span id="receive_mail">**Receive mail**</span>

 
   Notmuch requires either [maildir
   flag](http://cr.yp.to/proto/maildir.html) or a "mh"-style
 
   Notmuch requires either [maildir
   flag](http://cr.yp.to/proto/maildir.html) or a "mh"-style


@@ -12,8 +12,8 @@ various "third party" notmuch utilities.
   is in a file of it's own will work.  Here are some generally
   well-regarded mail retrieval tools:
 
   is in a file of it's own will work.  Here are some generally
   well-regarded mail retrieval tools:
 

-  * [offlineimap](http://software.complete.org/software/projects/show/offlineimap) - quite
-    useful and widely tested, it also offers a handy hook that
+  * [offlineimap](https://github.com/jgoerzen/offlineimap/wiki/) -
+    quite useful and widely tested, it also offers a handy hook that

     will come in useful a bit later in our setup.  Also supports
     "presynchook" and "postsynchook" command that will get run
     whenever you sync.  Point _postsynchook_ to a script that gets run
     will come in useful a bit later in our setup.  Also supports
     "presynchook" and "postsynchook" command that will get run
     whenever you sync.  Point _postsynchook_ to a script that gets run


@@ -26,9 +26,9 @@ various "third party" notmuch utilities.
 
   * [fetchmail](http://fetchmail.berlios.de/)
 
 
   * [fetchmail](http://fetchmail.berlios.de/)
 

-See the [initial tagging page](/initial_taggin) for more info on intial tagging of messages.
+  See the [[initial_tagging]] page for more info on intial tagging of messages.

 
 

-* <span id="print_filenames">Print only filenames of a search</span>
+* <span id="print_filenames">**Print only filenames of a search (python bindings)**</span>

 
   Notmuch includes python bindings to the notmuch shared library,
   called [cnotmuch](http://pypi.python.org/pypi/cnotmuch).  Extensive
 
   Notmuch includes python bindings to the notmuch shared library,
   called [cnotmuch](http://pypi.python.org/pypi/cnotmuch).  Extensive


@@ -47,7 +47,11 @@ See the [initial tagging page](/initial_taggin) for more info on intial tagging
                              for m in q.search_messages():
                                  print m.get_filename()
 
                              for m in q.search_messages():
                                  print m.get_filename()
 

-* <span id="sync_maildir_flags">Sync notmuch tags and maildir flags</span>
+* <span id="sync_maildir_flags">**Sync notmuch tags and maildir flags**</span>
+
+  notmuch **since version 0.5** syncs maildir flags and respective
+  tags in both directions.  This how to applies only to notmuch
+  prior version 0.5:

 
   Some IMAP users rely on maildir flags that convey the status "seen",
   "replied", "trashed", in order to synchronize the status of their
 
   Some IMAP users rely on maildir flags that convey the status "seen",
   "replied", "trashed", in order to synchronize the status of their


@@ -69,3 +73,27 @@ See the [initial tagging page](/initial_taggin) for more info on intial tagging
   *id:1267450136-31749-1-git-send-email-Sebastian@SSpaeth.de* and can
   be viewed as a [source diff in this git
   repository](http://github.com/spaetz/notmuch-all-feature/commit/df3b087cefb85e9d16fd17540e348bcb854dd7ee).
   *id:1267450136-31749-1-git-send-email-Sebastian@SSpaeth.de* and can
   be viewed as a [source diff in this git
   repository](http://github.com/spaetz/notmuch-all-feature/commit/df3b087cefb85e9d16fd17540e348bcb854dd7ee).

+
+* <span id="print_filenames">**Using notmuch with Mutt**</span>
+
+  Notmuch is a great mail indexing tool than can also be used *in conjunction*
+  with existing Mail User Agents (MUA) instead of replacing them. The advantage
+  of such mixed solutions is that users can benefit from notmuch features (such
+  as full-text search and thread reconstruction) without *having to* change
+  MUA.
+  
+  A popular geek MUA is [the Mutt e-mail client](http://www.mutt.org);
+  integrating notmuch with Mutt is fairly straightforward. An
+  [**how to use Notmuch with Mutt**](http://upsilon.cc/~zack/blog/posts/2011/01/how_to_use_Notmuch_with_Mutt/)
+  has been written by Stefano Zacchiroli, together with some glue code. Check
+  out the
+  [howto](http://upsilon.cc/~zack/blog/posts/2011/01/how_to_use_Notmuch_with_Mutt/)
+  for more information.
+  
+  <small>(Note by the howto author: I've linked the howto from this wiki rather
+  than splicing it in, in order to avoid duplication of information. If you
+  think it would be better to have it here, feel free to copy the text
+  here. The howto is
+  [available](http://git.upsilon.cc/cgi-bin/gitweb.cgi?p=zack-homepage.git;a=history;f=blog/posts/2011/01/how_to_use_Notmuch_with_Mutt.mdwn)
+  in markdown syntax from the Git repository of my homepage.)</small>
+