Document the public API

I've added doxygen comments to the public header file, and also a
Doxygen configuration file, but no Makefile (yet).

Signed-off-by: Petr Tesarik <ptesarik@suse.cz>