README: add info about high-level bindings
authorBartosz Golaszewski <bartekgola@gmail.com>
Sat, 21 Apr 2018 13:29:33 +0000 (15:29 +0200)
committerBartosz Golaszewski <bartekgola@gmail.com>
Sat, 21 Apr 2018 13:29:33 +0000 (15:29 +0200)
Briefly describe C++ and python bindings.

Signed-off-by: Bartosz Golaszewski <bartekgola@gmail.com>
README

diff --git a/README b/README
index be150f200eba94d02d97f586615dcc74ef5faf57..6309a49ba6631c64a73f9bbe3218f94438701a95 100644 (file)
--- a/README
+++ b/README
@@ -130,6 +130,25 @@ superuser privileges:
 
     sudo ./tests/gpiod-test
 
+BINDINGS
+--------
+
+High-level, object-oriented bindings for C++ and python3 are provided. They
+can be enabled by passing --enable-bindings-cxx and --enable-bindings-python
+arguments respectively to configure.
+
+C++ bindings require C++11 support and autoconf-archive collection if building
+from git.
+
+Python bindings require python3 support and libpython development files. Care
+must be taken when cross-compiling python bindings: users usually must specify
+the PYTHON_CPPFLAGS and PYTHON_LIBS variables in order to point the build
+system to the correct locations. During native builds, the configure script
+can auto-detect the location of the development files.
+
+Both bindings are extensively documented: with doxygen markup in case of C++
+and inline pydoc comments for python.
+
 CONTRIBUTING
 ------------