lots of bugfixes, also due to the creation of a couple of examples
for the C and C++ interface. Updated documentation accordingly

Signed-off-by: Luca Fulchir <luker@fenrirproject.org>