unofficial mirror of notmuch@notmuchmail.org
 help / color / mirror / code / Atom feed
blob e72aa916c12d53c1fa3f527a76df62df5b185129 2152 bytes (raw)
name: contrib/mutt-notmuch/README 	 # note: path name is non-authoritative(*)

 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
 
mutt-notmuch: Notmuch (of a) helper for Mutt
============================================

mutt-notmuch provide integration among the [Mutt] [1] mail user agent and the
[Notmuch] [2] mail indexer.

mutt-notmuch offer two basic integration features. The first one is the ability
of stating a **search query interactively** and then jump to a fresh Maildir
containing its search results only. The second one is the ability to
**reconstruct threads on the fly** starting from the currently highlighted
mail, which comes handy when a thread has been split across different maildirs,
archived, or the like.

mutt-notmuch enables to trigger mail searches via a Mutt macro (F8 being my
choice) and reconstruct threads via another (F9). Check the manpage for the
2-liner configuration snippet for your ~/.muttrc.

A [blog style introduction] [3] to mutt-notmuch is available and includes some
more rationale for its existence.

Arguably, some of the logics of mutt-notmuch could disappear by adding support
for a --output=symlinks flag to notmuch.


[1]: http://www.mutt.org/
[2]: http://notmuchmail.org/
[3]: http://upsilon.cc/~zack/blog/posts/2011/01/how_to_use_Notmuch_with_Mutt/


Requirements
------------

To *run* mutt-notmuch you will need Perl with the following libraries:

- Mail::Box <http://search.cpan.org/~markov/Mail-Box/>
  (Debian package: libmail-box-perl)
- Mail::Internet <http://search.cpan.org/~markov/MailTools/>
  (Debian package: libmailtools-perl)
- String::ShellQuote <http://search.cpan.org/~rosch/String-ShellQuote/ShellQuote.pm>
  (Debian package: libstring-shellquote-perl)
- Term::ReadLine <http://search.cpan.org/~hayashi/Term-ReadLine-Gnu/>
  (Debian package: libterm-readline-gnu-perl)

To *build* mutt-notmuch documentation you will need:

- pod2man (coming with Perl) to generate the manpage
- markdown to generate README.html out of this file


License
-------

mutt-notmuch is copyright (C) 2011-2012 Stefano Zacchiroli <zack@upsilon.cc>.

mutt-notmuch is released under the terms of the GNU General Public License
(GPL), version 3 or above. A copy of the license is available online at
<http://www.gnu.org/licenses/>.


debug log:

solving e72aa91 ...
found e72aa91 in https://yhetil.org/notmuch/87haxbr6tv.fsf@zancas.localnet/

applying [1/1] https://yhetil.org/notmuch/87haxbr6tv.fsf@zancas.localnet/
diff --git a/contrib/mutt-notmuch/README b/contrib/mutt-notmuch/README
new file mode 100644
index 0000000..e72aa91

Checking patch contrib/mutt-notmuch/README...
1:64: new blank line at EOF.
+
Applied patch contrib/mutt-notmuch/README cleanly.
warning: 1 line adds whitespace errors.

index at:
100644 e72aa916c12d53c1fa3f527a76df62df5b185129	contrib/mutt-notmuch/README

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://yhetil.org/notmuch.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).