docs: fix gtk-doc warnings
Move MT safety to main description (it does not belong to Return: or Since: statement). Add a few missing return docs. Downgrade a normal comment froma doc comment. Fix a doc header to only contain symbol name.
Showing with 12 additions and 12 deletions