Deprecated notmuch "part" and "search-tags" commands

diff --git a/8a/8251f2e4c6d29d7a74fb87a2fe236af4d2522e b/8a/8251f2e4c6d29d7a74fb87a2fe236af4d2522e
new file mode 100644 (file)
index 0000000..b0ae1fe
--- /dev/null
+++ b/8a/8251f2e4c6d29d7a74fb87a2fe236af4d2522e
@@ -0,0 +1,99 @@
+Return-Path: <cworth@cworth.org>\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 321AA431FD0\r
+       for <notmuch@notmuchmail.org>; Tue, 24 May 2011 12:59:14 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0.01\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0.01 tagged_above=-999 required=5\r
+       tests=[T_MIME_NO_TEXT=0.01] autolearn=disabled\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 lZ9RsY--T+Rg for <notmuch@notmuchmail.org>;\r
+       Tue, 24 May 2011 12:59:12 -0700 (PDT)\r
+Received: from arlo.cworth.org (arlo.cworth.org [50.43.72.2])\r
+       by olra.theworths.org (Postfix) with ESMTP id CDF9A431FB6\r
+       for <notmuch@notmuchmail.org>; Tue, 24 May 2011 12:59:12 -0700 (PDT)\r
+Received: from yoom.home.cworth.org (localhost [127.0.0.1])\r
+       by arlo.cworth.org (Postfix) with ESMTP id C96D029A51A\r
+       for <notmuch@notmuchmail.org>; Tue, 24 May 2011 12:59:11 -0700 (PDT)\r
+Received: by yoom.home.cworth.org (Postfix, from userid 1000)\r
+       id BA8CA25417E; Tue, 24 May 2011 12:59:11 -0700 (PDT)\r
+From: Carl Worth <cworth@cworth.org>\r
+To: notmuch@notmuchmail.org\r
+Subject: Deprecated notmuch "part" and "search-tags" commands\r
+User-Agent: Notmuch/0.5 (http://notmuchmail.org) Emacs/23.3.1\r
+       (i486-pc-linux-gnu)\r
+Date: Tue, 24 May 2011 12:59:05 -0700\r
+Message-ID: <87vcwzlvjq.fsf@yoom.home.cworth.org>\r
+MIME-Version: 1.0\r
+Content-Type: multipart/signed; boundary="=-=-=";\r
+       micalg=pgp-sha1; protocol="application/pgp-signature"\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\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: Tue, 24 May 2011 19:59:14 -0000\r
+\r
+--=-=-=\r
+Content-Transfer-Encoding: quoted-printable\r
+\r
+I just merged some changes by Jameson to move from the "notmuch part\r
+=2D-part=3DX" command to instead use "notmuch show --part=3DX". This is\r
+fundamentally more powerful since the various --format=3Dtext|json|raw\r
+options can now be used while limiting which message parts are show with\r
+=2D-part. [*] It's also a nice code reduction.\r
+\r
+But I didn't want to break existing interfaces that might be calling\r
+"notmuch part", (for example, somebody updating the notmuch command-line\r
+but still using the older emacs interface).\r
+\r
+So I just added simple support to the notmuch main program to support\r
+aliases. With this, the "notmuch part" command is still supported by\r
+being treated as an alias for "notmuch show --format=3Draw".\r
+\r
+With the alias support in place, I also switched "notmuch search-tags"\r
+to now be an alias for "notmuch search --output=3Dtags *". That was a\r
+further code reduction.\r
+\r
+Currently, the aliases are not documented at all---the idea being that\r
+they exist only to support interfaces still using deprecated commands.\r
+\r
+I just wanted everyone to be aware of these recent changes. I'd be glad\r
+to take any feedback here. Let me know.\r
+\r
+Me, I'm quite happy to see the list of commands from "notmuch help" get\r
+shorter by two commands, (without any reduction in available\r
+functionality).\r
+\r
+=2DCarl\r
+\r
+[*] Though the JSON formatter still gives up on non-text parts. We might\r
+want to extend it to encapsulate non-text parts within the json output\r
+somehow.\r
+\r
+=2D-=20\r
+carl.d.worth@intel.com\r
+\r
+--=-=-=\r
+Content-Type: application/pgp-signature\r
+\r
+-----BEGIN PGP SIGNATURE-----\r
+Version: GnuPG v1.4.11 (GNU/Linux)\r
+\r
+iEYEARECAAYFAk3cDgkACgkQ6JDdNq8qSWjvNgCdE+iyB76KApMeAXTBl3qiZBS6\r
+4RkAn2JPNpFCxxvZis14o4YyW6Wj5itV\r
+=uE5y\r
+-----END PGP SIGNATURE-----\r
+--=-=-=--\r