On 5/20/25 8:57 AM, Nicolas Frattaroli wrote: > The kernel contains various generic data structures that should ideally > not be reinvented. However, it often fails to document the usage of > these in the in-tree kernel documentation beyond just a listing of > header symbols in the very lengthy kernel-api docs page. This is fine > for things that have simple invocations, but occasionally things devolve > into several layers of concatenating macros, which are subpar for humans > to parse. > > Begin making a small impact by adding some rudimentary example-driven > documentation for the linked list type. It's far from exhaustive, as > many list modification functions are currently not mentioned. However, > it covers the basics and directs readers towards further documentation > should they be interested in concurrency. > > Signed-off-by: Nicolas Frattaroli <nicolas.frattaroli@xxxxxxxxxxxxx> Nice. Thanks. Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx> Reviewed-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx> > --- > Documentation/core-api/index.rst | 1 + > Documentation/core-api/list.rst | 390 +++++++++++++++++++++++++++++++++++++++ > 2 files changed, 391 insertions(+) -- ~Randy
