luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-01-11 15:06:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

added some function documentations.

Browse Source 
Tue Jan  9 03:10:38 2001  Tim Janik  <timj@gtk.org>

        * gobject/tmpl/types.sgml: added some function documentations.

        * gobject/gobject-sections.txt: buncha fixups.
This commit is contained in:
Tim Janik 2001-01-09 02:18:57 +00:00 committed by Tim Janik
parent deb68e1592
commit 05122f2861
13 changed files with 1238 additions and 478 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/reference/ChangeLog
View File

@ -1,3 +1,9 @@
Tue Jan 9 03:10:38 2001 Tim Janik <timj@gtk.org>
* gobject/tmpl/types.sgml: added some function documentations.
* gobject/gobject-sections.txt: buncha fixups.
Fri Jan 5 15:47:10 2001 Owen Taylor <otaylor@redhat.com> Fri Jan 5 15:47:10 2001 Owen Taylor <otaylor@redhat.com>
* glib/glib-sections.txt glib/tmpl/* glib/Makefile.am: Updated. * glib/glib-sections.txt glib/tmpl/* glib/Makefile.am: Updated.

160
docs/reference/glib/tmpl/glib-unused.sgml
View File

@ -1,3 +1,18 @@
<!-- ##### FUNCTION g_source_connect_indirect ##### -->
<para>
</para>
@source:
@callback_data:
@callback_funcs:
<!-- ##### MACRO popen ##### -->
<para>
</para>
<!-- ##### FUNCTION g_mem_check ##### --> <!-- ##### FUNCTION g_mem_check ##### -->
<para> <para>
Checks if the given memory has already been freed. If it has it outputs Checks if the given memory has already been freed. If it has it outputs
@ -8,53 +23,7 @@ To use this function you must configure glib with the flag
@mem: the memory to check. @mem: the memory to check.
<!-- ##### FUNCTION g_main_remove_poll ##### --> <!-- ##### MACRO pclose ##### -->
<para>
Removes a file descriptor from the list being polled.
</para>
@fd: the #GPollFD to remove.
<!-- ##### FUNCTION g_source_connect ##### -->
<para>
</para>
@source:
@func:
@data:
@notify:
<!-- ##### MACRO lseek ##### -->
<para>
</para>
<!-- ##### FUNCTION g_main_loop_destroy ##### -->
<para>
</para>
@loop:
<!-- ##### USER_FUNCTION GCompletionStrcmpFunc ##### -->
<para>
</para>
@s1:
@s2:
@Returns:
<!-- ##### FUNCTION g_convert_error_quark ##### -->
<para>
</para>
@Returns:
<!-- ##### MACRO write ##### -->
<para> <para>
</para> </para>
@ -76,35 +45,13 @@ the results may be needed.
See #G_PRIORITY_DEFAULT, #G_PRIORITY_DEFAULT_IDLE, #G_PRIORITY_HIGH, See #G_PRIORITY_DEFAULT, #G_PRIORITY_DEFAULT_IDLE, #G_PRIORITY_HIGH,
#G_PRIORITY_HIGH_IDLE, and #G_PRIORITY_LOW. #G_PRIORITY_HIGH_IDLE, and #G_PRIORITY_LOW.
<!-- ##### MACRO pclose ##### --> <!-- ##### MACRO lseek ##### -->
<para> <para>
</para> </para>
<!-- ##### FUNCTION g_source_connect_indirect ##### --> <!-- ##### MACRO getpid ##### -->
<para>
</para>
@source:
@callback_data:
@callback_funcs:
<!-- ##### MACRO g_string ##### -->
<para>
Turns the argument into a string literal by using the '#' stringizing operator.
</para>
@x: text to convert to a literal string.
<!-- ##### MACRO popen ##### -->
<para>
</para>
<!-- ##### MACRO access ##### -->
<para> <para>
</para> </para>
@ -123,13 +70,7 @@ priority are stored in the order in which they were added.
type of source. type of source.
@Returns: TRUE if an event source was found and removed. @Returns: TRUE if an event source was found and removed.
<!-- ##### MACRO open ##### --> <!-- ##### MACRO close ##### -->
<para>
</para>
<!-- ##### MACRO getpid ##### -->
<para> <para>
</para> </para>
@ -155,11 +96,24 @@ type of source.
</para> </para>
<!-- ##### MACRO close ##### --> <!-- ##### USER_FUNCTION GCompletionStrcmpFunc ##### -->
<para> <para>
</para> </para>
@s1:
@s2:
@Returns:
<!-- ##### FUNCTION g_source_connect ##### -->
<para>
</para>
@source:
@func:
@data:
@notify:
<!-- ##### MACRO getcwd ##### --> <!-- ##### MACRO getcwd ##### -->
<para> <para>
@ -167,12 +121,32 @@ type of source.
</para> </para>
<!-- ##### MACRO read ##### --> <!-- ##### MACRO write ##### -->
<para> <para>
</para> </para>
<!-- ##### FUNCTION g_main_remove_poll ##### -->
<para>
Removes a file descriptor from the list being polled.
</para>
@fd: the #GPollFD to remove.
<!-- ##### MACRO access ##### -->
<para>
</para>
<!-- ##### MACRO g_string ##### -->
<para>
Turns the argument into a string literal by using the '#' stringizing operator.
</para>
@x: text to convert to a literal string.
<!-- ##### FUNCTION g_main_win32_get_poll_func ##### --> <!-- ##### FUNCTION g_main_win32_get_poll_func ##### -->
<para> <para>
@ -180,3 +154,29 @@ type of source.
@Returns: @Returns:
<!-- ##### MACRO read ##### -->
<para>
</para>
<!-- ##### FUNCTION g_main_loop_destroy ##### -->
<para>
</para>
@loop:
<!-- ##### FUNCTION g_convert_error_quark ##### -->
<para>
</para>
@Returns:
<!-- ##### MACRO open ##### -->
<para>
</para>

1
docs/reference/glib/tmpl/macros_misc.sgml
View File

@ -66,6 +66,7 @@ only one statement is expected by the compiler.
Portable way to copy <type>va_list</type> variables. Portable way to copy <type>va_list</type> variables.
</para> </para>
<!-- # Unused Parameters # -->
@ap1: the <type>va_list</type> variable to place a copy of @ap2 in. @ap1: the <type>va_list</type> variable to place a copy of @ap2 in.
@ap2: a <type>va_list</type>. @ap2: a <type>va_list</type>.

121
docs/reference/gobject/gobject-sections.txt
View File

@ -9,27 +9,36 @@ G_TYPE_FUNDAMENTAL_MAX
G_TYPE_DERIVE_ID G_TYPE_DERIVE_ID
G_TYPE_BRANCH_SEQNO G_TYPE_BRANCH_SEQNO
G_TYPE_FUNDAMENTAL_LAST G_TYPE_FUNDAMENTAL_LAST
GTypeFundamentals G_TYPE_IS_ABSTRACT
G_TYPE_IS_DERIVED
G_TYPE_IS_FUNDAMENTAL
G_TYPE_IS_VALUE_TYPE
G_TYPE_IS_CLASSED G_TYPE_IS_CLASSED
G_TYPE_IS_INSTANTIATABLE G_TYPE_IS_INSTANTIATABLE
G_TYPE_IS_DERIVABLE G_TYPE_IS_DERIVABLE
G_TYPE_IS_DEEP_DERIVABLE G_TYPE_IS_DEEP_DERIVABLE
G_TYPE_IS_INTERFACE G_TYPE_IS_INTERFACE
GTypeFundamentals
GTypeInterface GTypeInterface
GTypeInstance GTypeInstance
GTypeInfo GTypeInfo
GTypeFundamentalInfo GTypeFundamentalInfo
GInterfaceInfo GInterfaceInfo
GTypeValueTable GTypeValueTable
<TITLE>GType</TITLE> <TITLE>GType</TITLE>
G_TYPE_CHECK_INSTANCE_CAST
G_TYPE_CHECK_CLASS_CAST
G_TYPE_CHECK_INSTANCE_TYPE
G_TYPE_CHECK_CLASS_TYPE
G_TYPE_INSTANCE_GET_CLASS
G_TYPE_FROM_INSTANCE G_TYPE_FROM_INSTANCE
G_TYPE_FROM_CLASS G_TYPE_FROM_CLASS
G_TYPE_FROM_INTERFACE G_TYPE_FROM_INTERFACE
G_TYPE_INSTANCE_GET_CLASS
G_TYPE_INSTANCE_GET_INTERFACE
G_TYPE_CHECK_INSTANCE
G_TYPE_CHECK_INSTANCE_CAST
G_TYPE_CHECK_INSTANCE_TYPE
G_TYPE_CHECK_CLASS_CAST
G_TYPE_CHECK_CLASS_TYPE
G_TYPE_CHECK_VALUE
G_TYPE_CHECK_VALUE_TYPE
g_type_init g_type_init
g_type_name g_type_name
g_type_qname g_type_qname
@ -37,7 +46,6 @@ g_type_from_name
g_type_parent g_type_parent
g_type_next_base g_type_next_base
g_type_is_a g_type_is_a
g_type_conforms_to
g_type_fundamental_branch_last g_type_fundamental_branch_last
g_type_class_ref g_type_class_ref
g_type_class_peek g_type_class_peek
@ -57,29 +65,30 @@ GInterfaceInitFunc
GInterfaceFinalizeFunc GInterfaceFinalizeFunc
GTypeClassCacheFunc GTypeClassCacheFunc
GTypeFlags GTypeFlags
GTypeFundamentalFlags
g_type_register_static g_type_register_static
g_type_register_dynamic g_type_register_dynamic
g_type_register_fundamental g_type_register_fundamental
g_type_add_interface_static g_type_add_interface_static
g_type_add_interface_dynamic g_type_add_interface_dynamic
g_type_class_is_a g_type_get_plugin
g_type_check_class_cast g_type_interface_get_plugin
g_type_check_instance_cast g_type_fundamental_last
g_type_instance_conforms_to
g_type_check_flags g_type_check_flags
g_type_create_instance g_type_create_instance
g_type_free_instance g_type_free_instance
g_type_value_table_peek
g_type_add_class_cache_func g_type_add_class_cache_func
g_type_remove_class_cache_func g_type_remove_class_cache_func
g_type_class_unref_uncached g_type_class_unref_uncached
g_type_get_plugin
g_type_fundamental_last
g_type_check_instance g_type_check_instance
g_type_check_instance_cast
g_type_instance_is_a
g_type_check_class_cast
g_type_class_is_a
g_type_check_value g_type_check_value
g_type_value_conforms_to g_type_value_is_a
g_type_value_table_peek
<SUBSECTION Private> <SUBSECTION Private>
g_log_domain_gobject
</SECTION> </SECTION>
<SECTION> <SECTION>
@ -128,6 +137,9 @@ G_TYPE_MODULE_GET_CLASS
<FILE>objects</FILE> <FILE>objects</FILE>
GObject GObject
GObjectClass GObjectClass
GObjectConstructParam
GObjectGetPropertyFunc
GObjectSetPropertyFunc
G_OBJECT G_OBJECT
G_OBJECT_GET_CLASS G_OBJECT_GET_CLASS
G_OBJECT_TYPE G_OBJECT_TYPE
@ -139,31 +151,35 @@ G_TYPE_IS_OBJECT
G_IS_OBJECT G_IS_OBJECT
G_OBJECT_CLASS G_OBJECT_CLASS
G_IS_OBJECT_CLASS G_IS_OBJECT_CLASS
G_NOTIFY_PRIORITY
GObjectGetParamFunc
GObjectSetParamFunc
GObjectFinalizeFunc GObjectFinalizeFunc
g_object_class_install_param g_object_class_install_property
g_object_class_find_param_spec g_object_class_find_property
g_object_new g_object_new
g_object_new_valist g_object_new_valist
g_object_set g_object_set
g_object_get g_object_get
g_object_set_valist g_object_set_valist
g_object_get_valist g_object_get_valist
g_object_set_param g_object_set_property
g_object_get_param g_object_get_property
g_object_queue_param_changed g_object_freeze_notify
g_object_notify
g_object_thaw_notify
g_object_ref g_object_ref
g_object_unref g_object_unref
g_object_get_qdata g_object_get_qdata
g_object_set_qdata g_object_set_qdata
g_object_set_qdata_full g_object_set_qdata_full
g_object_steal_qdata g_object_steal_qdata
g_object_get_data
g_object_set_data
g_object_set_data_full
g_object_steal_data
g_value_set_object g_value_set_object
g_value_get_object g_value_get_object
g_value_dup_object g_value_dup_object
G_WARN_INVALID_PARAM_ID g_object_watch_closure
G_OBJECT_WARN_INVALID_PROPERTY_ID
</SECTION> </SECTION>
<SECTION> <SECTION>
@ -183,7 +199,6 @@ G_FLAGS_CLASS_TYPE
G_FLAGS_CLASS_TYPE_NAME G_FLAGS_CLASS_TYPE_NAME
G_IS_VALUE_ENUM G_IS_VALUE_ENUM
G_IS_VALUE_FLAGS G_IS_VALUE_FLAGS
G_IS_VALUE_POINTER
GEnumValue GEnumValue
GFlagsValue GFlagsValue
g_enum_get_value g_enum_get_value
@ -254,6 +269,9 @@ G_IS_VALUE_ULONG
G_IS_VALUE_FLOAT G_IS_VALUE_FLOAT
G_IS_VALUE_DOUBLE G_IS_VALUE_DOUBLE
G_IS_VALUE_STRING G_IS_VALUE_STRING
G_IS_VALUE_POINTER
G_IS_VALUE_CCALLBACK
G_IS_VALUE_PARAM
g_value_set_char g_value_set_char
g_value_get_char g_value_get_char
g_value_set_uchar g_value_set_uchar
@ -273,8 +291,17 @@ g_value_get_float
g_value_set_double g_value_set_double
g_value_get_double g_value_get_double
g_value_set_string g_value_set_string
g_value_set_static_string
g_value_get_string g_value_get_string
g_value_dup_string g_value_dup_string
g_value_set_param
g_value_get_param
g_value_dup_param
g_value_get_ccallback
g_value_get_pointer
g_value_set_pointer
g_value_set_ccallback
g_value_set_instance
</SECTION> </SECTION>
<SECTION> <SECTION>
@ -287,12 +314,12 @@ G_PARAM_SPEC_TYPE_NAME
G_PARAM_SPEC G_PARAM_SPEC
G_IS_PARAM_SPEC G_IS_PARAM_SPEC
G_PARAM_SPEC_GET_CLASS G_PARAM_SPEC_GET_CLASS
G_IS_PARAM_VALUE
G_PARAM_SPEC_VALUE_TYPE G_PARAM_SPEC_VALUE_TYPE
G_TYPE_IS_PARAM G_TYPE_IS_PARAM
GParamFlags GParamFlags
g_param_spec_ref g_param_spec_ref
g_param_spec_unref g_param_spec_unref
g_param_spec_sink
g_param_spec_get_qdata g_param_spec_get_qdata
g_param_spec_set_qdata g_param_spec_set_qdata
g_param_spec_set_qdata_full g_param_spec_set_qdata_full
@ -302,10 +329,11 @@ g_param_value_defaults
g_param_value_validate g_param_value_validate
g_param_values_cmp g_param_values_cmp
g_param_spec_internal g_param_spec_internal
g_param_spec_hash_table_new g_param_spec_pool_new
g_param_spec_hash_table_insert g_param_spec_pool_insert
g_param_spec_hash_table_remove g_param_spec_pool_remove
g_param_spec_hash_table_lookup g_param_spec_pool_lookup
g_param_type_register_static
</SECTION> </SECTION>
<SECTION> <SECTION>
@ -335,6 +363,14 @@ G_IS_PARAM_SPEC_DOUBLE
G_PARAM_SPEC_DOUBLE G_PARAM_SPEC_DOUBLE
G_IS_PARAM_SPEC_STRING G_IS_PARAM_SPEC_STRING
G_PARAM_SPEC_STRING G_PARAM_SPEC_STRING
G_IS_PARAM_SPEC_POINTER
G_PARAM_SPEC_POINTER
G_IS_PARAM_SPEC_BOXED
G_PARAM_SPEC_BOXED
G_IS_PARAM_SPEC_CCALLBACK
G_PARAM_SPEC_CCALLBACK
G_IS_PARAM_SPEC_PARAM
G_PARAM_SPEC_PARAM
G_IS_PARAM_SPEC_OBJECT G_IS_PARAM_SPEC_OBJECT
G_PARAM_SPEC_OBJECT G_PARAM_SPEC_OBJECT
GParamSpecChar GParamSpecChar
@ -349,6 +385,10 @@ GParamSpecFlags
GParamSpecFloat GParamSpecFloat
GParamSpecDouble GParamSpecDouble
GParamSpecString GParamSpecString
GParamSpecBoxed
GParamSpecCCallback
GParamSpecParam
GParamSpecPointer
GParamSpecObject GParamSpecObject
g_param_spec_char g_param_spec_char
g_param_spec_uchar g_param_spec_uchar
@ -363,6 +403,10 @@ g_param_spec_float
g_param_spec_double g_param_spec_double
g_param_spec_string g_param_spec_string
g_param_spec_string_c g_param_spec_string_c
g_param_spec_boxed
g_param_spec_ccallback
g_param_spec_param
g_param_spec_pointer
g_param_spec_object g_param_spec_object
</SECTION> </SECTION>
@ -384,12 +428,20 @@ GSignalEmissionHook
GSignalFlags GSignalFlags
GSignalMatchType GSignalMatchType
GSignalQuery GSignalQuery
g_signal_newc
g_signal_newv g_signal_newv
g_signal_emitv g_signal_new_valist
g_signal_query
g_signal_lookup g_signal_lookup
g_signal_name g_signal_name
g_signal_query
g_signal_list_ids g_signal_list_ids
g_signal_emit
g_signal_emit_by_name
g_signal_emitv
g_signal_emit_valist
g_signal_connect_data
g_signal_connect_object
g_signal_connect_closure
g_signal_connect_closure_by_id g_signal_connect_closure_by_id
g_signal_handler_block g_signal_handler_block
g_signal_handler_unblock g_signal_handler_unblock
@ -400,10 +452,11 @@ g_signal_handlers_unblock_matched
g_signal_handlers_disconnect_matched g_signal_handlers_disconnect_matched
g_signal_has_handler_pending g_signal_has_handler_pending
g_signal_stop_emission g_signal_stop_emission
g_signal_type_closure_new
g_signal_add_emission_hook_full g_signal_add_emission_hook_full
g_signal_remove_emission_hook g_signal_remove_emission_hook
g_signal_parse_name g_signal_parse_name
g_signal_handlers_destroy
g_signal_type_cclosure_new
</SECTION> </SECTION>
<SECTION> <SECTION>

8
docs/reference/gobject/tmpl/enumerations_flags.sgml
View File

@ -122,14 +122,6 @@ Enumeration and Flag Types
@value: @value:
<!-- ##### MACRO G_IS_VALUE_POINTER ##### -->
<para>
</para>
@value:
<!-- ##### STRUCT GEnumValue ##### --> <!-- ##### STRUCT GEnumValue ##### -->
<para> <para>

321
docs/reference/gobject/tmpl/gobject-unused.sgml
View File

@ -1,3 +1,69 @@
<!-- ##### FUNCTION g_type_conforms_to ##### -->
<para>
</para>
@type:
@iface_type:
@Returns:
<!-- ##### FUNCTION g_object_class_install_param ##### -->
<para>
</para>
@oclass:
@param_id:
@pspec:
<!-- ##### FUNCTION g_param_spec_hash_table_insert ##### -->
<para>
</para>
@hash_table:
@pspec:
@owner_type:
<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:See_Also ##### -->
<para>
</para>
<!-- ##### MACRO G_IS_PARAM_VALUE ##### -->
<para>
</para>
@pspec:
@value:
<!-- ##### FUNCTION g_type_instance_conforms_to ##### -->
<para>
</para>
@instance:
@iface_type:
@Returns:
<!-- ##### FUNCTION g_object_get_param ##### -->
<para>
</para>
@object:
@param_name:
@value:
<!-- ##### USER_FUNCTION GTypePluginRef ##### -->
<para>
</para>
@plugin:
<!-- ##### FUNCTION g_object_set_param ##### --> <!-- ##### FUNCTION g_object_set_param ##### -->
<para> <para>
@ -7,84 +73,16 @@
@param_name: @param_name:
@value: @value:
<!-- ##### FUNCTION g_param_spec_hash_table_remove ##### --> <!-- ##### USER_FUNCTION GObjectGetParamFunc ##### -->
<para>
</para>
@hash_table:
@pspec:
<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Long_Description ##### -->
<para>
</para>
<!-- ##### USER_FUNCTION GTypePluginUnRef ##### -->
<para>
</para>
@plugin:
<!-- ##### FUNCTION g_signals_destroy ##### -->
<para>
</para>
@itype:
<!-- ##### FUNCTION g_param_spec_hash_table_new ##### -->
<para>
</para>
@Returns:
<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Short_Description ##### -->
<!-- ##### STRUCT GTypePluginVTable ##### -->
<para>
</para>
@plugin_ref:
@plugin_unref:
@complete_type_info:
@complete_interface_info:
<!-- ##### FUNCTION g_signal_connect_closure ##### -->
<para>
</para>
@instance:
@signal_id:
@detail:
@closure:
@after:
@Returns:
<!-- ##### FUNCTION g_signal_type_closure_new ##### -->
<para>
</para>
@itype:
@struct_offset:
@Returns:
<!-- ##### MACRO G_WARN_INVALID_PARAM_ID ##### -->
<para> <para>
</para> </para>
@object: @object:
@param_id: @param_id:
@value:
@pspec: @pspec:
@trailer:
<!-- ##### ENUM GSignalType ##### --> <!-- ##### ENUM GSignalType ##### -->
<para> <para>
@ -98,82 +96,48 @@
@G_SIGNAL_ACTION: @G_SIGNAL_ACTION:
@G_SIGNAL_NO_HOOKS: @G_SIGNAL_NO_HOOKS:
<!-- ##### FUNCTION g_param_spec_hash_table_insert ##### --> <!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Long_Description ##### -->
<para>
</para>
@hash_table:
@pspec:
@owner_type:
<!-- ##### USER_FUNCTION GTypePluginFillTypeInfo ##### -->
<para>
</para>
@plugin:
@g_type:
@info:
@value_table:
<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:See_Also ##### -->
<para> <para>
</para> </para>
<!-- ##### USER_FUNCTION GTypePluginRef ##### --> <!-- ##### FUNCTION g_signal_type_closure_new ##### -->
<para> <para>
</para> </para>
@plugin: @itype:
@struct_offset:
<!-- ##### FUNCTION g_signal_handlers_destroy ##### -->
<para>
</para>
@instance:
<!-- ##### FUNCTION g_type_instance_conforms_to ##### -->
<para>
</para>
@instance:
@iface_type:
@Returns: @Returns:
<!-- ##### USER_FUNCTION GObjectSetParamFunc ##### --> <!-- ##### FUNCTION g_object_class_find_param_spec ##### -->
<para>
</para>
@oclass:
@param_name:
@Returns:
<!-- ##### FUNCTION g_object_queue_param_changed ##### -->
<para> <para>
</para> </para>
@object: @object:
@param_id: @param_name:
@value:
@pspec:
@trailer:
<!-- ##### FUNCTION g_type_is_dynamic ##### --> <!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Title ##### -->
gtypemodule.sgml
<!-- ##### USER_FUNCTION GTypePluginUnRef ##### -->
<para> <para>
</para> </para>
@type: @plugin:
@flags:
@Returns:
<!-- ##### FUNCTION g_type_value_conforms_to ##### -->
<para>
</para>
@value:
@type:
@Returns:
<!-- ##### FUNCTION g_param_spec_hash_table_lookup ##### --> <!-- ##### FUNCTION g_param_spec_hash_table_lookup ##### -->
<para> <para>
@ -187,19 +151,7 @@
@trailer: @trailer:
@Returns: @Returns:
<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Title ##### --> <!-- ##### USER_FUNCTION GObjectSetParamFunc ##### -->
gtypemodule.sgml
<!-- ##### FUNCTION g_object_queue_param_changed ##### -->
<para>
</para>
@object:
@param_name:
<!-- ##### USER_FUNCTION GObjectGetParamFunc ##### -->
<para> <para>
</para> </para>
@ -210,47 +162,51 @@ gtypemodule.sgml
@pspec: @pspec:
@trailer: @trailer:
<!-- ##### MACRO G_IS_PARAM_VALUE ##### --> <!-- ##### FUNCTION g_type_value_conforms_to ##### -->
<para> <para>
</para> </para>
@pspec:
@value: @value:
@type:
@Returns:
<!-- ##### FUNCTION g_object_class_install_param ##### --> <!-- ##### FUNCTION g_type_is_dynamic ##### -->
<para>
</para>
@oclass:
@param_id:
@pspec:
<!-- ##### MACRO G_NOTIFY_PRIORITY ##### -->
<para>
</para>
<!-- ##### FUNCTION g_object_get_param ##### -->
<para>
</para>
@object:
@param_name:
@value:
<!-- ##### FUNCTION g_type_conforms_to ##### -->
<para> <para>
</para> </para>
@type: @type:
@iface_type: @flags:
@Returns: @Returns:
<!-- ##### USER_FUNCTION GTypePluginFillTypeInfo ##### -->
<para>
</para>
@plugin:
@g_type:
@info:
@value_table:
<!-- ##### FUNCTION g_signals_destroy ##### -->
<para>
</para>
@itype:
<!-- ##### STRUCT GTypePluginVTable ##### -->
<para>
</para>
@plugin_ref:
@plugin_unref:
@complete_type_info:
@complete_interface_info:
<!-- ##### USER_FUNCTION GTypePluginFillInterfaceInfo ##### --> <!-- ##### USER_FUNCTION GTypePluginFillInterfaceInfo ##### -->
<para> <para>
@ -261,12 +217,37 @@ gtypemodule.sgml
@instance_type: @instance_type:
@info: @info:
<!-- ##### FUNCTION g_object_class_find_param_spec ##### --> <!-- ##### MACRO G_NOTIFY_PRIORITY ##### -->
<para>
</para>
<!-- ##### MACRO G_WARN_INVALID_PARAM_ID ##### -->
<para>
</para>
@object:
@param_id:
@pspec:
<!-- ##### SECTION ./tmpl/gtypemodule.sgml.sgml:Short_Description ##### -->
<!-- ##### FUNCTION g_param_spec_hash_table_new ##### -->
<para> <para>
</para> </para>
@oclass:
@param_name:
@Returns: @Returns:
<!-- ##### FUNCTION g_param_spec_hash_table_remove ##### -->
<para>
</para>
@hash_table:
@pspec:

158
docs/reference/gobject/tmpl/objects.sgml
View File

@ -27,6 +27,39 @@ The Base Object Type
</para> </para>
<!-- ##### STRUCT GObjectConstructParam ##### -->
<para>
</para>
@pspec:
@value:
@trailer:
<!-- ##### USER_FUNCTION GObjectGetPropertyFunc ##### -->
<para>
</para>
@object:
@property_id:
@value:
@pspec:
@trailer:
<!-- ##### USER_FUNCTION GObjectSetPropertyFunc ##### -->
<para>
</para>
@object:
@property_id:
@value:
@pspec:
@trailer:
<!-- ##### MACRO G_OBJECT ##### --> <!-- ##### MACRO G_OBJECT ##### -->
<para> <para>
@ -123,6 +156,26 @@ The Base Object Type
@object: @object:
<!-- ##### FUNCTION g_object_class_install_property ##### -->
<para>
</para>
@oclass:
@property_id:
@pspec:
<!-- ##### FUNCTION g_object_class_find_property ##### -->
<para>
</para>
@oclass:
@property_name:
@Returns:
<!-- ##### FUNCTION g_object_new ##### --> <!-- ##### FUNCTION g_object_new ##### -->
<para> <para>
@ -197,6 +250,51 @@ The Base Object Type
@first_param_name: @first_param_name:
<!-- ##### FUNCTION g_object_set_property ##### -->
<para>
</para>
@object:
@property_name:
@value:
<!-- ##### FUNCTION g_object_get_property ##### -->
<para>
</para>
@object:
@property_name:
@value:
<!-- ##### FUNCTION g_object_freeze_notify ##### -->
<para>
</para>
@object:
<!-- ##### FUNCTION g_object_notify ##### -->
<para>
</para>
@object:
@property_name:
<!-- ##### FUNCTION g_object_thaw_notify ##### -->
<para>
</para>
@object:
<!-- ##### FUNCTION g_object_ref ##### --> <!-- ##### FUNCTION g_object_ref ##### -->
<para> <para>
@ -255,6 +353,47 @@ The Base Object Type
@Returns: @Returns:
<!-- ##### FUNCTION g_object_get_data ##### -->
<para>
</para>
@object:
@key:
@Returns:
<!-- ##### FUNCTION g_object_set_data ##### -->
<para>
</para>
@object:
@key:
@data:
<!-- ##### FUNCTION g_object_set_data_full ##### -->
<para>
</para>
@object:
@key:
@data:
@destroy:
<!-- ##### FUNCTION g_object_steal_data ##### -->
<para>
</para>
@object:
@key:
@Returns:
<!-- ##### FUNCTION g_value_set_object ##### --> <!-- ##### FUNCTION g_value_set_object ##### -->
<para> <para>
@ -282,3 +421,22 @@ The Base Object Type
@Returns: @Returns:
<!-- ##### FUNCTION g_object_watch_closure ##### -->
<para>
</para>
@object:
@closure:
<!-- ##### MACRO G_OBJECT_WARN_INVALID_PROPERTY_ID ##### -->
<para>
</para>
@object:
@property_id:
@pspec:

59
docs/reference/gobject/tmpl/param_specs.sgml
View File

@ -116,6 +116,14 @@ Parameter Specifications
@pspec: @pspec:
<!-- ##### FUNCTION g_param_spec_sink ##### -->
<para>
</para>
@pspec:
<!-- ##### FUNCTION g_param_spec_get_qdata ##### --> <!-- ##### FUNCTION g_param_spec_get_qdata ##### -->
<para> <para>
@ -210,3 +218,54 @@ Parameter Specifications
@Returns: @Returns:
<!-- ##### FUNCTION g_param_spec_pool_new ##### -->
<para>
</para>
@type_prefixing:
@Returns:
<!-- ##### FUNCTION g_param_spec_pool_insert ##### -->
<para>
</para>
@pool:
@pspec:
@owner_type:
<!-- ##### FUNCTION g_param_spec_pool_remove ##### -->
<para>
</para>
@pool:
@pspec:
<!-- ##### FUNCTION g_param_spec_pool_lookup ##### -->
<para>
</para>
@pool:
@param_name:
@owner_type:
@walk_ancestors:
@trailer_p:
@Returns:
<!-- ##### FUNCTION g_param_type_register_static ##### -->
<para>
</para>
@name:
@pspec_info:
@Returns:

199
docs/reference/gobject/tmpl/signals.sgml
View File

@ -103,7 +103,11 @@ value returned by the last callback.
<!-- ##### TYPEDEF GSignalCMarshaller ##### --> <!-- ##### TYPEDEF GSignalCMarshaller ##### -->
<para> <para>
This is the signature of marshaller functions, required to marshall
arrays of parameter values to signal emissions into C language callback
invocations. It is merely an alias to @GClosureMarshal since the @GClosure
mechanism takes over responsibility of actuall function invocation for the
signal system.
</para> </para>
@ -124,16 +128,25 @@ value returned by the last callback.
<!-- ##### ENUM GSignalFlags ##### --> <!-- ##### ENUM GSignalFlags ##### -->
<para> <para>
The signal flags are used to specify a signal's behaviour, the overrall
signal description outlines how especially the RUN flags controll the
stages of a signal emission.
</para> </para>
@G_SIGNAL_RUN_FIRST: @G_SIGNAL_RUN_FIRST: Invoke the object method handler in the first emission stage.
@G_SIGNAL_RUN_LAST: @G_SIGNAL_RUN_LAST: Invoke the object method handler in the third emission stage.
@G_SIGNAL_RUN_CLEANUP: @G_SIGNAL_RUN_CLEANUP: Invoke the object method handler in the last emission stage.
@G_SIGNAL_NO_RECURSE: @G_SIGNAL_NO_RECURSE: Signals being emitted for an object while currently being in
@G_SIGNAL_DETAILED: emission for this very object will not be emitted recursively,
@G_SIGNAL_ACTION: but instead cause the first emission to be restarted.
@G_SIGNAL_NO_HOOKS: @G_SIGNAL_DETAILED: This signal supports "::detail" appendixes to the signal name
upon hanlder connections and emissions.
@G_SIGNAL_ACTION: Action signals are signals that may freely be emitted on alive
objects from user code via g_signal_emit() and friends, without
the need of being embedded into extra code that performs pre or
post emission adjustments on the object. They can also be thought
of as by third-party code generically callable obejct methods.
@G_SIGNAL_NO_HOOKS: No emissions hooks are supported for this signal.
<!-- ##### ENUM GSignalMatchType ##### --> <!-- ##### ENUM GSignalMatchType ##### -->
<para> <para>
@ -168,6 +181,23 @@ filled in by the g_signal_query() function.
@gpointer data2); @gpointer data2);
</programlisting></msgtext> </programlisting></msgtext>
<!-- ##### FUNCTION g_signal_newc ##### -->
<para>
</para>
@signal_name:
@itype:
@signal_flags:
@class_offset:
@accumulator:
@c_marshaller:
@return_type:
@n_params:
@Varargs:
@Returns:
<!-- ##### FUNCTION g_signal_newv ##### --> <!-- ##### FUNCTION g_signal_newv ##### -->
<para> <para>
@ -185,15 +215,36 @@ filled in by the g_signal_query() function.
@Returns: @Returns:
<!-- ##### FUNCTION g_signal_emitv ##### --> <!-- ##### FUNCTION g_signal_new_valist ##### -->
<para> <para>
</para> </para>
@instance_and_params: @signal_name:
@signal_id: @itype:
@detail: @signal_flags:
@return_value: @class_closure:
@accumulator:
@c_marshaller:
@return_type:
@n_params:
@args:
@Returns:
<!-- ##### FUNCTION g_signal_query ##### -->
<para>
Query the signal system for in-depth information about a
specific signal. This function will fill in a user-provided
structure to hold signal-specific information. If an invalid
dignal id is passed in, the @signal_id member of the @GSignalQuery
is 0. All members filled into the @GSignalQuery structure should
be considered constant and have to be left untouched.
</para>
@signal_id: The signal id of the signal to query information for
@query: A user provided structure that is filled in with constant
values upon success.
<!-- ##### FUNCTION g_signal_lookup ##### --> <!-- ##### FUNCTION g_signal_lookup ##### -->
@ -215,21 +266,6 @@ filled in by the g_signal_query() function.
@Returns: @Returns:
<!-- ##### FUNCTION g_signal_query ##### -->
<para>
Query the signal system for in-depth information about a
specific signal. This function will fill in a user-provided
structure to hold signal-specific information. If an invalid
dignal id is passed in, the @signal_id member of the @GSignalQuery
is 0. All members filled into the @GSignalQuery structure should
be considered constant and have to be left untouched.
</para>
@signal_id: The signal id of the signal to query information for
@query: A user provided structure that is filled in with constant
values upon success.
<!-- ##### FUNCTION g_signal_list_ids ##### --> <!-- ##### FUNCTION g_signal_list_ids ##### -->
<para> <para>
List the signals by id, that a certain instance or interface type List the signals by id, that a certain instance or interface type
@ -242,6 +278,93 @@ g_signal_query().
@Returns: Newly allocated array of signal ids @Returns: Newly allocated array of signal ids
<!-- ##### FUNCTION g_signal_emit ##### -->
<para>
</para>
@instance:
@signal_id:
@detail:
@Varargs:
<!-- ##### FUNCTION g_signal_emit_by_name ##### -->
<para>
</para>
@instance:
@detailed_signal:
@Varargs:
<!-- ##### FUNCTION g_signal_emitv ##### -->
<para>
</para>
@instance_and_params:
@signal_id:
@detail:
@return_value:
<!-- ##### FUNCTION g_signal_emit_valist ##### -->
<para>
</para>
@instance:
@signal_id:
@detail:
@var_args:
<!-- ##### FUNCTION g_signal_connect_data ##### -->
<para>
</para>
@instance:
@detailed_signal:
@c_handler:
@data:
@destroy_data:
@swapped:
@after:
@Returns:
<!-- ##### FUNCTION g_signal_connect_object ##### -->
<para>
</para>
@instance:
@detailed_signal:
@c_handler:
@gobject:
@swapped:
@after:
@Returns:
<!-- ##### FUNCTION g_signal_connect_closure ##### -->
<para>
</para>
@instance:
@detailed_signal:
@closure:
@after:
@Returns:
<!-- # Unused Parameters # -->
@signal_id:
@detail:
<!-- ##### FUNCTION g_signal_connect_closure_by_id ##### --> <!-- ##### FUNCTION g_signal_connect_closure_by_id ##### -->
<para> <para>
@ -452,3 +575,21 @@ and @detail quark.
@signal_id_p and @detail_p contain valid return values. @signal_id_p and @detail_p contain valid return values.
<!-- ##### FUNCTION g_signal_handlers_destroy ##### -->
<para>
</para>
@instance:
<!-- ##### FUNCTION g_signal_type_cclosure_new ##### -->
<para>
</para>
@itype:
@struct_offset:
@Returns:

142
docs/reference/gobject/tmpl/standard_params.sgml
View File

@ -206,6 +206,70 @@ Standard Parameter Types
@pspec: @pspec:
<!-- ##### MACRO G_IS_PARAM_SPEC_POINTER ##### -->
<para>
</para>
@pspec:
<!-- ##### MACRO G_PARAM_SPEC_POINTER ##### -->
<para>
</para>
@pspec:
<!-- ##### MACRO G_IS_PARAM_SPEC_BOXED ##### -->
<para>
</para>
@pspec:
<!-- ##### MACRO G_PARAM_SPEC_BOXED ##### -->
<para>
</para>
@pspec:
<!-- ##### MACRO G_IS_PARAM_SPEC_CCALLBACK ##### -->
<para>
</para>
@pspec:
<!-- ##### MACRO G_PARAM_SPEC_CCALLBACK ##### -->
<para>
</para>
@pspec:
<!-- ##### MACRO G_IS_PARAM_SPEC_PARAM ##### -->
<para>
</para>
@pspec:
<!-- ##### MACRO G_PARAM_SPEC_PARAM ##### -->
<para>
</para>
@pspec:
<!-- ##### MACRO G_IS_PARAM_SPEC_OBJECT ##### --> <!-- ##### MACRO G_IS_PARAM_SPEC_OBJECT ##### -->
<para> <para>
@ -343,6 +407,34 @@ Standard Parameter Types
@null_fold_if_empty: @null_fold_if_empty:
@ensure_non_null: @ensure_non_null:
<!-- ##### STRUCT GParamSpecBoxed ##### -->
<para>
</para>
@parent_instance:
<!-- ##### STRUCT GParamSpecCCallback ##### -->
<para>
</para>
@parent_instance:
<!-- ##### STRUCT GParamSpecParam ##### -->
<para>
</para>
@parent_instance:
<!-- ##### STRUCT GParamSpecPointer ##### -->
<para>
</para>
@parent_instance:
<!-- ##### STRUCT GParamSpecObject ##### --> <!-- ##### STRUCT GParamSpecObject ##### -->
<para> <para>
@ -537,6 +629,56 @@ Standard Parameter Types
@Returns: @Returns:
<!-- ##### FUNCTION g_param_spec_boxed ##### -->
<para>
</para>
@name:
@nick:
@blurb:
@boxed_type:
@flags:
@Returns:
<!-- ##### FUNCTION g_param_spec_ccallback ##### -->
<para>
</para>
@name:
@nick:
@blurb:
@flags:
@Returns:
<!-- ##### FUNCTION g_param_spec_param ##### -->
<para>
</para>
@name:
@nick:
@blurb:
@param_type:
@flags:
@Returns:
<!-- ##### FUNCTION g_param_spec_pointer ##### -->
<para>
</para>
@name:
@nick:
@blurb:
@flags:
@Returns:
<!-- ##### FUNCTION g_param_spec_object ##### --> <!-- ##### FUNCTION g_param_spec_object ##### -->
<para> <para>

424
docs/reference/gobject/tmpl/types.sgml
View File

@ -59,6 +59,78 @@ GType
<!-- ##### MACRO G_TYPE_IS_ABSTRACT ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_DERIVED ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_FUNDAMENTAL ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_VALUE_TYPE ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_CLASSED ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_INSTANTIATABLE ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_DERIVABLE ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_DEEP_DERIVABLE ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_INTERFACE ##### -->
<para>
</para>
@type:
<!-- ##### ENUM GTypeFundamentals ##### --> <!-- ##### ENUM GTypeFundamentals ##### -->
<para> <para>
@ -109,46 +181,6 @@ GType
@G_TYPE_PARAM_BOXED: @G_TYPE_PARAM_BOXED:
@G_TYPE_PARAM_OBJECT: @G_TYPE_PARAM_OBJECT:
<!-- ##### MACRO G_TYPE_IS_CLASSED ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_INSTANTIATABLE ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_DERIVABLE ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_DEEP_DERIVABLE ##### -->
<para>
</para>
@type:
<!-- ##### MACRO G_TYPE_IS_INTERFACE ##### -->
<para>
</para>
@type:
<!-- ##### STRUCT GTypeInterface ##### --> <!-- ##### STRUCT GTypeInterface ##### -->
<para> <para>
@ -207,54 +239,6 @@ GType
@lcopy_type: @lcopy_type:
@lcopy_value: @lcopy_value:
<!-- ##### MACRO G_TYPE_CHECK_INSTANCE_CAST ##### -->
<para>
</para>
@instance:
@g_type:
@c_type:
<!-- ##### MACRO G_TYPE_CHECK_CLASS_CAST ##### -->
<para>
</para>
@g_class:
@g_type:
@c_type:
<!-- ##### MACRO G_TYPE_CHECK_INSTANCE_TYPE ##### -->
<para>
</para>
@instance:
@g_type:
<!-- ##### MACRO G_TYPE_CHECK_CLASS_TYPE ##### -->
<para>
</para>
@g_class:
@g_type:
<!-- ##### MACRO G_TYPE_INSTANCE_GET_CLASS ##### -->
<para>
</para>
@instance:
@g_type:
@c_type:
<!-- ##### MACRO G_TYPE_FROM_INSTANCE ##### --> <!-- ##### MACRO G_TYPE_FROM_INSTANCE ##### -->
<para> <para>
@ -279,67 +263,160 @@ GType
@g_iface: @g_iface:
<!-- ##### FUNCTION g_type_init ##### --> <!-- ##### MACRO G_TYPE_INSTANCE_GET_CLASS ##### -->
<para> <para>
</para> </para>
@instance:
@g_type:
@c_type:
<!-- ##### MACRO G_TYPE_INSTANCE_GET_INTERFACE ##### -->
<para>
</para>
@instance:
@g_type:
@c_type:
<!-- ##### MACRO G_TYPE_CHECK_INSTANCE ##### -->
<para>
</para>
@instance:
<!-- ##### MACRO G_TYPE_CHECK_INSTANCE_CAST ##### -->
<para>
</para>
@instance:
@g_type:
@c_type:
<!-- ##### MACRO G_TYPE_CHECK_INSTANCE_TYPE ##### -->
<para>
</para>
@instance:
@g_type:
<!-- ##### MACRO G_TYPE_CHECK_CLASS_CAST ##### -->
<para>
</para>
@g_class:
@g_type:
@c_type:
<!-- ##### MACRO G_TYPE_CHECK_CLASS_TYPE ##### -->
<para>
</para>
@g_class:
@g_type:
<!-- ##### MACRO G_TYPE_CHECK_VALUE ##### -->
<para>
</para>
@value:
<!-- ##### MACRO G_TYPE_CHECK_VALUE_TYPE ##### -->
<para>
</para>
@value:
@g_type:
<!-- ##### FUNCTION g_type_init ##### -->
<para>
Prior to any use of the type system, g_type_init() has to be called to initialize
the type system and assorted other code portions (such as the various fundamental
type implementations or the signal system).
</para>
<!-- ##### FUNCTION g_type_name ##### --> <!-- ##### FUNCTION g_type_name ##### -->
<para> <para>
Return the unique name that is assigned to a type ID (this is the preferred method
to find out whether a specific type has been registered for the passed in ID yet).
</para> </para>
@type: @type: Type to return name for.
@Returns: @Returns: Static type name or NULL.
<!-- ##### FUNCTION g_type_qname ##### --> <!-- ##### FUNCTION g_type_qname ##### -->
<para> <para>
Return the corresponding quark of the type IDs name.
</para> </para>
@type: @type: Type to return quark of type name for.
@Returns: @Returns: The type names quark or 0.
<!-- ##### FUNCTION g_type_from_name ##### --> <!-- ##### FUNCTION g_type_from_name ##### -->
<para> <para>
Lookup the type ID from a given type name, returns 0 if no type has been registered under this name
(this is the preferred method to find out by name whether a specific type has been registered yet).
</para> </para>
@name: @name: Type name to lookup.
@Returns: @Returns: Corresponding type ID or 0.
<!-- ##### FUNCTION g_type_parent ##### --> <!-- ##### FUNCTION g_type_parent ##### -->
<para> <para>
Return the direct parent type of the passed in type.
If the passed in type has no parent, i.e. is a fundamental type, 0 is returned.
</para> </para>
@type: @type: The derived type.
@Returns: @Returns: The parent type.
<!-- ##### FUNCTION g_type_next_base ##### --> <!-- ##### FUNCTION g_type_next_base ##### -->
<para> <para>
Given a @type and a @base_type which is contained in its anchestry, return
the type that @base_type is the direct parent type for.
In other words, for a given type branch, e.g. Root-Derived1-Derived2-Leaf, specified
through @type=Leaf, return the nextmost child of @base_type. In this example, for
@base_type=Derived1, the returned value would be Derived2, for @base_type=Root, the
returned value would be Derived1.
</para> </para>
@type: @type: Descendant of @base_type and the type to be returned.
@base_type: @base_type: Direct parent of the returned type.
@Returns: @Returns: Immediate child of @base_type and anchestor of @type.
<!-- ##### FUNCTION g_type_is_a ##### --> <!-- ##### FUNCTION g_type_is_a ##### -->
<para> <para>
Check whether @type is a descendant of @is_a_type.
</para> </para>
@type: @type: Type to check anchestry for.
@is_a_type: @is_a_type: Possible anchestor of @type.
@Returns: @Returns: %TRUE if @type is_a @is_a_type holds true.
<!-- ##### FUNCTION g_type_fundamental_branch_last ##### --> <!-- ##### FUNCTION g_type_fundamental_branch_last ##### -->
@ -398,22 +475,25 @@ GType
<!-- ##### FUNCTION g_type_children ##### --> <!-- ##### FUNCTION g_type_children ##### -->
<para> <para>
Return a newly allocated and 0 terminated array of type IDs, listing the
child types of @type. The return value has to be g_free()ed after use.
</para> </para>
@type: @type: The parent type.
@n_children: @n_children: Optional #guint pointer to contain the number of child types.
@Returns: @Returns: Newly allocated and 0 terminated array of child types.
<!-- ##### FUNCTION g_type_interfaces ##### --> <!-- ##### FUNCTION g_type_interfaces ##### -->
<para> <para>
Return a newly allocated and 0 terminated array of type IDs, listing the
interface types that @type conforms to. The return value has to be
g_free()ed after use.
</para> </para>
@type: @type: The type to list interface types for.
@n_interfaces: @n_interfaces: Optional #guint pointer to contain the number of interface types.
@Returns: @Returns: Newly allocated and 0 terminated array of interface types.
<!-- ##### FUNCTION g_type_set_qdata ##### --> <!-- ##### FUNCTION g_type_set_qdata ##### -->
@ -514,6 +594,16 @@ GType
@G_TYPE_FLAG_ABSTRACT: @G_TYPE_FLAG_ABSTRACT:
<!-- ##### ENUM GTypeFundamentalFlags ##### -->
<para>
</para>
@G_TYPE_FLAG_CLASSED:
@G_TYPE_FLAG_INSTANTIATABLE:
@G_TYPE_FLAG_DERIVABLE:
@G_TYPE_FLAG_DEEP_DERIVABLE:
<!-- ##### FUNCTION g_type_register_static ##### --> <!-- ##### FUNCTION g_type_register_static ##### -->
<para> <para>
@ -571,33 +661,30 @@ GType
@plugin: @plugin:
<!-- ##### FUNCTION g_type_class_is_a ##### --> <!-- ##### FUNCTION g_type_get_plugin ##### -->
<para> <para>
</para> </para>
@g_class: @type:
@is_a_type:
@Returns: @Returns:
<!-- ##### FUNCTION g_type_check_class_cast ##### --> <!-- ##### FUNCTION g_type_interface_get_plugin ##### -->
<para> <para>
</para> </para>
@g_class: @instance_type:
@is_a_type: @implementation_type:
@Returns: @Returns:
<!-- ##### FUNCTION g_type_check_instance_cast ##### --> <!-- ##### FUNCTION g_type_fundamental_last ##### -->
<para> <para>
</para> </para>
@instance:
@iface_type:
@Returns: @Returns:
@ -628,15 +715,6 @@ GType
@instance: @instance:
<!-- ##### FUNCTION g_type_value_table_peek ##### -->
<para>
</para>
@type:
@Returns:
<!-- ##### FUNCTION g_type_add_class_cache_func ##### --> <!-- ##### FUNCTION g_type_add_class_cache_func ##### -->
<para> <para>
@ -663,23 +741,6 @@ GType
@g_class: @g_class:
<!-- ##### FUNCTION g_type_get_plugin ##### -->
<para>
</para>
@type:
@Returns:
<!-- ##### FUNCTION g_type_fundamental_last ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION g_type_check_instance ##### --> <!-- ##### FUNCTION g_type_check_instance ##### -->
<para> <para>
@ -689,6 +750,46 @@ GType
@Returns: @Returns:
<!-- ##### FUNCTION g_type_check_instance_cast ##### -->
<para>
</para>
@instance:
@iface_type:
@Returns:
<!-- ##### FUNCTION g_type_instance_is_a ##### -->
<para>
</para>
@instance:
@iface_type:
@Returns:
<!-- ##### FUNCTION g_type_check_class_cast ##### -->
<para>
</para>
@g_class:
@is_a_type:
@Returns:
<!-- ##### FUNCTION g_type_class_is_a ##### -->
<para>
</para>
@g_class:
@is_a_type:
@Returns:
<!-- ##### FUNCTION g_type_check_value ##### --> <!-- ##### FUNCTION g_type_check_value ##### -->
<para> <para>
@ -698,3 +799,22 @@ GType
@Returns: @Returns:
<!-- ##### FUNCTION g_type_value_is_a ##### -->
<para>
</para>
@value:
@type:
@Returns:
<!-- ##### FUNCTION g_type_value_table_peek ##### -->
<para>
</para>
@type:
@Returns:

107
docs/reference/gobject/tmpl/value_types.sgml
View File

@ -94,6 +94,30 @@ Standard value types
@value: @value:
<!-- ##### MACRO G_IS_VALUE_POINTER ##### -->
<para>
</para>
@value:
<!-- ##### MACRO G_IS_VALUE_CCALLBACK ##### -->
<para>
</para>
@value:
<!-- ##### MACRO G_IS_VALUE_PARAM ##### -->
<para>
</para>
@value:
<!-- ##### FUNCTION g_value_set_char ##### --> <!-- ##### FUNCTION g_value_set_char ##### -->
<para> <para>
@ -265,6 +289,15 @@ Standard value types
@v_string: @v_string:
<!-- ##### FUNCTION g_value_set_static_string ##### -->
<para>
</para>
@value:
@v_string:
<!-- ##### FUNCTION g_value_get_string ##### --> <!-- ##### FUNCTION g_value_get_string ##### -->
<para> <para>
@ -283,3 +316,77 @@ Standard value types
@Returns: @Returns:
<!-- ##### FUNCTION g_value_set_param ##### -->
<para>
</para>
@value:
@param:
<!-- ##### FUNCTION g_value_get_param ##### -->
<para>
</para>
@value:
@Returns:
<!-- ##### FUNCTION g_value_dup_param ##### -->
<para>
</para>
@value:
@Returns:
<!-- ##### FUNCTION g_value_get_ccallback ##### -->
<para>
</para>
@value:
@callback_func:
@callback_data:
<!-- ##### FUNCTION g_value_get_pointer ##### -->
<para>
</para>
@value:
@Returns:
<!-- ##### FUNCTION g_value_set_pointer ##### -->
<para>
</para>
@value:
@v_pointer:
<!-- ##### FUNCTION g_value_set_ccallback ##### -->
<para>
</para>
@value:
@callback_func:
@callback_data:
<!-- ##### FUNCTION g_value_set_instance ##### -->
<para>
</para>
@value:
@instance:

10
gobject/gtype.h
View File

@ -313,18 +313,18 @@ void g_type_class_unref_uncached (gpointer g_class);
/*< private >*/ /*< private >*/
GTypeClass* g_type_check_class_cast (GTypeClass *g_class, gboolean g_type_check_instance (GTypeInstance *instance);
GType is_a_type);
gboolean g_type_class_is_a (GTypeClass *g_class,
GType is_a_type);
GTypeInstance* g_type_check_instance_cast (GTypeInstance *instance, GTypeInstance* g_type_check_instance_cast (GTypeInstance *instance,
GType iface_type); GType iface_type);
gboolean g_type_instance_is_a (GTypeInstance *instance, gboolean g_type_instance_is_a (GTypeInstance *instance,
GType iface_type); GType iface_type);
GTypeClass* g_type_check_class_cast (GTypeClass *g_class,
GType is_a_type);
gboolean g_type_class_is_a (GTypeClass *g_class,
GType is_a_type);
gboolean g_type_check_value (GValue *value); gboolean g_type_check_value (GValue *value);
gboolean g_type_value_is_a (GValue *value, gboolean g_type_value_is_a (GValue *value,
GType type); GType type);
gboolean g_type_check_instance (GTypeInstance *instance);
GTypeValueTable* g_type_value_table_peek (GType type); GTypeValueTable* g_type_value_table_peek (GType type);