git.cworth.org Git - notmuch-wiki/blob - news/release-0.3.mdwn

   1 [[!meta date="2010-04-27"]]
   2
   3 Notmuch 0.3 (2010-04-27)
   4 ========================
   5
   6 New command-line features
   7 -------------------------
   8
   9 ### User-configurable tags for new messages
  10
  11 A new "new.tags" option is available in the configuration file to
  12 determine which tags are applied to new messages. Run "notmuch
  13 setup" to generate new documentation within ~/.notmuch-config on how
  14 to specify this value.
  15
  16 ### Threads search results named based on subjects that match search
  17
  18 This means that when new mails arrived to a thread you've previously
  19 read, and the new mails have a new subject, you will see that
  20 subject in the search results rather than the old subject.
  21
  22 ### Faster operation of "notmuch tag" (avoid unneeded sorting)
  23
  24 Since the user just wants to tag all matching messages, we can make
  25 things perform a bit faster by avoiding the sort.
  26
  27 ### Even Better guessing of From: header for "notmuch reply"
  28
  29 Notmuch now looks at a number of headers when trying to figure out
  30 the best From: header to use in a reply. This is helpful if you have
  31 several configured email addresses, and you also subscribe to various
  32 mailing lists with different addresses, (so that mails you are
  33 replying to won't always include your subscribed address in the To:
  34 header).
  35
  36 ### Indication of author names that match a search
  37
  38 When notmuch displays threads as the result of a search, it now
  39 lists the authors that match the search before listing the other
  40 authors in the thread. It inserts a pipe '|' symbol between the last
  41 matching and first non-matching author. This is especially useful in
  42 a search that includes tag:unread. Now the authors of the unread
  43 messages in the thread are listed first.
  44
  45 New: Python bindings
  46 --------------------
  47
  48 Sebastian Spaeth has contributed his python bindings for the notmuch
  49 library to the central repository. These bindings were previously
  50 known as "cnotmuch" within python but have now been renamed to be
  51 accessible with a simple, and more official-looking "import notmuch".
  52
  53 The bindings have already proven very useful as people proficient in
  54 python have been able to easily develop programs to do notmuch-based
  55 searches for email-address completion, maildir-flag synchronization,
  56 and other tasks.
  57
  58 These bindings are available within the bindings/python directory, but
  59 are not yet integrated into the top-level Makefiles, nor the top-level
  60 package-building scripts. Improvements are welcome.
  61
  62 Emacs interface improvements
  63 ----------------------------
  64
  65 ### An entirely new initial view for notmuch, (friendly yet powerful)
  66
  67 Some of us call the new view "notmuch hello" but you can get at it
  68 by simply calling "emacs -f notmuch". The new view provides a search
  69 bar where new searches can be performed. It also displays a list of
  70 recent searches, along with a button to save any of these, giving it
  71 a new name as a "saved search". Many people find these "saved
  72 searches" one of the most convenient ways of organizing their mail,
  73 (providing all of the features of "folders" in other mail clients,
  74 but without any of the disadvantages).
  75
  76 Finally, this view can also optionally display all of the tags that
  77 exist in the database, along with a count for each tag, and a custom
  78 search of messages with that tag that's simply a click (or keypress)
  79 away.
  80
  81 NOTE: For users that liked the original mode of "emacs -f notmuch"
  82 immediately displaying a particular search result, we recommend
  83 instead running something like:
  84
  85         emacs --eval '(notmuch search "tag:inbox" t)'
  86
  87 The "t" means to sort the messages in an "oldest first" order,
  88 (as notmuch would do previously by default). You can also
  89 leave that off to have your search results in "newest first"
  90 order.
  91
  92 ### Full-featured "customize" support for configuring notmuch
  93
  94 Notmuch now plugs in well to the emacs "customize" mode to make it
  95 much simpler to find things about the notmuch interface that can be
  96 tweaked by the user.
  97
  98 You can get to this mode by starting at the main "Customize" menu in
  99 emacs, then browsing through "Applications", "Mail", and
 100 "Notmuch". Or you can go straight to "M-x customize-group"
 101 "notmuch".
 102
 103 Once you're at the customize screen, you'll see a list of documented
 104 options that can be manipulated along with checkboxes, drop-down
 105 selectors, and text-entry boxes for configuring the various
 106 settings.
 107
 108 ### Support for doing tab-completion of email addresses
 109
 110 This support currently relies on an external program,
 111 (notmuch-addresses), that is not yet shipped with notmuch
 112 itself. But multiple, suitable implementations of this program have
 113 already been written that generate address completions by doing
 114 notmuch searches of your email collection. For example, providing
 115 first those addresses that you have composed messages to in the
 116 past, etc.
 117
 118 One such program (implemented in python with the python bindings to
 119 notmuch) is available via:
 120
 121         git clone  http://jkr.acm.jhu.edu/git/notmuch_addresses.git
 122
 123 Install that program as notmuch-addresses on your PATH, and then
 124 hitting TAB on a partial email address or name within the To: or Cc:
 125 line of an email message will provide matching completions.
 126
 127 ### Support for file-based (Fcc) delivery of sent messages to mail store
 128
 129 This isn't yet enabled by default. To enable this, one will have to
 130 set the "Notmuch Fcc Dirs" setting within the notmuch customize
 131 screen, (see its documentation there for details). We anticipate
 132 making this automatic in a future release.
 133
 134 ### New 'G' key binding to trigger mail refresh (G == "Get new mail")
 135
 136 The 'G' key works wherever '=' works. Before refreshing the screen
 137 it calls an external program that can be used to poll email servers,
 138 run notmuch new and set up specific tags for the new emails. The
 139 script to be called should be configured with the "Notmuch Poll
 140 Script" setting in the customize interface. This script will
 141 typically invoke "notmuch new" and then perhaps several "notmuch
 142 tag" commands.
 143
 144 ### Implement emacs message display with the JSON output from notmuch
 145
 146 This is much more robust than the previous implementation, (where
 147 some HTML mails and mail quoting the notmuch code with the delimiter
 148 characters in it would cause the parser to fall over).
 149
 150 ### Better handling of HTML messages and MIME attachments (inline images!)
 151
 152 Allow for any MIME parts that emacs can display to be displayed
 153 inline. This includes inline viewing of image attachments, (provided
 154 the window is large enough to fit the image at its natural size).
 155
 156 Much more robust handling of HTML messages. Currently both text/plain
 157 and text/html alternates will be rendered next to each other. In a
 158 future release, users will be able to decide to see only one or the
 159 other representation.
 160
 161 Each attachment now has its own button so that attachments can be
 162 saved individually (the 'w' key is still available to save all
 163 attachments).
 164
 165 ### Customizable support for tidying of text/plain message content
 166
 167 Many new functions are available for tidying up message
 168 content. These include options such as wrapping long lines,
 169 compressing duplicate blank lines, etc.
 170
 171 Most of these are disabled by default, but can easily be enabled by
 172 clicking the available check boxes under the "Notmuch Show Insert
 173 Text/Plain Hook" within the notmuch customize screen.
 174
 175 ### New support for searchable citations (even when hidden)
 176
 177 When portions of overly-long citations are hidden, the contents of
 178 these citations will still be available for emacs' standard
 179 "incremental search" functions. When the search matches any portion
 180 of a hidden citation, the citation will become visible temporarily
 181 to display the search result.
 182
 183 ### More flexible handling of header visibility
 184
 185 As an answer to complaints from many users, the To, Cc, and Date
 186 headers of messages are no longer hidden by default. For those users
 187 that liked that these were hidden, a new "Notmuch Messages Headers
 188 Visible" option in the customize interface can be set to nil. The
 189 visibility of headers can still be toggled on a per-message basis
 190 with the 'h' keybinding.
 191
 192 For users that don't want to see some subset of those headers, the
 193 new "Notmuch Message Headers" variable can be customized to list
 194 only those headers that should be present in the display of a message.
 195
 196 ### The Return key now toggles message visibility anywhere
 197
 198 Previously this worked only on the first summary-line of a message.
 199
 200 ### Customizable formatting of search results
 201
 202 The user can easily customize the order, width, and formatting of
 203 the various fields in a "notmuch search" buffer. See the "Notmuch
 204 Search Result Format" section of the customize interface.
 205
 206 ### Generate nicer names for search buffers when using a saved search
 207
 208 ### Add a notmuch User-Agent header when sending mail from notmuch/emacs
 209
 210 ### New keybinding (M-Ret) to open all collapsed messages in a thread
 211
 212 New library feature
 213 -------------------
 214
 215 ### Provide a new `NOTMUCH_SORT_UNSORTED` value for queries
 216
 217 This can be somewhat faster when sorting simply isn't desired. For
 218 example when collecting a set of messages that will all be
 219 manipulated identically, (adding a tag, removing a tag, deleting the
 220 messages), then there's no advantage to sorting the messages by
 221 date.
 222
 223 Build fixes
 224 -----------
 225
 226 ### Fix to compile against GMime 2.6
 227
 228 Previously notmuch insisted on being able to find GMime 2.4, (even
 229 though GMime 2.6 would have worked all along).
 230
 231 ### Fix configure script to accept (and ignore) various standard options
 232
 233 For example, those that the Gentoo build scripts expect configure to
 234 accept are now all accepted.
 235
 236 Test suite
 237 ----------
 238
 239 ### A large number of new tests for the many new features
 240
 241 ### Better display of output from failed tests
 242
 243 Now shows failures with diff rather than forcing the user to gaze at
 244 complete actual and expected output looking for deviation.