1
0
mirror of https://github.com/Llewellynvdm/conky.git synced 2024-12-26 12:27:52 +00:00

update machinery: add some documentation

This commit is contained in:
Phil Sutter 2009-09-10 00:12:56 +02:00
parent 09c0bccf55
commit 9dd360ecdb

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 {
struct update_cb *next;
void (*func)(void);
@ -386,6 +388,8 @@ static struct update_cb {
.next = NULL,
};
/* Register an update callback. Don't allow duplicates, to minimise side
* effects and overhead. */
void add_update_callback(void (*func)(void))
{
struct update_cb *uc = &update_cb_head;
@ -403,6 +407,7 @@ void add_update_callback(void (*func)(void))
uc->next->func = func;
}
/* Free the list element uc and all decendants recursively. */
static void __free_update_callbacks(struct update_cb *uc)
{
if (uc->next)
@ -410,6 +415,7 @@ static void __free_update_callbacks(struct update_cb *uc)
free(uc);
}
/* Free the whole list of update callbacks. */
void free_update_callbacks(void)
{
if (update_cb_head.next)