Child Properties with gtk-doc

[Sven Herzberg-2]

Hey Dudes,

  I'm hacking on libccc [1], a canvas solution that integrates into GTK.
As a canvas also knows concepts like the container concept that's used
in GTK+, I need to add child properties in a similar way as GTK+ has.
GTK+ documents these by directly hacking the .sgml templates. I'd like
to do this from the sources.

  Is that possible? Would it make a useful addition to gtk-doc (IMHO
it's at least useful as in "everything you see in the GTK+ docs should
be possible from source files now")? Could you give me any hints on
implementing this?

Regards,
  Sven

[1]http://mail.gnome.org/archives/gnome-announce-list/2006-September/msg00005.html

_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list

[Matthias Clasen-2]

On 9/7/06, Sven Herzberg <herzi-ml@...> wrote:

> Hey Dudes,
>
>   I'm hacking on libccc [1], a canvas solution that integrates into GTK.
> As a canvas also knows concepts like the container concept that's used
> in GTK+, I need to add child properties in a similar way as GTK+ has.
> GTK+ documents these by directly hacking the .sgml templates. I'd like
> to do this from the sources.
>
>   Is that possible? Would it make a useful addition to gtk-doc (IMHO
> it's at least useful as in "everything you see in the GTK+ docs should
> be possible from source files now")? Could you give me any hints on
> implementing this?
>

Have you tried simply using the same syntax that works for documenting
regular properties in sources ? I thought that would just work...

Matthias
_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list

[Sven Herzberg-2]

Hey,

Am Donnerstag, den 07.09.2006, 21:34 -0400 schrieb Matthias Clasen:
> Have you tried simply using the same syntax that works for documenting
> regular properties in sources ? I thought that would just work...

No, just because I don't think I can. As the container's properties
would be specified by g_object_class_install_property() and the property
information would be read by property introspection in the scangobj
application built by gtk-doc.

Regards,
  Sven

_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list

[Damon Chaplin]

On Fri, 2006-09-08 at 12:11 +0200, Sven Herzberg wrote:

> Hey,
>
> Am Donnerstag, den 07.09.2006, 21:34 -0400 schrieb Matthias Clasen:
> > Have you tried simply using the same syntax that works for documenting
> > regular properties in sources ? I thought that would just work...
>
> No, just because I don't think I can. As the container's properties
> would be specified by g_object_class_install_property() and the property
> information would be read by property introspection in the scangobj
> application built by gtk-doc.

Coincidentally I've been thinking of using container properties for
GooCanvas. Though I wasn't sure if it was possible to use them outside
of GtkContainer.

Have you got the properties working in ccc?

If they do work, I'd like to see support added to gtk-doc. Though I
didn't write that part of gtk-doc so I'm not sure how difficult it would
be. It might be trivial.

Damon


_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list