From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from localhost (localhost [127.0.0.1]) by olra.theworths.org (Postfix) with ESMTP id 5B1C3429E21 for ; Sun, 6 Nov 2011 12:57:29 -0800 (PST) X-Virus-Scanned: Debian amavisd-new at olra.theworths.org X-Spam-Flag: NO X-Spam-Score: -0.7 X-Spam-Level: X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5 tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled Received: from olra.theworths.org ([127.0.0.1]) by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id xxLVia6Cp2nW for ; Sun, 6 Nov 2011 12:57:28 -0800 (PST) Received: from mail-fx0-f53.google.com (mail-fx0-f53.google.com [209.85.161.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) (No client certificate requested) by olra.theworths.org (Postfix) with ESMTPS id DC998431FB6 for ; Sun, 6 Nov 2011 12:57:27 -0800 (PST) Received: by faan15 with SMTP id n15so1732670faa.26 for ; Sun, 06 Nov 2011 12:57:26 -0800 (PST) Received: by 10.223.14.197 with SMTP id h5mr3488019faa.2.1320613046490; Sun, 06 Nov 2011 12:57:26 -0800 (PST) Received: from localhost (dsl-hkibrasgw4-fe5cdc00-23.dhcp.inet.fi. [80.220.92.23]) by mx.google.com with ESMTPS id f4sm19937162faj.1.2011.11.06.12.57.23 (version=SSLv3 cipher=OTHER); Sun, 06 Nov 2011 12:57:24 -0800 (PST) From: Jani Nikula To: Austin Clements Subject: Re: [RFC PATCH v2 3/3] emacs: support limiting the number of results shown in search results In-Reply-To: <20111104205415.GJ22935@mit.edu> References: <0b937eb1103dbb24142a783eff599a7cb08f195e.1320093940.git.jani@nikula.org> <20111104205415.GJ22935@mit.edu> User-Agent: Notmuch/0.9+32~gc0c32d1 (http://notmuchmail.org) Emacs/23.3.1 (i686-pc-linux-gnu) Date: Sun, 06 Nov 2011 22:57:21 +0200 Message-ID: <878vntgea6.fsf@nikula.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: notmuch@notmuchmail.org X-BeenThere: notmuch@notmuchmail.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 06 Nov 2011 20:57:29 -0000 Hi Austin, and many thanks for your comments. Before hacking on notmuch my lisp was mostly limited to ~/.emacs, and unfortunately it shows... On Fri, 4 Nov 2011 16:54:15 -0400, Austin Clements wrote: > Quoth Jani Nikula on Oct 31 at 11:18 pm: > > Add support for limiting the maximum number of results initially displayed > > in search results. When enabled, the search results will contain push > > buttons to double the number of results displayed or to show unlimited > > results. > > > > The approach is inspired by vc-print-log in Emacs vc.el. > > > > Signed-off-by: Jani Nikula > > --- > > emacs/notmuch-hello.el | 17 ++++++++++++-- > > emacs/notmuch.el | 53 +++++++++++++++++++++++++++++++++++++++++++---- > > 2 files changed, 62 insertions(+), 8 deletions(-) > > > > diff --git a/emacs/notmuch-hello.el b/emacs/notmuch-hello.el > > index 65fde75..4ba13e3 100644 > > --- a/emacs/notmuch-hello.el > > +++ b/emacs/notmuch-hello.el > > @@ -26,7 +26,7 @@ > > (require 'notmuch-lib) > > (require 'notmuch-mua) > > > > -(declare-function notmuch-search "notmuch" (query &optional oldest-first target-thread target-line continuation)) > > +(declare-function notmuch-search "notmuch" (query &optional oldest-first maxitems target-thread target-line continuation)) > > (declare-function notmuch-poll "notmuch" ()) > > > > (defvar notmuch-hello-search-bar-marker nil > > @@ -37,6 +37,17 @@ > > :type 'integer > > :group 'notmuch) > > > > +(defcustom notmuch-search-maxitems 0 > > + "The maximum number of results to show in search results. > > + > > +This variables controls the maximum number of results to > > +initially show in search results. Set to 0 to not limit the > > +number of results. If non-zero, the search results will contain > > +push buttons to double the number (can be repeated) or show > > +unlimited number of results." > > + :type 'integer > > + :group 'notmuch) > > + > > It would be more lispy to use nil to indicate no limit, rather than 0. > The type could be something like > (choice (const :tag "Unlimited" nil) > (integer :tag "Limit")) Definitely better. > > (defcustom notmuch-show-empty-saved-searches nil > > "Should saved searches with no messages be listed?" > > :type 'boolean > > @@ -151,7 +162,7 @@ Typically \",\" in the US and UK and \".\" in Europe." > > (defun notmuch-hello-search (search) > > (let ((search (notmuch-hello-trim search))) > > (notmuch-hello-remember-search search) > > - (notmuch-search search notmuch-search-oldest-first nil nil #'notmuch-hello-search-continuation))) > > + (notmuch-search search notmuch-search-oldest-first notmuch-search-maxitems nil nil #'notmuch-hello-search-continuation))) > > It might make more sense of notmuch-search to use the value of > notmuch-search-maxitems directly, rather than feeding it in > everywhere, especially since it's buffer-local. If there's really a > place that needs to override it, it would be easy to let-bind the > variable there. The only problem with that is that doubling the number of results is done using notmuch-search-refresh-view, which kills the buffer and performs a new search, which creates a new buffer. That loses the doubled buffer-local value, doesn't it? The Right Thing might be to use --first and --maxitems to only fetch the missing results while preserving the old, but I was hoping that could be a later improvement. It's not that trivial if new messages have been added to the db in between. > > > > (defun notmuch-hello-add-saved-search (widget) > > (interactive) > > @@ -200,7 +211,7 @@ diagonal." > > (defun notmuch-hello-widget-search (widget &rest ignore) > > (notmuch-search (widget-get widget > > :notmuch-search-terms) > > - notmuch-search-oldest-first > > + notmuch-search-oldest-first notmuch-search-maxitems > > nil nil #'notmuch-hello-search-continuation)) > > > > (defun notmuch-saved-search-count (search) > > diff --git a/emacs/notmuch.el b/emacs/notmuch.el > > index f11ec24..741ebe1 100644 > > --- a/emacs/notmuch.el > > +++ b/emacs/notmuch.el > > @@ -193,6 +193,7 @@ For a mouse binding, return nil." > > > > (defvar notmuch-search-mode-map > > (let ((map (make-sparse-keymap))) > > + (set-keymap-parent map widget-keymap) > > (define-key map "?" 'notmuch-help) > > (define-key map "q" 'notmuch-search-quit) > > (define-key map "x" 'notmuch-search-quit) > > @@ -217,7 +218,13 @@ For a mouse binding, return nil." > > (define-key map "a" 'notmuch-search-archive-thread) > > (define-key map "-" 'notmuch-search-remove-tag) > > (define-key map "+" 'notmuch-search-add-tag) > > - (define-key map (kbd "RET") 'notmuch-search-show-thread) > > + ; Some hackery to allow RET both on buttons and messages. There's probably a > > + ; better way to do this... > > + (define-key map (kbd "RET") '(lambda (pos) > > + (interactive "@d") > > + (if (get-char-property pos 'button) > > + (widget-button-press pos) > > + (notmuch-search-show-thread)))) > > Huh. I thought widgets automatically had local keymaps, but maybe > that's only buttons (insert-button type buttons, that is). A local > keymap is probably the right way to do this regardless. Or use > buttons instead of widgets. I'll look into that, thanks. > > (define-key map (kbd "M-RET") 'notmuch-search-show-thread-crypto-switch) > > map) > > "Keymap for \"notmuch search\" buffers.") > > @@ -239,6 +246,7 @@ For a mouse binding, return nil." > > (defvar notmuch-search-target-thread) > > (defvar notmuch-search-target-line) > > (defvar notmuch-search-continuation) > > +(defvar notmuch-search-maxitems) > > > > (defvar notmuch-search-disjunctive-regexp "\\<[oO][rR]\\>") > > > > @@ -373,6 +381,7 @@ Complete list of currently available key bindings: > > (make-local-variable 'notmuch-search-oldest-first) > > (make-local-variable 'notmuch-search-target-thread) > > (make-local-variable 'notmuch-search-target-line) > > + (make-local-variable 'notmuch-search-maxitems) > > (set (make-local-variable 'notmuch-search-continuation) nil) > > (set (make-local-variable 'scroll-preserve-screen-position) t) > > (add-to-invisibility-spec 'notmuch-search) > > @@ -633,6 +642,11 @@ This function advances the next thread when finished." > > (insert "End of search results.") > > (if (not (= exit-status 0)) > > (insert (format " (process returned %d)" exit-status))) > > + (if (and notmuch-search-maxitems > > + (< 0 notmuch-search-maxitems) > > + (< notmuch-search-maxitems > > + (count-lines (point-min) (point-max)))) > > + (notmuch-search-setup-buttons)) > > (insert "\n") > > (if (and atbob > > (not (string= notmuch-search-target-thread "found"))) > > @@ -883,7 +897,7 @@ characters as well as `_.+-'. > > ))) > > > > ;;;###autoload > > -(defun notmuch-search (query &optional oldest-first target-thread target-line continuation) > > +(defun notmuch-search (query &optional oldest-first maxitems target-thread target-line continuation) > > "Run \"notmuch search\" with the given query string and display results. > > > > The optional parameters are used as follows: > > @@ -899,6 +913,7 @@ The optional parameters are used as follows: > > (notmuch-search-mode) > > (set 'notmuch-search-query-string query) > > (set 'notmuch-search-oldest-first oldest-first) > > + (set 'notmuch-search-maxitems maxitems) > > (set 'notmuch-search-target-thread target-thread) > > (set 'notmuch-search-target-line target-line) > > (set 'notmuch-search-continuation continuation) > > @@ -916,6 +931,11 @@ The optional parameters are used as follows: > > (if oldest-first > > "--sort=oldest-first" > > "--sort=newest-first") > > + (if (and maxitems (< 0 maxitems)) > > + (if oldest-first > > + (format "--first=-%d" maxitems) > > + (format "--maxitems=%d" maxitems)) > > + "") > > query))) > > (set-process-sentinel proc 'notmuch-search-process-sentinel) > > (set-process-filter proc 'notmuch-search-process-filter)))) > > @@ -932,13 +952,36 @@ same relative position within the new buffer." > > (interactive) > > (let ((target-line (line-number-at-pos)) > > (oldest-first notmuch-search-oldest-first) > > + (maxitems notmuch-search-maxitems) > > (target-thread (notmuch-search-find-thread-id)) > > (query notmuch-search-query-string) > > (continuation notmuch-search-continuation)) > > (notmuch-kill-this-buffer) > > - (notmuch-search query oldest-first target-thread target-line continuation) > > + (notmuch-search query oldest-first maxitems target-thread target-line continuation) > > (goto-char (point-min)))) > > > > +(defun notmuch-search-double-results (&rest ignore) > > + (if notmuch-search-maxitems > > + (set 'notmuch-search-maxitems (* 2 notmuch-search-maxitems))) > > + (notmuch-search-refresh-view)) > > + > > +(defun notmuch-search-unlimited-results (&rest ignore) > > + (set 'notmuch-search-maxitems nil) > > + (notmuch-search-refresh-view)) > > I would recommend setq instead of set, except in the weird local > places where `set' is clearly the prevailing style. There's actually quite a bit of set around, but not enough to make it the prevailing style. Will fix. > > + > > +(defun notmuch-search-setup-buttons () > > + (widget-insert " ") > > + (widget-create 'push-button > > + :notify 'notmuch-search-double-results > > + :help-echo "Double the number of results shown" > > + "Show 2X results") > > + (widget-insert " ") > > + (widget-create 'push-button > > + :notify 'notmuch-search-unlimited-results > > + :help-echo "Show all search results" > > + "Show unlimited results") > > + (widget-setup)) > > + > > If you're limiting from the bottom, would it make more sense for these > widgets to be placed at the top of the buffer, since that's the > direction they'll expand the results? I'm always limiting from the oldest mails (regardless of the sort order) but having the buttons at the top or bottom depending on where the results are expanded does make sense. BR, Jani. > > (defcustom notmuch-poll-script "" > > "An external script to incorporate new mail into the notmuch database. > > > > @@ -997,7 +1040,7 @@ current search results AND the additional query string provided." > > query))) > > (notmuch-search (if (string= notmuch-search-query-string "*") > > grouped-query > > - (concat notmuch-search-query-string " and " grouped-query)) notmuch-search-oldest-first))) > > + (concat notmuch-search-query-string " and " grouped-query)) notmuch-search-oldest-first notmuch-search-maxitems))) > > > > (defun notmuch-search-filter-by-tag (tag) > > "Filter the current search results based on a single tag. > > @@ -1006,7 +1049,7 @@ Runs a new search matching only messages that match both the > > current search results AND that are tagged with the given tag." > > (interactive > > (list (notmuch-select-tag-with-completion "Filter by tag: "))) > > - (notmuch-search (concat notmuch-search-query-string " and tag:" tag) notmuch-search-oldest-first)) > > + (notmuch-search (concat notmuch-search-query-string " and tag:" tag) notmuch-search-oldest-first notmuch-search-maxitems)) > > > > ;;;###autoload > > (defun notmuch () > > -- > Austin Clements MIT/'06/PhD/CSAIL > amdragon@mit.edu http://web.mit.edu/amdragon > Somewhere in the dream we call reality you will find me, > searching for the reality we call dreams.