]> git.cworth.org Git - notmuch-wiki/blob - news/release-0.5.mdwn
go for level 3 header instead of level 4 header...
[notmuch-wiki] / news / release-0.5.mdwn
1 [[!meta date="2010-11-11"]]
2
3 Notmuch 0.5 (2010-11-11)
4 ========================
5
6 New, general features
7 ---------------------
8
9 ### Maildir-flag synchronization
10
11   Notmuch now knows how to synchronize flags in maildir filenames with
12   tags in the notmuch database. The following flag/tag mappings are
13   supported:
14
15             Flag <-> Tag
16             ----     -----
17             'D'      draft
18             'F'      flagged
19             'P'      passed
20             'R'      replied
21             'S'      unread (added when 'S' flag is not present)
22
23   The synchronization occurs in both directions, (for example, adding
24   the 'S' flag to a file will cause the "unread" tag to be added, and
25   adding the "replied" tag to a message will cause the file to be
26   renamed with an 'R' flag).
27
28   This synchronization is enabled by default for users of the
29   command-line interface, (though only files in directories named
30   "cur" or "new" will be renamed). It can be disabled by setting the
31   new `maildir.synchronize_flags` option in the configuration file. For
32   example:
33
34         notmuch config set maildir.synchronize_flags false
35
36   Users upgrading may also want to run "notmuch setup" once (just
37   accept the existing configuration) to get a new, nicely-commented
38   [maildir] section added to the configuration file.
39
40   For users of the notmuch library, the new synchronization
41   functionality is available with the following two new functions:
42
43         notmuch_message_maildir_flags_to_tags
44         notmuch_message_tags_to_maildir_flags
45
46   It is anticipated that future improvements to this support will
47   allow for safe synchronization of the 'T' flag with the "deleted"
48   tag, as well as support for custom flag/tag mappings.
49
50 New library features
51 --------------------
52
53 ### Support for querying multiple filenames for a single message
54
55   It is common for the mailstore to contain multiple files with the
56   same message ID. Previously, notmuch would always hide these
57   duplicate files, (returning a single, arbitrary filename with
58   `notmuch_message_get_filename`).
59
60   With this release, library users can access all filenames for a
61   message with the new function:
62
63         notmuch_message_get_filenames
64
65   Together with `notmuch_filenames_valid`, `notmuch_filenames_get`,
66   and `notmuch_filenames_move_to_next` it is now possible to iterate
67   over all available filenames for a given message.
68
69 New command-line features
70 -------------------------
71
72 ### New "notmuch show --format=raw" for getting at original email contents
73
74   This new feature allows for a fully-functional email client to be
75   built on top of the notmuch command-line without needing any direct
76   access to the mail store itself.
77
78   For example, it's now possible to run "emacs -f notmuch" on a local
79   machine with only ssh access to the mail store/notmuch database. To
80   do this, simply set the notmuch-command variable in emacs to the
81   name of a script containing:
82
83         ssh user@host notmuch "$@"
84
85   If the ssh client has enabled connection sharing (ControlMaster
86   option in OpenSSH), the emacs interface can be quite responsive this
87   way.
88
89 General bug fixes
90 -----------------
91
92 ### Fix "notmuch search" to print nothing when nothing matches
93
94   The 0.4 release had a bug in which:
95
96         notmuch search <expression-with-no-matches>
97
98   would produce a single blank line of output, (where previous
99   versions would produce no output. This fix also causes a change in
100   the --format=json output, (which would previously produce "[]" and
101   now produces nothing).
102
103 Emacs interface improvements
104 ----------------------------
105
106 ### Fix to allow pipe ('|') command to work when using notmuch over ssh
107
108 ### Fix count of lines in hidden signatures
109
110 ### Omit repeated subject lines in (collapsed) thread display
111
112 ### Display current thread subject in a header line
113
114 ### Provide a "c i" binding to copy a thread ID from the search view
115
116 ### Allow for notmuch-fcc-dirs to have a value of nil
117
118   Also, the more complex form of notmuch-fcc-dirs now has a slightly
119   different format. It no longer has a special first-element, fallback
120   string. Instead it's now a list of cons cells where the car of each
121   cell is a regular expression to be matched against the sender
122   address, and the cdr is the name of a folder to use for an FCC. So
123   the old fallback behavior can be achieved by including a final cell
124   of (".*" . "default-fcc-folder").
125
126 Vim interface improvements
127 --------------------------
128
129 Felipe Contreras provided a number of updates for the vim interface
130
131   These include optimizations, support for newer versions of vim, fixed
132   support for sending mail on modern systems, new commands, and
133   various cleanups.
134
135 New bindings
136 ------------
137
138 Added initial ruby bindings in bindings/ruby