mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-08-05 08:53:39 +02:00
Remove references to nonexisting functions
* glib/gmain.c: Remove references to nonexisting functions g_source_set_callback_closure(), g_source_poll(), g_source_add() from docs. * glib/gdir.c (g_dir_open): Typo fix in docs. * glib/gasyncqueue.c (g_async_queue_lock): (g_async_queue_unref_and_unlock): Fix markup to avoid erroneous <link>s in docs. * glib/gwin32.c: Escape #'s leading to erroneous <link>s in docs. * glib/gtree.c: Replace some occurances of Gtree by GTree in docs. * glib/gstring.c (g_string_insert_unichar): Typo fix in docs. * glib/tmpl/conversions.sgml: Add GIConv. * glib/tmpl/main.sgml: Fix references to nonexisting functions g_main_loop_destroy(), g_source_add(), g_source_connect(). * glib/glib-sections.txt: Add GIConv, g_str_has_prefix, g_str_has_suffix. * glib/tmpl/linked_lists_single.sgml: * glib/tmpl/linked_lists_double.sgml: GListAllocator doesn't exist. * glib/glib-docs.sgml: Declare hash entity. * glib/tmpl/macros.sgml: Escape # in #ifdef to suppress erroneous links. * gobject/Makefile.am, gobject/gobject-docs.sgml, gobject/tmpl/*: * glib/Makefile.am, glib/glib-docs.sgml, glib/tmpl/*: Produce XML, not SGML.
This commit is contained in:
@@ -175,7 +175,7 @@ When closures are newly created, they get an initial reference count
|
||||
of 1, eventhough no caller has yet invoked g_closure_ref() on the @closure.
|
||||
Code entities that store closures for notification purposes are supposed
|
||||
to call this function, for example like this:
|
||||
<msgtext><programlisting>
|
||||
<informalexample><programlisting>
|
||||
static GClosure *notify_closure = NULL;
|
||||
void
|
||||
foo_notify_set_closure (GClosure *closure)
|
||||
@@ -189,7 +189,7 @@ foo_notify_set_closure (GClosure *closure)
|
||||
g_closure_sink (notify_closure);
|
||||
}
|
||||
}
|
||||
</programlisting></msgtext>
|
||||
</programlisting></informalexample>
|
||||
Because g_closure_sink() may decrement the reference count of a closure
|
||||
(if it hasn't been called on @closure yet) just like g_closure_unref(),
|
||||
g_closure_ref() should be called prior to this function.
|
||||
|
Reference in New Issue
Block a user