Documentation additions.

This commit is contained in:
Matthias Clasen 2003-10-20 20:07:45 +00:00
parent 04d27d2299
commit 4a29291187
7 changed files with 48 additions and 11 deletions

View File

@ -1,3 +1,13 @@
Mon Oct 20 22:05:37 2003 Matthias Clasen <maclas@gmx.de>
* gobject/tmpl/objects.sgml:
* gobject/tmpl/enumerations_flags.sgml:
* gobject/tmpl/gtypeplugin.sgml: Additions.
Mon Oct 20 22:04:45 2003 Matthias Clasen <maclas@gmx.de>
* gobject/gobject-sections.txt: Add GObjectConstructParam.
Mon Oct 20 20:38:06 2003 Matthias Clasen <maclas@gmx.de> Mon Oct 20 20:38:06 2003 Matthias Clasen <maclas@gmx.de>
* gobject/gobject.i: Removed... * gobject/gobject.i: Removed...

View File

@ -192,6 +192,7 @@ G_TYPE_MODULE_GET_CLASS
<FILE>objects</FILE> <FILE>objects</FILE>
GObject GObject
GObjectClass GObjectClass
GObjectConstructParam
GObjectGetPropertyFunc GObjectGetPropertyFunc
GObjectSetPropertyFunc GObjectSetPropertyFunc
GObjectFinalizeFunc GObjectFinalizeFunc
@ -243,7 +244,6 @@ g_object_run_dispose
G_OBJECT_WARN_INVALID_PROPERTY_ID G_OBJECT_WARN_INVALID_PROPERTY_ID
<SUBSECTION Private> <SUBSECTION Private>
G_OBJECT_WARN_INVALID_PSPEC G_OBJECT_WARN_INVALID_PSPEC
GObjectConstructParam
</SECTION> </SECTION>
<SECTION> <SECTION>

View File

@ -118,22 +118,23 @@ Returns the static type name from a given #GFlagsClass structure.
<!-- ##### STRUCT GEnumValue ##### --> <!-- ##### STRUCT GEnumValue ##### -->
<para> <para>
A structure which contains a single enum value, its name, and it's A structure which contains a single enum value, it's name, and it's
nickname. nickname.
</para> </para>
@value: @value: the enum value
@value_name: @value_name: the name of the value
@value_nick: @value_nick: the nickname of the value
<!-- ##### STRUCT GFlagsValue ##### --> <!-- ##### STRUCT GFlagsValue ##### -->
<para> <para>
A structure which contains a single flags value, it's name, and it's
nickname.
</para> </para>
@value: @value: the flags value
@value_name: @value_name: the name of the value
@value_nick: @value_nick: the nickname of the value
<!-- ##### FUNCTION g_enum_get_value ##### --> <!-- ##### FUNCTION g_enum_get_value ##### -->
<para> <para>

View File

@ -72,7 +72,9 @@ handles multiple registered types per module.
<!-- ##### STRUCT GTypePlugin ##### --> <!-- ##### STRUCT GTypePlugin ##### -->
<para> <para>
The <structname>GTypePlugin</structname> typedef is used as a placeholder
for objects that implement the <structname>GTypePlugin</structname>
interface.
</para> </para>

View File

@ -38,6 +38,23 @@ the setter for the property is called to reinstate the previous value.
</para> </para>
@g_type_class: @g_type_class:
@constructor:
@set_property:
@get_property:
@dispose:
@finalize:
@dispatch_properties_changed:
@notify:
<!-- ##### STRUCT GObjectConstructParam ##### -->
<para>
The <structname>GObjectConstructParam</structname> struct is an auxiliary
structure used to hand #GParamSpec/#GValue pairs to the @constructor of
a #GObjectClass.
</para>
@pspec: the #GParamSpec of the construct parameter
@value: the value to set the parameter to
<!-- ##### USER_FUNCTION GObjectGetPropertyFunc ##### --> <!-- ##### USER_FUNCTION GObjectGetPropertyFunc ##### -->
<para> <para>

View File

@ -1,3 +1,8 @@
Mon Oct 20 22:06:12 2003 Matthias Clasen <maclas@gmx.de>
* gobject.h (struct _GObjectClass): Add /*< public >*/
and /*< private >*/ markers for documentation purposes.
Sat Oct 18 01:24:14 2003 Matthias Clasen <maclas@gmx.de> Sat Oct 18 01:24:14 2003 Matthias Clasen <maclas@gmx.de>
* gtypeplugin.h (struct _GTypePluginClass): Add /*< public >*/ * gtypeplugin.h (struct _GTypePluginClass): Add /*< public >*/

View File

@ -75,7 +75,8 @@ struct _GObjectClass
/*< private >*/ /*< private >*/
GSList *construct_properties; GSList *construct_properties;
/* public overridable methods */ /*< public >*/
/* overridable methods */
GObject* (*constructor) (GType type, GObject* (*constructor) (GType type,
guint n_construct_properties, guint n_construct_properties,
GObjectConstructParam *construct_properties); GObjectConstructParam *construct_properties);
@ -98,6 +99,7 @@ struct _GObjectClass
/* signals */ /* signals */
void (*notify) (GObject *object, void (*notify) (GObject *object,
GParamSpec *pspec); GParamSpec *pspec);
/*< private >*/
/* padding */ /* padding */
gpointer pdummy[8]; gpointer pdummy[8];
}; };