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

Explain allowed signal names in more detail.

Browse Source 
* gsignal.c (g_signal_new): Explain allowed signal names in more
	detail.
This commit is contained in:
Matthias Clasen 2002-12-05 22:39:51 +00:00
parent 4a2fac6031
commit e852989bea
1 changed files with 13 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
gobject/gsignal.c
View File

@ -1056,6 +1056,8 @@ g_signal_stop_emission_by_name (gpointer instance,
* *
* Also tries the ancestors of the given type. * Also tries the ancestors of the given type.
* *
* See g_signal_new() for details on allowed signal names.
*
* Return value: the signal's identifying number, or 0 if no signal was found. * Return value: the signal's identifying number, or 0 if no signal was found.
**/ **/
guint guint
@ -1227,7 +1229,13 @@ g_signal_query (guint signal_id,
* *
* Creates a new signal. (This is usually done in the class initializer.) * Creates a new signal. (This is usually done in the class initializer.)
* *
* Note that you can use '-' and '_' interchangeably in signal names. * A signal name consists of segments consisting of ASCII letters and
* digits, separated by either the '-' or '_' character. The first
* character of a signal names must be a letter. Names which violate these
* rules lead to undefined behaviour of the GSignal system.
*
* When registering a signal and looking up a signal, either separator can
* be used, but they cannot be mixed.
* *
* Return value: the signal id * Return value: the signal id
**/ **/
@ -1339,7 +1347,7 @@ signal_add_class_closure (SignalNode *node,
* *
* Creates a new signal. (This is usually done in the class initializer.) * Creates a new signal. (This is usually done in the class initializer.)
* *
* Note that you can use '-' and '_' interchangeably in signal names. * See g_signal_new() for details on allowed signal names.
* *
* Return value: the signal id * Return value: the signal id
**/ **/
@ -1488,7 +1496,7 @@ g_signal_newv (const gchar *signal_name,
* *
* Creates a new signal. (This is usually done in the class initializer.) * Creates a new signal. (This is usually done in the class initializer.)
* *
* Note that you can use '-' and '_' interchangeably in signal names. * See g_signal_new() for details on allowed signal names.
* *
* Return value: the signal id * Return value: the signal id
**/ **/