X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=README;h=9caf32dc84f5965f38e87fb11bea980e5e0b7fd4;hb=2dd0cf8f5bbf63c0e0a423344de95e9d433bf7af;hp=3fbdab1b89d29208bf4740ce133f8c9367a99a83;hpb=90c47567f4a165a62420a79da9a7f5b2ef8addce;p=notmuch

diff --git a/README b/README
index 3fbdab1b..9caf32dc 100644
--- a/README
+++ b/README
@@ -1,15 +1,47 @@
+cnotmuch -- The python interface to notmuch.so
+==============================================
+
+This module makes the functionality of the notmuch library
+(`http://notmuchmail.org`_) available to python. Successful import of
+this modul depends on a libnotmuch.so|dll being available on the
+user's system.
+
+If you have downloaded the full source tarball, you can create the
+documentation with sphinx installed, go to the docs directory and
+"make html". A static version of the documentation is available at:
+
+`http://spaetz.bitbucket.org`_
+
+The current source code is being hosted at
+http://bitbucket.org/spaetz/cnotmuch which also provides an issue
+tracker, and release downloads. This package is tracked by the python
+package index repository at `http://pypi.python.org/pypi/cnotmuch`_ and can thus be installed on a user's computer easily via "sudo easy_install cnotmuch" (you will still need to install the notmuch shared library separately as it is not included in this package).
+
+The original source has been provided by (c)Sebastian Spaeth, 2010.
+All code is available under the GNU GPLv3+ (see docs/COPYING) unless specified otherwise.
+
+
+Usage
+-----
+For more examples of how to use the cnotmuch interface, have a look at the
+notmuch "binary" and the generated documentation.
+
+Example session:
 >>>from cnotmuch import notmuch
 >>>db = notmuch.Database("/home/spaetz/mail")
 db.get_path()
 '/home/spaetz/mail'
 >>>tags = db.get_all_tags()
-inited tags with 44762960 'Notmuch DB /home/spaetz/mail'
 >>>for tag in tags: 
 >>>  print tag
 inbox
 ...
 maildir::draft
-Freeing the Tags now
+#---------------------------------------------
+
+q = notmuch.Query(db,'from:Sebastian')
+count = len(q.search_messages())
+1300
 
 #---------------------------------------------
 
@@ -20,5 +52,3 @@ NotmuchError: Could not open the specified database
 
 >>>tags = notmuch.Database("/home/spaetz/mail").get_all_tags()
 >>>del(tags)
-Freeing the Tags now
-Freeing the database now
\ No newline at end of file