GObject macros are nice you know

Also move doc-y comments to be gtk-doc style comments