luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-01 23:13:40 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: Minor reformatting / gi-docgenification of signals docs

Browse Source 
This is nowhere near a complete check-through and gi-docgenification of
the signals docs, just a few bits I was looking at anyway.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
Helps: #3250
This commit is contained in:
Philip Withnall
2024-03-06 13:23:48 +00:00
parent 8a640f50ca
commit fafe1a14a8
2 changed files with 7 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
gobject/gsignal.h
View File

@@ -500,11 +500,12 @@ void g_signal_chain_from_overridden_handler (gpointer instance,
* @c_handler: the #GCallback to connect.
* @data: data to pass to @c_handler calls.
*
* Connects a #GCallback function to a signal for a particular object.
* Connects a [type@GObject.Callback] function to a signal for a particular object.
*
* The handler will be called synchronously, before the default handler of the signal. g_signal_emit() will not return control until all handlers are called.
* The handler will be called synchronously, before the default handler of the signal.
* [func@GObject.signal_emit] will not return control until all handlers are called.
*
* See [memory management of signal handlers][signals.html#Memory_management_of_signal_handlers] for
* See [memory management of signal handlers](signals.html#Memory_management_of_signal_handlers) for
* details on how to handle the return value and memory management of @data.
*
* Returns: the handler ID, of type #gulong (always greater than 0 for successful connections)