Re: [PATCH] list_lru: expand list_lru_add() docs with info about sublists

From: Matthew Wilcox
Date: Thu Nov 28 2024 - 18:05:45 EST


On Thu, Nov 28, 2024 at 12:12:11PM +0000, Alice Ryhl wrote:
> - * Return: true if the list was updated, false otherwise
> + * Return value: true if the item was added, false otherwise

This is an incorrect change. The section is always called 'Return', not
'Return value'; see Documentation/doc-guide/kernel-doc.rst. And I
think it was fine to say "list was updated" rather than "item was
added". They're basically synonyms.

> - * Return value: true if the list was updated, false otherwise
> + * Return value: true if the item was added, false otherwise

Ditto (and other similar changes)