X-Git-Url: http://git.ozlabs.org/?p=ccan;a=blobdiff_plain;f=ccan%2Flist%2Flist.h;h=da2ac73537b6c9d46d67df62c51faa330c927e70;hp=02835a6b51e092c4b95fbc21a88bb71bbb46910a;hb=371a31d946c1055e8b7f7d9cec2b7f617206aeaf;hpb=dc0aafc9d58e231f5d6d70c9838b151a162428b1 diff --git a/ccan/list/list.h b/ccan/list/list.h index 02835a6b..da2ac735 100644 --- a/ccan/list/list.h +++ b/ccan/list/list.h @@ -95,17 +95,34 @@ struct list_node *list_check_node(const struct list_node *n, #endif /** - * LIST_HEAD - define and initalize an empty list_head + * LIST_HEAD_INIT - initializer for an empty list_head + * @name: the name of the list. + * + * Explicit initializer for an empty list. + * + * See also: + * LIST_HEAD, list_head_init() + * + * Example: + * static struct list_head my_list = LIST_HEAD_INIT(my_list); + */ +#define LIST_HEAD_INIT(name) { { &name.n, &name.n } } + +/** + * LIST_HEAD - define and initialize an empty list_head * @name: the name of the list. * * The LIST_HEAD macro defines a list_head and initializes it to an empty * list. It can be prepended by "static" to define a static list_head. * + * See also: + * LIST_HEAD_INIT, list_head_init() + * * Example: * static LIST_HEAD(my_global_list); */ #define LIST_HEAD(name) \ - struct list_head name = { { &name.n, &name.n } } + struct list_head name = LIST_HEAD_INIT(name) /** * list_head_init - initialize a list_head