Re: [GTK+ hard code freeze] Revert gtk_menu_popup API break

[Matthias Clasen <matthias clasen gmail com>]

On Mon, Mar 19, 2012 at 10:16 AM, Martin Pitt <martin pitt ubuntu com> wrote:

>> If the documentation does not match, that is clearly a bug in the
>> implementation of 'Rename to'.
>
> No, it's not. If you export two functions a(int, char*) and b(char*),
> and then you rename "a" to "b", then the C documentation for b will
> still say (char*), but your function actually takes (int, char*).

Yes, the C documentation documents the C api.

But I would expect that the introspection tools, when faced with a
"rename a to b" annotation would also be smart enough to put a's
documentation in the gir under the name b.