documented all symbols

  - some of the header got non-comment changes to make gtk-doc understand
    the syntax like typedef function pointers first to document them.
  - removed a few functions that where declared but not implemented