gi-docgen is a new tool that tries to avoid some of the issues of gtk-doc and is also faster.
gi-docgen
gtk-doc