Add documentation for C interface

First shot...
A tab character crept in. Wanted to tix it, but for some reason my working copy is inconsistent with the origin/master even though I have checked it out.