tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

list.h: add missing kernel-doc for basic macros

kernel-doc for the basic LIST_HEAD() and LIST_HEAD_INIT() macros has been
missing forever (i.e., since git). Add them for completeness.

Link: https://lkml.kernel.org/r/20250819075507.113639-1-rdunlap@infradead.org
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Nicolas Frattaroli <nicolas.frattaroli@collabora.com>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>

authored by

Randy Dunlap and committed by
Andrew Morton 2a8c51bc b1e34412

+8
+8
include/linux/list.h
··· 20 20 * using the generic single-entry routines. 21 21 */ 22 22 23 + /** 24 + * LIST_HEAD_INIT - initialize a &struct list_head's links to point to itself 25 + * @name: name of the list_head 26 + */ 23 27 #define LIST_HEAD_INIT(name) { &(name), &(name) } 24 28 29 + /** 30 + * LIST_HEAD - definition of a &struct list_head with initialization values 31 + * @name: name of the list_head 32 + */ 25 33 #define LIST_HEAD(name) \ 26 34 struct list_head name = LIST_HEAD_INIT(name) 27 35