diff --git a/src/libei-event.h b/src/libei-event.h index bd6f8f4..8f011f7 100644 --- a/src/libei-event.h +++ b/src/libei-event.h @@ -86,6 +86,3 @@ ei_event_new_for_device(struct ei_device *device); struct ei * ei_event_get_context(struct ei_event *event); - -struct ei_event * -ei_event_ref(struct ei_event *event); diff --git a/src/libei.h b/src/libei.h index 265c908..151b24e 100644 --- a/src/libei.h +++ b/src/libei.h @@ -1111,13 +1111,24 @@ struct ei * ei_seat_get_context(struct ei_seat *seat); /** - * Release resources associated with this event. This function always - * returns NULL. + * Increase the refcount of this struct by one. Use ei_event_unref() to decrease + * the refcount. This function always returns the same event that the reference + * was added to. * - * The caller cannot increase the refcount of an event. Events should be - * considered transient data and not be held longer than required. - * ei_event_unref() is provided for consistency (as opposed to, say, - * ei_event_free()). + * Events should be considered transient data and not be held longer than + * required. + */ +struct ei_event * +ei_event_ref(struct ei_event *event); + +/** + * Decrease the refcount of this struct by one. When the refcount reaches + * zero, all allocated resources for this struct are released. + * + * Events should be considered transient data and not be held longer than + * required. + * + * @return always NULL */ struct ei_event * ei_event_unref(struct ei_event *event);