Re: linkification warnings

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+.

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.



> 2) What is the expected behaviour of the link validity checking for
> functions?  I was happy to get no bogus warnings after the last
> tweaks. But then I realized I get no warnings for function links at
> all.  Is it right?
> Yeti
> _______________________________________________
> gtk-doc-list mailing list
> gtk-doc-list gnome org

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]