[notmuch] search-tags and tag completion in notmuch.el

diff --git a/fe/4232c6ace6cb909185ef45087f025824a05887 b/fe/4232c6ace6cb909185ef45087f025824a05887
new file mode 100644 (file)
index 0000000..b219986
--- /dev/null
+++ b/fe/4232c6ace6cb909185ef45087f025824a05887
@@ -0,0 +1,90 @@
+Return-Path: <jan@ryngle.com>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 917FF431FBC\r
+       for <notmuch@notmuchmail.org>; Sun, 22 Nov 2009 16:56:16 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id z-sMjSmbmd05 for <notmuch@notmuchmail.org>;\r
+       Sun, 22 Nov 2009 16:56:16 -0800 (PST)\r
+Received: from fg-out-1718.google.com (fg-out-1718.google.com [72.14.220.152])\r
+       by olra.theworths.org (Postfix) with ESMTP id 12090431FAE\r
+       for <notmuch@notmuchmail.org>; Sun, 22 Nov 2009 16:56:15 -0800 (PST)\r
+Received: by fg-out-1718.google.com with SMTP id 19so643107fgg.2\r
+       for <notmuch@notmuchmail.org>; Sun, 22 Nov 2009 16:56:15 -0800 (PST)\r
+Received: by 10.103.205.19 with SMTP id h19mr443289muq.60.1258937775085;\r
+       Sun, 22 Nov 2009 16:56:15 -0800 (PST)\r
+Received: from x61s.janakj (r2c34.net.upc.cz [62.245.66.34])\r
+       by mx.google.com with ESMTPS id 25sm14323953mul.20.2009.11.22.16.56.14\r
+       (version=TLSv1/SSLv3 cipher=RC4-MD5);\r
+       Sun, 22 Nov 2009 16:56:14 -0800 (PST)\r
+Received: by x61s.janakj (Postfix, from userid 1000)\r
+       id E1CE4440651; Mon, 23 Nov 2009 01:56:04 +0100 (CET)\r
+From: Jan Janak <jan@ryngle.com>\r
+To: notmuch@notmuchmail.org\r
+Date: Mon, 23 Nov 2009 01:56:04 +0100\r
+Message-ID: <87pr7a5aaj.fsf@ryngle.com>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+Subject: [notmuch] search-tags and tag completion in notmuch.el\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.12\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Mon, 23 Nov 2009 00:56:16 -0000\r
+\r
+Hello,\r
+\r
+The three patches I sent to the list a couple of minutes ago is another\r
+revision of the patches that I had sent earlier. The first two patches\r
+implement support for 'notmuch search-tags'. The last patch adds support\r
+for tag completion to notmuch.el using the new command.\r
+\r
+Right now 'notmuch search-tags' can only list all tags from the\r
+database, it does not support search-terms yet (i.e. it cannot list tags\r
+for a restricted set of messages or threads), but I am working on that\r
+feature and I'm gonna send another patch implementing that soon. I think\r
+sending more smaller incremental patches makes it easier to review them\r
+(and for me personally it is easier to keep them up-to-date on top of\r
+moving Carl's git repository).\r
+\r
+I considered implementing 'notmuch search --output=tags' (as we\r
+discussed in another email), but it turned out that:\r
+\r
+  * Having 'notmuch search-tags' would be consistent with Carl's\r
+    'notmuch search-messages'.\r
+\r
+  * 'notmuch search' supports other command line options (--first,\r
+    --max-threads, --sort) and these would only work when the user uses\r
+    the command to search for messages. They would probably be useless\r
+    if we use the command to search for tags and messages (well, at\r
+    least some of them). Which means we would have to let the user know\r
+    in the documentation, or disable some of them based on the value of\r
+    the --output command line parameter, etc etc...\r
+\r
+  * 'notmuch search-tags' is easier on fingers than \r
+    'notmuch search --output=tags' :-).\r
+\r
+In any case, we should probably keep it consistent with other commands\r
+and because Carl submitted 'notmuch search-messages", I did the same for\r
+tags.\r
+\r
+I'd personally prefer to use different commands for different kinds of\r
+output rather than overloading 'notmuch search' with more command line\r
+options, but it's just a personal preference. I can change the patch\r
+again if we decide that we're going to overload 'notmuch search' rather\r
+than add more commands.\r
+\r
+Comments, ideas, and suggestions are welcome!\r
+\r
+  -- Jan\r