X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=emacs%2Fnotmuch-query.el;h=3a835a002ee7bdc5c3ee1f52c1c4ecb74aa42bee;hp=563e4acf57df3ab2c017085aea4c03d0677c3b72;hb=ed40579ad3882e6f9bbe9b1ba5e707ab289ca203;hpb=507d2f07a6c74eea86f87b637d0b67a0ddc1fc81 diff --git a/emacs/notmuch-query.el b/emacs/notmuch-query.el index 563e4acf..3a835a00 100644 --- a/emacs/notmuch-query.el +++ b/emacs/notmuch-query.el @@ -28,8 +28,7 @@ A thread is a forest or list of trees. A tree is a two element list where the first element is a message, and the second element -is a possibly empty forest of replies. -" +is a possibly empty forest of replies." (let ((args '("show" "--format=sexp" "--format-version=4"))) (if notmuch-show-process-crypto (setq args (append args '("--decrypt=true")))) @@ -40,7 +39,7 @@ is a possibly empty forest of replies. ;; Mapping functions across collections of messages. (defun notmuch-query-map-aux (mapper function seq) - "private function to do the actual mapping and flattening" + "Private function to do the actual mapping and flattening." (apply 'append (mapcar (lambda (tree) @@ -48,20 +47,20 @@ is a possibly empty forest of replies. seq))) (defun notmuch-query-map-threads (fn threads) - "apply FN to every thread in THREADS. Flatten results to a list. + "Apply FN to every thread in THREADS. Flatten results to a list. See the function notmuch-query-get-threads for more information." (notmuch-query-map-aux 'notmuch-query-map-forest fn threads)) (defun notmuch-query-map-forest (fn forest) - "apply function to every message in a forest. Flatten results to a list. + "Apply function to every message in a forest. Flatten results to a list. See the function notmuch-query-get-threads for more information. " (notmuch-query-map-aux 'notmuch-query-map-tree fn forest)) (defun notmuch-query-map-tree (fn tree) - "Apply function FN to every message in TREE. Flatten results to a list + "Apply function FN to every message in TREE. Flatten results to a list. See the function notmuch-query-get-threads for more information." (cons (funcall fn (car tree)) (notmuch-query-map-forest fn (cadr tree)))) @@ -70,7 +69,7 @@ See the function notmuch-query-get-threads for more information." ;; Predefined queries (defun notmuch-query-get-message-ids (&rest search-terms) - "Return a list of message-ids of messages that match SEARCH-TERMS" + "Return a list of message-ids of messages that match SEARCH-TERMS." (notmuch-query-map-threads (lambda (msg) (plist-get msg :id)) (notmuch-query-get-threads search-terms)))