Re: linkification warnings

[Nicola Fontana <ntd entidi it>]

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.

Ciao.
-- 
Nicola

[1] http://git.gnome.org/cgit/gtk-doc/tree/gtkdoc-mkdb.in#n1340

> 
> 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
> http://mail.gnome.org/mailman/listinfo/gtk-doc-list