Moving interface descriptions to expose more documentation

Interface descriptions were appended to many header files but were not
accessible to doxygen. This change moves /* */ based comments into the
appropriate locations. Move has been assisted with a perl script, so
expect oddities until time allows for hand checking.

http://drawkit.github.io/api/annotated.html will benefit greatly from
this change.