Llewellyn/conky
1
0
Fork 0
mirror of https://github.com/Llewellynvdm/conky.git synced 2024-12-26 12:27:52 +00:00
Code Issues Releases Activity

update machinery: add some documentation

Browse Source
This commit is contained in:
Phil Sutter 2009-09-10 00:12:56 +02:00
parent 09c0bccf55
commit 9dd360ecdb
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
src/common.c
View File

@ -379,6 +379,8 @@ void format_seconds_short(char *buf, unsigned int n, long seconds)
} }
} }
/* Linked list containing the functions to call upon each update interval.
* Populated while initialising text objects in construct_text_object(). */
static struct update_cb { static struct update_cb {
struct update_cb *next; struct update_cb *next;
void (*func)(void); void (*func)(void);
@ -386,6 +388,8 @@ static struct update_cb {
.next = NULL, .next = NULL,
}; };
/* Register an update callback. Don't allow duplicates, to minimise side
* effects and overhead. */
void add_update_callback(void (*func)(void)) void add_update_callback(void (*func)(void))
{ {
struct update_cb *uc = &update_cb_head; struct update_cb *uc = &update_cb_head;
@ -403,6 +407,7 @@ void add_update_callback(void (*func)(void))
uc->next->func = func; uc->next->func = func;
} }
/* Free the list element uc and all decendants recursively. */
static void __free_update_callbacks(struct update_cb *uc) static void __free_update_callbacks(struct update_cb *uc)
{ {
if (uc->next) if (uc->next)
@ -410,6 +415,7 @@ static void __free_update_callbacks(struct update_cb *uc)
free(uc); free(uc);
} }
/* Free the whole list of update callbacks. */
void free_update_callbacks(void) void free_update_callbacks(void)
{ {
if (update_cb_head.next) if (update_cb_head.next)