"void routine(a,b, &c_out) " miss documented
The actual code is in a recent change I made in harfbuzz, a few days ago.
/* @c: (out): */ void myroutine(a, b, c)
should be translated and documented by g-ir-doc-tool to python as:
c = myroutine(a,b)
And indeed the typelib etc works that way.
but in the generated documentation, it is kept as
myroutine(a, b, c)
I tried pgi-docgen and it works correctly there.
I'll put the actual harfbuzz here at some point.