From: Austin Clements <amdragon@MIT.EDU>
Date: Mon, 7 Oct 2013 22:48:51 +0000 (-0400)
Subject: emacs: Improved `notmuch-describe-keymap' documentation
X-Git-Tag: 0.17_rc1~106
X-Git-Url: https://git.notmuchmail.org/git?a=commitdiff_plain;ds=sidebyside;h=459c5869678161495076f166264a967243c233f4;p=notmuch

emacs: Improved `notmuch-describe-keymap' documentation
---

diff --git a/emacs/notmuch.el b/emacs/notmuch.el
index e5594722..c47c6b56 100644
--- a/emacs/notmuch.el
+++ b/emacs/notmuch.el
@@ -141,10 +141,15 @@ This is basically just `format-kbd-macro' but we also convert ESC to M-."
       (concat desc " "))))
 
 (defun notmuch-describe-keymap (keymap ua-keys &optional prefix tail)
-  "Return a list of strings, each describing one key in KEYMAP.
+  "Return a list of strings, each describing one binding in KEYMAP.
 
-Each string gives a human-readable description of the key and the
-first line of documentation for the bound function."
+Each string gives a human-readable description of the key and a
+one-line description of the bound function.  See `notmuch-help'
+for an overview of how this documentation is extracted.
+
+UA-KEYS should be a key sequence bound to `universal-argument'.
+It will be used to describe bindings of commands that support a
+prefix argument.  PREFIX and TAIL are used internally."
   (map-keymap
    (lambda (key binding)
      (cond ((mouse-event-p key) nil)