GLib’s API is fairly low level, and it’s hard to introspect completely as it is mainly meant to be consumed by C developers. Since the generated documentation is extracted from the introspection data, we need to use extra content files in order to represent it.

Thanks Emmanuele, having precise descriptions of those C macros is very useful for people working on GTK bindings.