gtk-doc deprecated warning

[jcupitt gmail com]

Hi all,

gtk-doc is tagging some things in my library as deprecated, but I've
no idea why. For example:

http://www.vips.ecs.soton.ac.uk/development/8.3/doc/html/libvips/libvips-vips.html#VIPS-INIT:CAPS

Generated from this macro:

https://github.com/jcupitt/libvips/blob/master/libvips/include/vips/vips.h#L166

and this comment:

https://github.com/jcupitt/libvips/blob/master/libvips/iofuncs/init.c#L126

What are the rules for generating the "deprecated" warning? Does
anyone have any tips for tracking this down?

John