aboutsummaryrefslogtreecommitdiffhomepage
path: root/vim/README
blob: d8bea97f304bffb038a93dee9a071e63defefe45 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
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.

    mail:
        To send mail, notmuch.vim uses the UNIX mail command.

    git-diff:
        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:
        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
            ,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
            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