From 721e0b4a9783a965dcb7f926ff595755219351f5 Mon Sep 17 00:00:00 2001 From: Yong Bakos Date: Tue, 6 Dec 2016 07:21:56 -0800 Subject: [PATCH] util: Document wl_array and wl_list members Despite their clear names, wl_array and wl_list members are undocumented, resulting in doxygen warnings[1] when building documentation. Document these members, suppressing the warnings. [1] Warnings are visible when EXTRACT_ALL = NO. Signed-off-by: Yong Bakos Reviewed-by: Daniel Stone --- src/wayland-util.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/wayland-util.h b/src/wayland-util.h index f0a4508..caeac82 100644 --- a/src/wayland-util.h +++ b/src/wayland-util.h @@ -261,7 +261,9 @@ struct wl_interface { * \sa http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/include/linux/list.h */ struct wl_list { + /** Previous list element */ struct wl_list *prev; + /** Next list element */ struct wl_list *next; }; @@ -490,8 +492,11 @@ wl_list_insert_list(struct wl_list *list, struct wl_list *other); * */ struct wl_array { + /** Array size */ size_t size; + /** Allocated space */ size_t alloc; + /** Array data */ void *data; }; -- 2.7.4