X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=vimtips.mdwn;h=d77ed92d298b37b4b910ec2bfb8054b0556f915a;hp=faa725b1b1e367628dbd3388719a7576afac441d;hb=HEAD;hpb=fec566b89d276b2eea1040ef854b7fb6b038d30b

diff --git a/vimtips.mdwn b/vimtips.mdwn
index faa725b..d77ed92 100644
--- a/vimtips.mdwn
+++ b/vimtips.mdwn
@@ -3,20 +3,44 @@
 
 Tips for using Notmuch with vim; these may be applicable when using vim with
 [[notmuch-mutt]], [mutt-kz](https://github.com/karelzak/mutt-kz), or
-[notmuch-vim](http://git.notmuchmail.org/git/notmuch/blob/HEAD:/vim/README).
+[notmuch-vim](https://git.notmuchmail.org/git/notmuch/blob/HEAD:/vim/README).
 
 [[!toc levels=2]]
 
+## Install the vim addon for Notmuch
+
+Before you can run Notmuch within vim, you must install notmuch as a vim addon.
+
+For example, if you have installed from the debian package:
+
+    $ sudo apt-get install notmuch-vim
+
+then to install as an addon, run this command:
+
+    $ vim-addon-manager install notmuch
+
+## Run Notmuch within vim
+
+Open vim and type
+
+    :Notmuch
+
+and press ENTER. Voila.
+
+
+Alternatively, you can invoke vim with the -c flag:
+
+    $ vim -c :Notmuch
 
 ## Addressbook management and vim
 
-There are some emacs tips over [here](http://notmuchmail.org/emacstips/#index15h2) that
+There are some emacs tips over [[here|emacstips#index15h2]] that
 explains how to configure emacs with an addressbook, but the few solutions were not fast enough
-for me. And I never could test the vala-based code. So I updated the notmuch_addresses code to
+for me. And I never could test the vala-based code. So I updated the notmuch\_addresses code to
 use a cache to be able to make better matches and still be lightning fast.
 
 And finally, [I needed](http://i.got.nothing.to/blog/2013/03/20/how-i-learned-to-stop-worrying-and-love-the-mail/) to have a way to autocomplete my recipients' addresses
-automagically from within `vim`. So that's why I created the [notmuch_abook](https://github.com/guyzmo/notmuch-abook) code.
+automagically from within `vim`. So that's why I created the [notmuch\_abook](https://github.com/guyzmo/notmuch-abook) code.
 You can either install it as a plugin in vim, using vundle:
 
         Vundle 'guyzmo/notmuch-abook'