server: document listener fields and a vfunc

Adding these simple documentation comments allows us to have meaningful
link targets in the generated API documentation. That will help getting
rid of broken links which cause XML validation to fail.

Signed-off-by: Pekka Paalanen <pq@iki.fi>
This commit is contained in:
Pekka Paalanen 2025-12-28 12:33:32 +02:00
parent 7736d8793b
commit 12ec67aed5

View file

@ -360,6 +360,7 @@ void
wl_client_add_resource_created_listener(struct wl_client *client,
struct wl_listener *listener);
/** Callback function type for wl_client_for_each_resource() */
typedef enum wl_iterator_result (*wl_client_for_each_resource_iterator_func_t)(
struct wl_resource *resource,
void *user_data);
@ -430,7 +431,10 @@ wl_client_set_max_buffer_size(struct wl_client *client, size_t max_buffer_size);
* \sa wl_signal
*/
struct wl_listener {
/** Part of wl_signal::listener_list */
struct wl_list link;
/** Callback function pointer */
wl_notify_func_t notify;
};