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

Clarify g_cancellable_push_current docs wrt cancellable being NULL (#575013)

Browse Source
This commit is contained in:
Alexander Larsson 2009-05-20 14:55:14 +02:00
parent ab29e09dac
commit 5a46e4d140
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
gio/gcancellable.c
View File

@ -249,8 +249,8 @@ g_cancellable_new (void)
/** /**
* g_cancellable_push_current: * g_cancellable_push_current:
* @cancellable: optional #GCancellable object, %NULL to ignore. * @cancellable: a #GCancellable object
* *
* Pushes @cancellable onto the cancellable stack. The current * Pushes @cancellable onto the cancellable stack. The current
* cancllable can then be recieved using g_cancellable_get_current(). * cancllable can then be recieved using g_cancellable_get_current().
* *
@ -266,7 +266,7 @@ g_cancellable_push_current (GCancellable *cancellable)
GSList *l; GSList *l;
g_return_if_fail (cancellable != NULL); g_return_if_fail (cancellable != NULL);
l = g_static_private_get (&current_cancellable); l = g_static_private_get (&current_cancellable);
l = g_slist_prepend (l, cancellable); l = g_slist_prepend (l, cancellable);
g_static_private_set (&current_cancellable, l, NULL); g_static_private_set (&current_cancellable, l, NULL);
@ -274,18 +274,18 @@ g_cancellable_push_current (GCancellable *cancellable)
/** /**
* g_cancellable_pop_current: * g_cancellable_pop_current:
* @cancellable: optional #GCancellable object, %NULL to ignore. * @cancellable: a #GCancellable object
* *
* Pops @cancellable off the cancellable stack (verifying that @cancellable * Pops @cancellable off the cancellable stack (verifying that @cancellable
* is on the top of the stack). * is on the top of the stack).
**/ **/
void void
g_cancellable_pop_current (GCancellable *cancellable) g_cancellable_pop_current (GCancellable *cancellable)
{ {
GSList *l; GSList *l;
l = g_static_private_get (&current_cancellable); l = g_static_private_get (&current_cancellable);
g_return_if_fail (l != NULL); g_return_if_fail (l != NULL);
g_return_if_fail (l->data == cancellable); g_return_if_fail (l->data == cancellable);
@ -295,17 +295,17 @@ g_cancellable_pop_current (GCancellable *cancellable)
/** /**
* g_cancellable_get_current: * g_cancellable_get_current:
* *
* Gets the top cancellable from the stack. * Gets the top cancellable from the stack.
* *
* Returns: a #GCancellable from the top of the stack, or %NULL * Returns: a #GCancellable from the top of the stack, or %NULL
* if the stack is empty. * if the stack is empty.
**/ **/
GCancellable * GCancellable *
g_cancellable_get_current (void) g_cancellable_get_current (void)
{ {
GSList *l; GSList *l;
l = g_static_private_get (&current_cancellable); l = g_static_private_get (&current_cancellable);
if (l == NULL) if (l == NULL)
return NULL; return NULL;