From: Simon Glass <sjg@chromium.org>
Date: Sat, 19 Oct 2024 15:21:42 +0000 (-0600)
Subject: alist: Add a comment for alist_init_struct()
X-Git-Url: http://git.dujemihanovic.xyz/login.html?a=commitdiff_plain;h=13bd29849953c7d5294b64ba22495a928dd70d80;p=u-boot.git

alist: Add a comment for alist_init_struct()

Comment this macro so that it is clear how to use it.

Signed-off-by: Simon Glass <sjg@chromium.org>
---

diff --git a/include/alist.h b/include/alist.h
index 0343946bc4..a727f1c7df 100644
--- a/include/alist.h
+++ b/include/alist.h
@@ -198,6 +198,12 @@ bool alist_expand_by(struct alist *lst, uint inc_by);
  */
 bool alist_init(struct alist *lst, uint obj_size, uint alloc_size);
 
+/**
+ * alist_init_struct() - Typed version of alist_init()
+ *
+ * Use as:
+ *	alist_init(&lst, struct my_struct);
+ */
 #define alist_init_struct(_lst, _struct)	\
 	alist_init(_lst, sizeof(_struct), 0)