Re: linking to signals, properties and enums

[Stefan Kost <ensonic hora-obscura de>]

And another replay :)

see
http://bugzilla.gnome.org/show_bug.cgi?id=332483
for a patch.

@damon: okay to commit?

Stefan

On Fri, 2006-02-24 at 17:13 +0100, Stefan Kost wrote:
> Hi again,
> 
> found some uglyness in gtk-doc.
> 
> Object::signal becomes Object-signal
> and
> Object:property becomes Object--property
> 
> Thus the tasks are:
> 1.) Make #Object::signal and #Object:property work
> at least make a proper link tag
> <link linkend="Object-signal">Object::signal</link>
> 
> 2.) Add link-ids to enum-values, so that they can be references via
> %ENUM_VALUE or #ENUM_VALUE (which one do you prefer?)
> 
> Comments?
> 
> Stefan
> 
> Stefan Kost wrote:
> > hi,
> >
> > is anyone aware of a short notation to link to signals or enum-values.
> > RIght now one can write
> > '... this function will emit the #Objectname-signalname signal ...'
> > or
> > '.. use #Objectname--propertyname to do ...'
> >
> > The #ObjectName::signalname does not work and for properties we don't
> > have such a short notation.
> >
> > While properties and signals have an link-id atleast, enumvalues have
> > not. IMHO this is a pity as its useful to link to them from the code.
> >
> > Any suggestion for good short notations? I'd like to come up with
> > patches for all these scenarions.
> >
> >
> > Ciao
> > Stefan
> >
> > _______________________________________________
> > gtk-doc-list mailing list
> > gtk-doc-list gnome org
> > http://mail.gnome.org/mailman/listinfo/gtk-doc-list
> >   
>