Re: linkification warnings

[Stefan Kost <ensonic hora-obscura de>]

Am 18.12.2009 15:58, schrieb Nicola Fontana:
> Il giorno Fri, 18 Dec 2009 13:18:02 +0100
> David Nečas <yeti physics muni cz> ha scritto:
> 
>> 1) A few of my objects have some public, documented fields.  They are
>> marked /*<public>*/ and they appear correctly in the docs.  But I
>> cannot link to them.
>>
>> Writing #GwyRGBA.r where GwyRGBA is a plain struct produces the
>> correct link to the field.  But writing #GwyField.xreal where
>> GwyField is an object struct leads to a warning and no link.  Must
>> something special be done for objects?
> 
> 
> Hi David,
> 
> I think the problem is the link to a struct that is subclassing a
> GObject is renamed to MyStructName+"_struct" [1] (resulting in
> MyStructName-struct after the id mangling). I suppose this is done to
> differentiate the link to the section from the link to the struct in the
> same GObject page, a quite common situation in GTK+.

Uhm, this is nasty. I did not thought about this. That should then be taken into
account by gtk-doc as this "-struct" suffix is a internal detail and when
linking to class memebers that is the desired outcome. Please anyone file
another bug for that.

Stefan

> 
> If this is the case, using #GwyField-struct.xreal should work (I don't
> use public fields in GObjects so I cannot test it by myself). You can
> anyway check the resulting HTML to see how (and if) it is used.
> 
> Ciao.