doc/source/c++/api.rst: Document the C++ bindings.

1 files changed, 24 insertions, 2 deletions

diff --git a/doc/source/c++/embedding.rst b/doc/source/c++/embedding.rst
index e5816eb7..b04e0d78 100644
--- a/doc/source/c++/embedding.rst
+++ b/doc/source/c++/embedding.rst
@@ -1,5 +1,27 @@
+.. highlightlang:: c++
+
 Embedding Python APT
 ====================
-.. note::
+This is a very basic tutorial for working with the C++ bindings.
+
+Basics
+-------
+To use the python-apt C++ bindings, first include the
+``python-apt/python-apt.h`` header::
+
+    #include <python-apt/python-apt.h>
+
+Now, the module needs to be initialized. This is done by calling the function
+:cfunc:`import_apt_pkg`. This function returns 0 on success and a negative
+value in case of failure::
+
+    if (import_apt_pkg() < 0)
+        return;
+
+Longer example
+--------------
+The following code will create a standalone application which provides a
+module ``client`` with the attribute ``hash`` which stores an object of the
+type :class:`apt_pkg.HashString`:
 
-    The C++ API is experimental and not really documented yet.
+.. literalinclude:: ../../client-example.cc