A fix for the bug in gtk-doc that causes the cairo documentation bug https://bugs.freedesktop.org/show_bug.cgi?id=28060 has been committed. So to the person doing the next release: please use gtk-doc git master to generate the docs for cairographics.org/manual. Afterwards, the cairo bug can be closed. Maarten