luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-09-20 09:16:15 +02:00
Code Issues Packages Projects Releases Wiki Activity

Additions.

Browse Source 
2003-09-30  Matthias Clasen  <maclas@gmx.de>

	* gobject/tmpl/gparamspec.sgml:
	* gobject/tmpl/signals.sgml: Additions.
This commit is contained in:
Matthias Clasen 2003-09-29 22:48:05 +00:00 committed by Matthias Clasen
parent b514888d16
commit dd012cc3ed
3 changed files with 49 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
docs/reference/ChangeLog
View File

@ -1,5 +1,8 @@
2003-09-30 Matthias Clasen <maclas@gmx.de>
* gobject/tmpl/gparamspec.sgml:
* gobject/tmpl/signals.sgml: Additions.
* glib/glib-sections.txt: Add g_unichar_get_mirror_char and
g_static_mutex_get_mutex_impl_shortcut.

70
docs/reference/gobject/tmpl/gparamspec.sgml
View File

@ -250,70 +250,88 @@ if @value1 is found to be less than, equal to or greater than @value2, respectiv
<!-- ##### FUNCTION g_param_spec_get_name ##### -->
<para>
Returns the name of a #GParamSpec.
</para>
@pspec:
@Returns:
@pspec: a valid #GParamSpec
@Returns: the name of @pspec.
<!-- ##### FUNCTION g_param_spec_get_nick ##### -->
<para>
Returns the nickname of a #GParamSpec.
</para>
@pspec:
@Returns:
@pspec: a valid #GParamSpec
@Returns: the nickname of @pspec.
<!-- ##### FUNCTION g_param_spec_get_blurb ##### -->
<para>
Returns the short description of a #GParamSpec.
</para>
@pspec:
@Returns:
@pspec: a valid #GParamSpec
@Returns: the short description of @pspec.
<!-- ##### FUNCTION g_param_spec_get_qdata ##### -->
<para>
This function gets back user data pointers stored via
g_param_spec_set_qdata().
</para>
@pspec:
@quark:
@Returns:
@pspec: a valid #GParamSpec
@quark: a #GQuark, naming the user data pointer
@Returns: the user data pointer set, or %NULL
<!-- ##### FUNCTION g_param_spec_set_qdata ##### -->
<para>
This sets an opaque, named pointer on a #GParamSpec.
The name is specified through a #GQuark (retrived e.g. via
g_quark_from_static_string()), and the pointer
can be gotten back from the @pspec with g_param_spec_get_qdata().
Setting a previously set user data pointer, overrides (frees)
the old pointer set, using #NULL as pointer essentially
removes the data stored.
</para>
@pspec:
@quark:
@data:
@pspec: the #GParamSpec to set store a user data pointer
@quark: a #GQuark, naming the user data pointer
@data: an opaque user data pointer
<!-- ##### FUNCTION g_param_spec_set_qdata_full ##### -->
<para>
This function works like g_param_spec_set_qdata(), but in addition,
a <literal>void (*destroy) (gpointer)</literal> function may be
specified which is called with @data as argument when the @pspec is
finalized, or
the data is being overwritten by a call to g_param_spec_set_qdata()
with the same @quark.
</para>
@pspec:
@quark:
@data:
@destroy:
@pspec: the #GParamSpec to set store a user data pointer
@quark: a #GQuark, naming the user data pointer
@data: an opaque user data pointer
@destroy: function to invoke with @data as argument, when @data needs to
be freed
<!-- ##### FUNCTION g_param_spec_steal_qdata ##### -->
<para>
This function gets back user data pointers stored via
g_param_spec_set_qdata() and removes the @data from @pspec
without invoking it's destroy() function (if any was
set).
Usually, calling this function is only required to update
user data pointers with a destroy notifier.
</para>
@pspec:
@quark:
@Returns:
@pspec: the #GParamSpec to get a stored user data pointer from
@quark: a #GQuark, naming the user data pointer
@Returns: the user data pointer set, or %NULL
<!-- ##### FUNCTION g_param_spec_internal ##### -->

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

@ -217,14 +217,14 @@ of g_signal_new().
<!-- ##### MACRO G_SIGNAL_MATCH_MASK ##### -->
<para>
A mask for all #GSignalMatchType bits.
</para>
<!-- ##### MACRO G_SIGNAL_FLAGS_MASK ##### -->
<para>
A mask for all #GSignalFlags bits.
</para>