From: Carl Worth <cworth@cworth.org>
To: notmuch@notmuchmail.org
Subject: Deprecated notmuch "part" and "search-tags" commands
User-Agent: Notmuch/0.5 (http://notmuchmail.org) Emacs/23.3.1
	(i486-pc-linux-gnu)
Date: Tue, 24 May 2011 12:59:05 -0700
Message-ID: <87vcwzlvjq.fsf@yoom.home.cworth.org>
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-=";
	micalg=pgp-sha1; protocol="application/pgp-signature"
Precedence: list

--=-=-=
Content-Transfer-Encoding: quoted-printable

I just merged some changes by Jameson to move from the "notmuch part
=2D-part=3DX" command to instead use "notmuch show --part=3DX". This is
fundamentally more powerful since the various --format=3Dtext|json|raw
options can now be used while limiting which message parts are show with
=2D-part. [*] It's also a nice code reduction.

But I didn't want to break existing interfaces that might be calling
"notmuch part", (for example, somebody updating the notmuch command-line
but still using the older emacs interface).

So I just added simple support to the notmuch main program to support
aliases. With this, the "notmuch part" command is still supported by
being treated as an alias for "notmuch show --format=3Draw".

With the alias support in place, I also switched "notmuch search-tags"
to now be an alias for "notmuch search --output=3Dtags *". That was a
further code reduction.

Currently, the aliases are not documented at all---the idea being that
they exist only to support interfaces still using deprecated commands.

I just wanted everyone to be aware of these recent changes. I'd be glad
to take any feedback here. Let me know.

Me, I'm quite happy to see the list of commands from "notmuch help" get
shorter by two commands, (without any reduction in available
functionality).

=2DCarl

[*] Though the JSON formatter still gives up on non-text parts. We might
want to extend it to encapsulate non-text parts within the json output
somehow.

=2D-=20
carl.d.worth@intel.com

--=-=-=
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)

iEYEARECAAYFAk3cDgkACgkQ6JDdNq8qSWjvNgCdE+iyB76KApMeAXTBl3qiZBS6
4RkAn2JPNpFCxxvZis14o4YyW6Wj5itV
=uE5y
-----END PGP SIGNATURE-----
--=-=-=--