Mention notmuchfs in the notmuch-mutt page

[notmuch-wiki] / notmuch-mutt.mdwn

diff --git a/notmuch-mutt.mdwn b/notmuch-mutt.mdwn
index fb7a6c87e33951e5b4933eabbd692b3b0b6de1c7..9fc11edfbcb80a3aced9397014003da21cf34bcb 100644 (file)
--- a/notmuch-mutt.mdwn
+++ b/notmuch-mutt.mdwn
@@ -7,7 +7,10 @@ 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
 
 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:
+principal possibilities, either using a patched mutt that handles internally
+notmuch, or use a sets of scripts/handler within mutt to achieve something close.
+
+[[!toc levels=2]]

 
 # Using Notmuch with mutt-kz
 
 
 # Using Notmuch with mutt-kz
 


@@ -29,12 +32,12 @@ principal possibilities, each with its own ups and downs:
             "Starred"   "notmuch://?query=tag:*"\
             "Sent"      "notmuch://?query=tag:sent"        # sets up queries for virtual folders
         # notmuch bindings
             "Starred"   "notmuch://?query=tag:*"\
             "Sent"      "notmuch://?query=tag:sent"        # sets up queries for virtual folders
         # notmuch bindings

-        macro index \\ "<vfolder-from-query>"              # looks up a hand mane query
-        macro index A "<modify-labels>+archive -unread -inbox\n"        # tag as Archived
-        macro index I "<modify-labels>-inbox -unread\n"                 # removed from inbox
-        macro index S "<modify-labels-then-hide>-inbox -unread +junk\n" # tag as Junk mail
-        macro index + "<modify-labels>+*\n<sync-mailbox>"               # tag as starred
-        macro index - "<modify-labels>-*\n<sync-mailbox>"               # tag as unstarred
+        macro index \\\\ "<vfolder-from-query>"              # looks up a hand made query
+        macro index A "<modify-labels>+archive -unread -inbox\\n"        # tag as Archived
+        macro index I "<modify-labels>-inbox -unread\\n"                 # removed from inbox
+        macro index S "<modify-labels-then-hide>-inbox -unread +junk\\n" # tag as Junk mail
+        macro index + "<modify-labels>+*\\n<sync-mailbox>"               # tag as starred
+        macro index - "<modify-labels>-*\\n<sync-mailbox>"               # tag as unstarred

         # sidebar
         set sidebar_width   = 20
         set sidebar_visible = yes               # set to "no" to disable sidebar view at startup
         # sidebar
         set sidebar_width   = 20
         set sidebar_visible = yes               # set to "no" to disable sidebar view at startup


@@ -48,13 +51,13 @@ principal possibilities, each with its own ups and downs:
         macro index ,@( "<enter-command> set sidebar_visible=yes; macro index ~ ,@) 'Toggle sidebar'<Enter>"
         macro index ~ ,@( 'Toggle sidebar'      # toggle the sidebar
 
         macro index ,@( "<enter-command> set sidebar_visible=yes; macro index ~ ,@) 'Toggle sidebar'<Enter>"
         macro index ~ ,@( 'Toggle sidebar'      # toggle the sidebar
 

-* Using:
+## Using:

 
 when you open `mutt` you get the INBOX opened. There you can crawl through your
 mails, and tag them as appropriate, either manually using the " ` " command, or using
 the bindings defined in configuration (such as A/I/S/+/-).
 
 
 when you open `mutt` you get the INBOX opened. There you can crawl through your
 mails, and tag them as appropriate, either manually using the " ` " command, or using
 the bindings defined in configuration (such as A/I/S/+/-).
 

-* Mail tagging on sending
+## Mail tagging on sending

 
 You may have noticed in `mutt-kz`'s configuration that I set the `sendmail` variable
 of mutt to a `nm_sendmail` script. This is for tagging outgoing mail each time I send
 
 You may have noticed in `mutt-kz`'s configuration that I set the `sendmail` variable
 of mutt to a `nm_sendmail` script. This is for tagging outgoing mail each time I send


@@ -177,7 +180,7 @@ able to open a completion menu when you do <C-x><C-u> at every address header.
 
 # Using Notmuch with bare Mutt, the old fashioned way
 
 
 # Using Notmuch with bare Mutt, the old fashioned way
 

-* Using
+## Using

   [notmuch-mutt](http://git.notmuchmail.org/git/notmuch/tree/HEAD:/contrib/notmuch-mutt),
   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
   [notmuch-mutt](http://git.notmuchmail.org/git/notmuch/tree/HEAD:/contrib/notmuch-mutt),
   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


@@ -196,7 +199,7 @@ able to open a completion menu when you do <C-x><C-u> at every address header.
   [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>
 
   [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 a simple macro that will emulate the "limit" mutt functionality

   using notmuch.
 
   See the [alternative notmuch integration](http://log.or.cz/?p=228)
   using notmuch.
 
   See the [alternative notmuch integration](http://log.or.cz/?p=228)


@@ -213,3 +216,7 @@ able to open a completion menu when you do <C-x><C-u> at every address header.
   your original folder.  The downside is that this approach has scaling problems
   and works well only for reasonably specific queries.
 
   your original folder.  The downside is that this approach has scaling problems
   and works well only for reasonably specific queries.
 

+## Using [notmuchfs](https://github.com/tsto/notmuchfs)
+
+  Notmuchfs provides virtual maildirs at the file system level, and mutt can be
+  placed on top. See [README.mutt](https://github.com/tsto/notmuchfs/blob/master/README.MUTT.md)