diff mbox series

[1/1] linker_lists: document ll_entry_ref parameters

Message ID 20210328085726.12451-1-xypron.glpk@gmx.de
State Accepted, archived
Commit f44c214541b8e194e284a4d08e95f3ed09a0b262
Delegated to: Heinrich Schuchardt
Headers show
Series [1/1] linker_lists: document ll_entry_ref parameters | expand

Commit Message

Heinrich Schuchardt March 28, 2021, 8:57 a.m. UTC
Avoid 'make htmldocs' build warnings:

    ./include/linker_lists.h:224: warning:
    Function parameter or member '_type' not described in 'll_entry_ref'
    ./include/linker_lists.h:224: warning:
    Function parameter or member '_name' not described in 'll_entry_ref'
    ./include/linker_lists.h:224: warning:
    Function parameter or member '_list' not described in 'll_entry_ref'

Fixes: 851144350b6f ("linker_lists: Allow use in data structures")
Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
---
 include/linker_lists.h | 4 ++++
 1 file changed, 4 insertions(+)

--
2.30.2

Comments

Simon Glass March 29, 2021, 7:43 a.m. UTC | #1
On Sun, 28 Mar 2021 at 21:57, Heinrich Schuchardt <xypron.glpk@gmx.de> wrote:
>
> Avoid 'make htmldocs' build warnings:
>
>     ./include/linker_lists.h:224: warning:
>     Function parameter or member '_type' not described in 'll_entry_ref'
>     ./include/linker_lists.h:224: warning:
>     Function parameter or member '_name' not described in 'll_entry_ref'
>     ./include/linker_lists.h:224: warning:
>     Function parameter or member '_list' not described in 'll_entry_ref'
>
> Fixes: 851144350b6f ("linker_lists: Allow use in data structures")
> Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
> ---
>  include/linker_lists.h | 4 ++++
>  1 file changed, 4 insertions(+)

Reviewed-by: Simon Glass <sjg@chromium.org>
diff mbox series

Patch

diff --git a/include/linker_lists.h b/include/linker_lists.h
index 81a280a884..2fea54c834 100644
--- a/include/linker_lists.h
+++ b/include/linker_lists.h
@@ -219,6 +219,10 @@ 
  *
  * This is like ll_entry_get(), but without the extra code, so it is suitable
  * for putting into data structures.
+ *
+ * @_type: C type of the list entry, e.g. 'struct foo'
+ * @_name: name of the entry
+ * @_list: name of the list
  */
 #define ll_entry_ref(_type, _name, _list)				\
 	((_type *)&_u_boot_list_2_##_list##_2_##_name)