Re: linkification warnings

[Nicola Fontana <ntd entidi it>]

Il giorno Fri, 18 Dec 2009 16:24:28 +0100
David Nečas <yeti physics muni cz> ha scritto:

> On Fri, Dec 18, 2009 at 02:58:10PM +0100, Nicola Fontana wrote:
> > 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.
> > 
> > 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).
> > 
> > If this is the case, using #GwyField-struct.xreal should work
> 
> You are right, adding -struct fixed it, thanks.

As a side note, from the sources it seems not only GObject structs are
treated differently, but any struct in the *.hierarchy file (so anything
with a _get_type() function present in *.types, I suppose).

Some time ago I provided a patch to _optionally_ append prefixes to any
type unconditionally ("-struct" to any struct, "-union" to any union
and so on) but it is still waiting review:

http://bugzilla.gnome.org/show_bug.cgi?id=593282

This would always permit to have a page with the same name of a type,
allowing for example to have:

http://library.gnome.org/devel/glib/stable/GString.html

instead of:

http://library.gnome.org/devel/glib/stable/glib-Strings.html

Actually, this is not possible to do.
-- 
Nicola