X-Git-Url: https://git.cworth.org/git?p=notmuch-wiki;a=blobdiff_plain;f=bindings.mdwn;h=9352aba1d973051c1c818e634533c6782b201f4d;hp=e52030c799ecdcd4a60638df4a532d9d73c5b9a2;hb=HEAD;hpb=6f90b0f48f05286ebefc3b6bc226ebb9cdad5b3c

diff --git a/bindings.mdwn b/bindings.mdwn
index e52030c..9288c0a 100644
--- a/bindings.mdwn
+++ b/bindings.mdwn
@@ -1,17 +1,46 @@
 [[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
 # Notmuch Language Bindings [DRAFT]
 
-The Notmuch library, `libnotmuch`, can be used from many programming languages
-using the Notmuch language bindings. The [[command line interface|manpages]] and
-many of the [[email clients and frontends|frontends]] are based on the language
-bindings.
+The Notmuch library, `libnotmuch`, can be used from many programming
+languages using the Notmuch language bindings. The [command line
+interface](https://notmuchmail.org/doc/latest/man1/notmuch.html) and
+the [[email clients and frontends|frontends]] are based on the
+language bindings.
 
 [[!toc levels=2]]
 
 ## C and C++
 
+`libnotmuch` is a shared C library. [The API](https://git.notmuchmail.org/git/notmuch/blob/HEAD:/lib/notmuch.h)
+
+The Notmuch command-line interface is based on the C library.
+
 ## Python
 
+Notmuch includes Python bindings to the Notmuch shared library. Please refer to
+the nice and extensive [Notmuch Python API
+documentation](https://notmuchmail.org/doc/latest/python-bindings.html).
+
+The bindings are very simple to use. As an example, given you have the Python
+bindings installed (or simply set your PYTHONPATH environment variable to point
+to the .../bindings/python directory), this snippet will produce a list of mails
+matching the given expression:
+
+        >>> from notmuch2 import Database
+        >>> db = Database()
+        >>> messages = list(db.messages('tag:inbox AND NOT tag:killed'))
+        [...]
+
+[The source](https://git.notmuchmail.org/git/notmuch/tree/HEAD:/bindings/python-cffi/)
+
 ## Ruby
 
+[The source](https://git.notmuchmail.org/git/notmuch/tree/HEAD:/bindings/ruby/)
+
+The [client for
+vim](https://git.notmuchmail.org/git/notmuch/blob/HEAD:/vim/README) is in Ruby,
+so worth a look.
+
 ## Go
+
+[The source](https://git.notmuchmail.org/git/notmuch/tree/HEAD:/contrib/go/)