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

docs: Add subheadings to signals documentation page

Browse Source 
Splits the text up a bit and allows linking directly to those subsections.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
This commit is contained in:
Philip Withnall
2024-03-06 13:21:30 +00:00
parent e006624a45
commit 536bdabd6e
1 changed files with 4 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/reference/gobject/signals.md
View File

@@ -14,6 +14,8 @@ through strings. Signals introduced for a parent type are available
in derived types as well, so basically they are a per-type facility in derived types as well, so basically they are a per-type facility
that is inherited. that is inherited.
## Handlers
A signal emission mainly involves invocation of a certain set of A signal emission mainly involves invocation of a certain set of
callbacks in precisely defined manner. There are two main categories callbacks in precisely defined manner. There are two main categories
of such callbacks, per-object ones and user provided ones. of such callbacks, per-object ones and user provided ones.
@@ -29,6 +31,8 @@ frequently happens at the end of an object class' creation), while user
provided handlers are frequently connected and disconnected to/from a provided handlers are frequently connected and disconnected to/from a
certain signal on certain object instances. certain signal on certain object instances.
## Emissions
A signal emission consists of five stages, unless prematurely stopped: A signal emission consists of five stages, unless prematurely stopped:
1. Invocation of the object method handler for `G_SIGNAL_RUN_FIRST` signals 1. Invocation of the object method handler for `G_SIGNAL_RUN_FIRST` signals