e-d-s installs camel-i18n.h as a fully obsolete set of convenience macros. Those macros have the same names as generally available functions from other popular libraries. That's not a problem. But if the gtk-doc documentation for those macros is installed, gtk-doc then thinks that this is *the* place that the symbols/macros are defined. What should be a limited-use item becomes the global definition. When other packages build *their* gtk-doc, they default to linking (for example) "gettext" to the camel-i18n gtk-doc entry.

This is not just an end-user problem. The current stable distro of glib (2.22.4) comes with pregenerated documentation that was clearly built on a machine that had camel gtk-doc visible: so all glib gettext links point to camel gtk-doc files.

Is there an -overrides or other way to avoid making the camel-i18n documentation so public? Can the specific entries be left out, and instead just have a note "this is obsolete, nothing should be using it" (avoids breaking existing incoming links)? Has there been anything that uses that header at all in anyone's recent memory, or else could it just be scrapped entirely? Or just rewritten on top of glib/gi18n.h and glib/gi18n-lib.h rather that declaring *anything* itself?