Update news & manpages to notmuch version 0.16

[obsolete/notmuch-wiki] / howto.mdwn

diff --git a/howto.mdwn b/howto.mdwn
index 12351d452f0fabe61befc1ca93c82546db485934..f4ef721a00f5016809b555014a300dcf65feb8eb 100644 (file)
--- a/howto.mdwn
+++ b/howto.mdwn
@@ -5,6 +5,12 @@ various "third party" notmuch utilities.
 
 [[!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
@@ -19,7 +25,7 @@ mbox mail store formats is not supported, but fortunately it is very
 easy to [[convert mbox to maildir|howto/#mbox]] .  The following
 utilities support these formats:
 
-* [offlineimap](https://github.com/nicolas33/offlineimap/) -
+* [offlineimap](http://offlineimap.org/) -
   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
@@ -74,53 +80,7 @@ expression:
 
 ## <span id="print_filenames">**Using notmuch with Mutt**</span>
 
-Notmuch is a great mail indexing tool that 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 not seamless, but fairly straightforward.
-There are two principal possibilities, each with its own ups and downs:
-
-* Using mutt-notmuch, which will create a "virtual" maildir folder with
-  search results whenever a search is made. The upside is that you can
-  search all your folders simultanously; the downside is that your
-  modifications in the results listing do not carry over, also having
-  to switch folders comes with some more annoyances.
-
-  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. 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>
-
-* Using a simple macro that will emulate the "limit" mutt functionality
-  using notmuch.
-
-  See the [**alternative notmuch integration**](http://log.or.cz/?p=228)
-  blog post for instructions and details,
-  or simply put these two macros to your muttrc:
-
-        # 'L' performs a notmuch query, showing only the results
-        macro index L "<enter-command>unset wait_key<enter><shell-escape>read -p 'notmuch query: ' x; echo \$x >~/.cache/mutt_terms<enter><limit>~i \"\`notmuch search --output=messages \$(cat ~/.cache/mutt_terms) | head -n 600 | perl -le '@a=<>;chomp@a;s/\^id:// for@a;$,=\"|\";print@a'\`\"<enter>" "show only messages matching a notmuch pattern"
-        # 'a' shows all messages again (supersedes default <alias> binding)
-        macro index a "<limit>all\n" "show all messages (undo limit)"
-
-  The upside (if you are used to working in the context of a single folder)
-  is that this really does use the limit functionality of mutt
-  and you are still in your original folder.
-  The downside is that this approach has scaling problems
-  and works well only for reasonably specific queries.
-
+See [[notmuch-mutt]].
 
 ## <span id="reapply_auto">**Automatically retagging the database (e.g., when upgrading versions)**</span>
 
@@ -130,11 +90,11 @@ 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 dump ~/out.nm
+        $ notmuch dump --output=~/out.nm
         $ mv ~/Mail/.notmuch ~/.notmuch.bak
         $ notmuch new
         $ notmuch tag -inbox -unread '*'
-        $ notmuch restore --accumulate ~/out.nm
+        $ notmuch restore --accumulate --input=~/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