Add gtkdoc libnih API docs generation.

This add gtkdoc generated API docs for nih/*.h
Also fixes up a few markup errors.
A generated xml/html snapshot is committed to gh-pages branch in my repository, and should be published at http://xnox.github.io/libnih soon.