Skip to content

Prettify the documentation with links

Federico Mena Quintero requested to merge federico/librsvg:prettify-docs into main

Fixes #828 (closed), #834 (closed).

One thing that concerns me: I discovered that docs for deprecated functions like rsvg_handle_set_size_callback() were not being generated, and this is because some old #ifndef __GI_SCANNER__ from 2011 (!) meant to exclude those functions from gtk-doc.

However, especially the size callback function is referenced from the docs for RsvgPositionData and friends... so the MR causes deprecated functions to not be excluded from the documentation.

However! This in turn causes the functions to be introspected, and therefore there's no need to have them written by hand in the custom.vala file anymore. Hopefully the introspection data won't change their Vala prototypes... (but they are deprecated! Don't use them!).

Edited by Federico Mena Quintero

Merge request reports