Merge Sebastian Spaeth's python bindings into bindings/python

Sebastian offered to maintain these bindings within the notmuch
repository and offered them in the following repository:

	git://github.com/spaetz/python-notmuch.git

These are the bindings formerly known as "cnotmuch" and now known
simply as "notmuch" from within python.

The bindings are not yet integrated into the build system and
packaging of the primary ntomuch repository.

1 files changed, 68 insertions, 0 deletions

diff --git a/bindings/python/docs/source/notmuch.rst b/bindings/python/docs/source/notmuch.rst
new file mode 100644
index 00000000..32e17833
--- /dev/null
+++ b/bindings/python/docs/source/notmuch.rst
@@ -0,0 +1,68 @@
+The notmuch 'binary'
+====================
+
+The cnotmuch module provides *notmuch*, a python reimplementation of the standard notmuch binary for two purposes: first, to allow running the standard notmuch testsuite over the cnotmuch bindings (for correctness and performance testing) and second, to give some examples as to how to use cnotmuch. 'Notmuch' provides a command line interface to your mail database.
+
+A standard install via `easy_install cnotmuch` will not install the notmuch binary, however it is available in the `cnotmuch source code repository <http://bitbucket.org/spaetz/cnotmuch/src/>`_.
+
+
+It is invoked with the following pattern: `notmuch <command> [args...]`.
+
+Where <command> and [args...] are as follows:
+
+  **setup**	Interactively setup notmuch for first use.
+                This has not yet been implemented, and will probably not be
+		implemented unless someone puts in the effort.
+
+  **new**	[--verbose]
+		Find and import new messages to the notmuch database.
+
+		This has not been implemented yet. We cheat by calling
+		the regular "notmuch" binary (which must be in your path
+		somewhere).
+
+  **search** [options...] <search-terms> [...]  Search for messages matching the given search terms.
+
+		This has been implemented but for the `--format` and
+		`--sort` options.
+
+  **show**	<search-terms> [...]
+		Show all messages matching the search terms.
+
+		This has been partially implemented, we show a stub for each 
+		found message, but do not output the full message body yet.
+
+  **count**	<search-terms> [...]
+		Count messages matching the search terms.
+
+		This has been fully implemented.
+
+  **reply**	[options...] <search-terms> [...]
+		Construct a reply template for a set of messages.
+
+		This has not been implemented yet.
+
+  **tag**	+<tag>|-<tag> [...] [--] <search-terms> [...]
+		Add/remove tags for all messages matching the search terms.
+
+		This has been fully implemented.
+
+  **dump**	[<filename>]
+		Create a plain-text dump of the tags for each message.
+
+		This has been fully implemented.
+  **restore**	<filename>
+		Restore the tags from the given dump file (see 'dump').
+
+		This has been fully implemented.
+
+  **search-tags**	[<search-terms> [...] ]
+		List all tags found in the database or matching messages.
+
+		This has been fully implemented.
+
+  **help**	[<command>]
+		This message, or more detailed help for the named command.
+
+		The 'help' page has been implemented, help for single
+		commands are missing though. Patches are welcome.