added a section about helm and address completion

[notmuch-wiki] / emacstips.mdwn

diff --git a/emacstips.mdwn b/emacstips.mdwn
index a6a62c48ec374de0633d2436cf275bf5a18f715f..3f217febaee30b195ef930479e01e452be4112d3 100644 (file)
--- a/emacstips.mdwn
+++ b/emacstips.mdwn
@@ -109,6 +109,14 @@ mentioned as script arguments. (Note: The script expects that you have
         done
         emacsclient -a '' -c -e "(progn (compose-mail) $attach_cmds)"
 
+## Controlling external handlers for attachements
+
+You can choose e.g. which pdf viewer to invoke from notmuch-show mode by
+adding a .mailcap file in your home directory. Here is an example:
+
+    application/pdf; /usr/bin/mupdf %s; test=test "$DISPLAY" != ""; description=Portable Document Format; nametemplate=%s.pdf
+    application/x-pdf; /usr/bin/mupdf %s; test=test "$DISPLAY" != ""; description=Portable Document Format; nametemplate=%s.pdf
+
 ## Issues with Emacs 24
 
 If notmuch-show-mode behaves badly for you in emacs 24.x try adding one of
@@ -492,6 +500,20 @@ As described above, you can now add the following settings to your
         (setq notmuch-address-command "~/bin/akonadimailsearch.sh")
         (notmuch-address-message-insinuate)
 
+### Completion selection with helm
+
+An address query might return multiple possible matches from which you
+will have to select one. To ease this task, several different
+frameworks in emacs support completion selection. One of them is
+[helm](https://github.com/emacs-helm/helm). The following snippet
+improves the out-of-the-box support for helm in notmuch as it enables
+the required-match option and also does not ignore the first returned
+address.
+
+        (setq notmuch-address-selection-function
+          (lambda (prompt collection initial-input)
+            (completing-read prompt (cons initial-input collection) nil t nil 'notmuch-address-history)))
+
 
 ## How to sign/encrypt messages with gpg
 
@@ -521,6 +543,17 @@ part.
   installed, it will shadow the fixed version of easypg included with
   emacs.
 
+## Reading and verifying encrypted and signed messages
+
+Encrypted and signed mime messages can be read and verified with:
+
+        (notmuch-crypto-process-mime t)
+
+Decrypting or verifying inline pgp messages can be done by selecting
+an the inline pgp area and and using:
+
+        M-x epa-decrypt-region RET
+
 ## Multiple identities using gnus-alias
 
 [gnus-alias](http://www.emacswiki.org/emacs/GnusAlias) allows you to
@@ -713,11 +746,11 @@ but as a contrib file, so you might have to work a bit to load it.
 
 In Debian and derivatives,
 
-       (add-to-list 'load-path "/usr/share/org-mode/lisp")
+    (add-to-list 'load-path "/usr/share/org-mode/lisp")
 
 Then
 
-       (require 'org-notmuch)
+    (require 'org-notmuch)
 
 In general it is nice to have a key for org-links (not just for notmuch). For example