DEPRECATED_FOR macos confuse gtkdoc-scan
I’m trying to debug when some symbols that are marked as deprecated are missing from HarfBuzz documentation, and it seems that gtkdoc-scan has trouble with DEPRECATED_FOR()
macros. Here is a simplified test.h
file:
HB_EXTERN HB_DEPRECATED_FOR (hb_ot_tags_from_script_and_language) hb_tag_t
hb_ot_tag_from_language (hb_language_t language);
Calling gtkdoc-scan --module=harfbuzz --ignore-decorators='HB_EXTERN|HB_DEPRECATED_FOR ()' test.h
will produce a harfbuzz-
harfbuzz-decl.txt` with:
<FUNCTION>
<NAME>HB_DEPRECATED_FOR</NAME>
<DEPRECATED/>
<RETURNS>HB_EXTERN</RETURNS>
hb_ot_tags_from_script_and_language) hb_tag_t hb_ot_tag_from_language (hb_language_t language
</FUNCTION>
Which is not what one would expect.