X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=vim%2FREADME;h=02bd3e65ac4d345d4a931c6007f4fbfef866e8f8;hp=bd453a400ea5c1575025435d3f520ce33f2f4266;hb=682aa2e076665db3bc344deb13033b1d480e6b6f;hpb=df5137ff34d97b6dcdc90c8e07d9fb523b7bc2be

diff --git a/vim/README b/vim/README
index bd453a40..02bd3e65 100644
--- a/vim/README
+++ b/vim/README
@@ -1,10 +1,62 @@
 This directory contains a vim script that allows reading notmuch mail
 through vim.
 
-To install:
+NOTE: this is a work in progress.  Patches welcome. <bart@jukie.net>
+
+The vim interface makes use of the git-diff.vim syntax file which is
+available from
+    http://github.com/motemen/git-vim/blob/master/syntax/git-diff.vim
 
+
+To install:
         make install
 
-To run:
 
+To run:
         vim -c ':NotMuch'
+
+    from vim:
+        :NotMuch
+
+
+Buffer types:
+    [notmuch-folders]
+        Folder list, or technically a list of saved searches.
+
+        Keybindings:
+            <Enter> - show the selected search
+            s       - enter search criteria
+            =       - refresh display
+
+    [notmuch-search]
+        You are presented with the search results when you run :NotMuch.
+
+        Keybindings:
+            <Enter> - show the selected message
+            a       - archive message (remove inbox tag)
+            f       - filter the current search terms
+            o       - toggle search screen order
+            s       - enter search criteria
+            es      - alter search criteria
+            t       - filter the current search terms with tags
+            q       - return to folder display, or undo filter
+            +       - add tag(s) to selected message
+            -       - remove tag(s) from selected message
+            =       - refresh display
+            ?       - reveal the thread ID of what's under cursor
+            ^]      - search using word under cursor
+
+    [notmuch-show]
+        This is the display of the message.
+
+        Keybindings:
+            ^n      - next message
+            ^p      - previous message
+            b       - toggle folding of message bodies
+            c       - toggle folding of citations
+            h       - toggle folding of extra header lines
+            s       - toggle folding of signatures
+            q       - return to search display
+            ?       - reveal the message and thread IDs of what's under cursor
+            ^]      - search using word under cursor
+