core: Add some gtk-doc

Just documenting a few functions to get in the habit of things.