X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=emacstips.mdwn;h=1109716c5c3a849d8148643c751e8d02477e2190;hb=49f5b974cd18f68679ccdae374875edcb76c64fd;hp=2cc8aac748e2851ae364743567518cabacacfa49;hpb=3b430fc8fb45f08ad64e5efc4613e0346f76e0f7;p=obsolete%2Fnotmuch-wiki diff --git a/emacstips.mdwn b/emacstips.mdwn index 2cc8aac..1109716 100644 --- a/emacstips.mdwn +++ b/emacstips.mdwn @@ -3,13 +3,17 @@ One of the more popular notmuch message reading clients is **notmuch.el**, an [emacs](http://www.gnu.org/software/emacs/) major mode for interacting with notmuch. It is included in the notmuch -package. This page goes over some usage tips for using notmuch with -Emacs. +package (notmuch-emacs in Debian). This page goes over some usage +tips for using notmuch with Emacs. [[!toc levels=2]] ## Setup +Have a look at the [Howto](http://notmuchmail.org/howto/) for +prerequisites. Be sure you have done the general setup using the +notmuch cli command! + To use the Notmuch emacs mode, first add the following line to your `.emacs` rc file: @@ -25,8 +29,11 @@ notmuch` from within a running emacs. ## Navigating & reading mails When first starting notmuch in emacs, you will be presented with the -notmuch "hello" page. From here you can do searches, see lists of -recent searches, saved searches, message tags, help information, etc. +notmuch "hello" page. If it exits with an error after writing +"Welcome to notmutch. You have" you need to do the basic notmuch setup +first (see above). +From here you can do searches, see lists of recent +searches, saved searches, message tags, help information, etc. Executing a search will open a new buffer in `notmuch-search-mode` displaying the search results. Each line in the search results @@ -268,12 +275,19 @@ And in search mode: The Emacs interface to notmuch will automatically add an `Fcc` header to your outgoing mail so that any messages you send will also be saved in your mail store. You can control where this copy of the -message is saved by setting the variables `message-directory` (which -defines a base directory) and `notmuch-fcc-dirs` which defines the -subdirectory relative to `message-directory` in which to save the -mail. Enter a directory (without the maildir `/cur` ending which -will be appended automatically). To customize both variables at the -same time, use the fancy command: +message is saved by setting the variable `notmuch-fcc-dirs` which defines the +subdirectory relative to the `database.path` setting from your +notmuch configuration in which to save the mail. Enter a directory +(without the maildir `/cur` ending which will be appended +automatically). Additional information can be found as usual using: + + M-x describe-variable notmuch-fcc-dirs + +An additional variable that can affect FCC settings in some cases is +`message-directory`. Emacs message-mode uses this variable for +postponed messages. + +To customize both variables at the same time, use the fancy command: M-x customize-apropos\(notmuch-fcc-dirs\)\|\(message-directory\) @@ -584,7 +598,7 @@ buffer. Mailman mailing list software rewrites and rewraps long message subjects in a way that causes TABs to appear in the middle of the subject and header -lines. Add this to your .emacs to replace tabs with spaces in subject +lines. Add this to your `.emacs` to replace tabs with spaces in subject lines: (defun notmuch-show-subject-tabs-to-spaces () @@ -602,7 +616,48 @@ notmuch version 0.15): (defun notmuch-show-header-tabs-to-spaces () "Replace tabs with spaces in header line." (setq header-line-format - (notmuch-show-strip-re - (replace-regexp-in-string "\t" " " (notmuch-show-get-subject))))) + (notmuch-show-strip-re + (replace-regexp-in-string "\t" " " (notmuch-show-get-subject))))) (add-hook 'notmuch-show-hook 'notmuch-show-header-tabs-to-spaces) + +## Hiding unread messages in notmuch-show + +I like to have an inbox saved search, but only show unread messages when they +view a thread. This takes two steps: + +1. Apply +[this patch from Mark Walters](http://notmuchmail.org/pipermail/notmuch/2012/010817.html) +to add the `notmuch-show-filter-thread` function. +1. Add the following hook to your emacs configuration: + + (defun expand-only-unread-hook () (interactive) + (let ((unread nil) + (open (notmuch-show-get-message-ids-for-open-messages))) + (notmuch-show-mapc (lambda () + (when (member "unread" (notmuch-show-get-tags)) + (setq unread t)))) + (when unread + (let ((notmuch-show-hook (remove 'expand-only-unread-hook notmuch-show-hook))) + (notmuch-show-filter-thread "tag:unread"))))) + + (add-hook 'notmuch-show-hook 'expand-only-unread-hook) + +## Changing the color of a saved search based on some other search + +I like to have a saved search for my inbox, but have it change color when there +are thread with unread messages in the inbox. I accomplish this with the +following code in my emacs config: + + (defun color-inbox-if-unread () (interactive) + (save-excursion + (goto-char (point-min)) + (let ((cnt (car (process-lines "notmuch" "count" "tag:inbox and tag:unread")))) + (when (> (string-to-number cnt) 0) + (save-excursion + (when (search-forward "inbox" (point-max) t) + (let* ((overlays (overlays-in (match-beginning 0) (match-end 0))) + (overlay (car overlays))) + (when overlay + (overlay-put overlay 'face '((:inherit bold) (:foreground "green"))))))))))) + (add-hook 'notmuch-hello-refresh-hook 'color-inbox-if-unread)