Add documentation for C interface

First shot...
Yeah. ;-)

Such a pity though that C highlighting appears to highlight cpp keywords as well. Bummer!