notmuch/vim
Jason Woofenden 6c6c8a9c85 vim: fix (hack) cig/cit parsing within multipart/*
The vim front-end isn't written to handle nested parts.

This patch doesn't change that, it just changes the code to pretend that
multipart/* sections end immediately. This makes the parsing code think that
all sections are top-level, and are thus parsed well enough.

The lovely result of this is that citation folds and signature folds now work
in text/plain parts that are within multipart/* sections. Also, all mime
section starts are now shown correctly (before some were not parsed and showed
the ugly ^L and an ID and so on from notmuch.)

Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com>
2011-07-16 21:57:38 +03:00
..
plugin vim: fix (hack) cig/cit parsing within multipart/* 2011-07-16 21:57:38 +03:00
syntax vim: include own improved git-diff syntax 2010-11-08 10:00:18 -08:00
Makefile simplify install with a Makefile 2009-11-25 00:48:49 -05:00
notmuch.yaml Install vim plugin with vim-addons 2010-01-21 14:58:19 +13:00
README vim: fix documentation that mailx isn't used anymore 2011-07-16 21:49:09 +03:00

This directory contains a vim script that allows reading notmuch mail
through vim.

NOTE: this is a work in progress.  Patches welcome. <bart@jukie.net>

Dependencies:
    notmuch:
        Naturally, it expects you have notmuch installed and configured.

    sendmail:
        To send mail, notmuch.vim uses sendmail as default.  Most modern MTAs
        provide a compatibility binary, and so should work well.


To install:
        make install


To run:
        vim -c ':NotMuch'

    from vim:
        :NotMuch
        :NotMuch new to:bart@jukie.net 'subject:this is a test'


Buffer types:
    [notmuch-folders]
        Folder list, or technically a list of saved searches.

        Keybindings:
            <Enter> - show the selected search
            m       - compose a new message
            s       - enter search criteria
            =       - refresh display

    [notmuch-search]
        You are presented with the search results when you run :NotMuch.

        Keybindings:
            <Space> - show the selected thread collapsing unmatched items
            <Enter> - show the entire selected thread
            a       - archive message (remove inbox tag)
            f       - filter the current search terms
            o       - toggle search screen order
            m       - compose a new message
            r       - reply to thread
            s       - enter search criteria
            ,s      - 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:
            <Space> - mark read, archive, go to next matching message
            ^n      - next message
            ^p      - previous message
            b       - toggle folding of message bodies
            c       - toggle folding of citations
            h       - toggle folding of extra header lines
            i       - toggle folding of signatures
            m       - compose a new message
            r       - reply to the message
            s       - enter search criteria
            q       - return to search display
            ?       - reveal the message and thread IDs of what's under cursor
            ^]      - search using word under cursor

    [notmuch-compose]
        When you're writing an email, you're in this mode.

        Insert-mode keybindings:
            <Tab>   - go to the next header line

        Normal-mode keybindings:
            <Tab>   - go to the next header line
            ,s      - send this message
            ,q      - abort this message