The patch titled Subject: maple_tree: fix documentation warnings has been added to the -mm mm-unstable branch. Its filename is maple-tree-add-new-data-structure-fix.patch This patch will shortly appear at https://git.kernel.org/pub/scm/linux/kernel/git/akpm/25-new.git/tree/patches/maple-tree-add-new-data-structure-fix.patch This patch will later appear in the mm-unstable branch at git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm Before you just go and hit "reply", please: a) Consider who else should be cc'ed b) Prefer to cc a suitable mailing list as well c) Ideally: find the original patch on the mailing list and do a reply-to-all to that, adding suitable additional cc's *** Remember to use Documentation/process/submit-checklist.rst when testing your code *** The -mm tree is included into linux-next via the mm-everything branch at git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm and is updated there every 2-3 working days ------------------------------------------------------ From: Liam Howlett <liam.howlett@xxxxxxxxxx> Subject: maple_tree: fix documentation warnings Date: Tue, 23 Aug 2022 15:22:59 +0000 Update the argument names in the documentation to match the functions Link: https://lkml.kernel.org/r/20220823152212.1795380-1-Liam.Howlett@xxxxxxxxxx Fixes: 96ba2a9525fb (Maple Tree: add new data structure) Signed-off-by: Liam R. Howlett <Liam.Howlett@xxxxxxxxxx> Signed-off-by: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx> --- include/linux/maple_tree.h | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) --- a/include/linux/maple_tree.h~maple-tree-add-new-data-structure-fix +++ a/include/linux/maple_tree.h @@ -220,7 +220,7 @@ struct maple_tree { /** * MTREE_INIT() - Initialize a maple tree * @name: The maple tree name - * @flags: The maple tree flags + * @__flags: The maple tree flags * */ #define MTREE_INIT(name, __flags) { \ @@ -232,8 +232,8 @@ struct maple_tree { /** * MTREE_INIT_EXT() - Initialize a maple tree with an external lock. * @name: The tree name - * @flags: The maple tree flags - * @lock: The external lock + * @__flags: The maple tree flags + * @__lock: The external lock */ #ifdef CONFIG_LOCKDEP #define MTREE_INIT_EXT(name, __flags, __lock) { \ @@ -509,9 +509,9 @@ static inline void mas_reset(struct ma_s /** * mas_for_each() - Iterate over a range of the maple tree. - * @mas: Maple Tree operation state (maple_state) - * @entry: Entry retrieved from the tree - * @max: maximum index to retrieve from the tree + * @__mas: Maple Tree operation state (maple_state) + * @__entry: Entry retrieved from the tree + * @__max: maximum index to retrieve from the tree * * When returned, mas->index and mas->last will hold the entire range for the * entry. @@ -646,10 +646,10 @@ void *mt_next(struct maple_tree *mt, uns /** * mt_for_each - Iterate over each entry starting at index until max. - * @tree: The Maple Tree - * @entry: The current entry - * @index: The index to update to track the location in the tree - * @max: The maximum limit for @index + * @__tree: The Maple Tree + * @__entry: The current entry + * @__index: The index to update to track the location in the tree + * @__max: The maximum limit for @index * * Note: Will not return the zero entry. */ _ Patches currently in -mm which might be from liam.howlett@xxxxxxxxxx are binder_alloc-add-missing-mmap_lock-calls-when-using-the-vma.patch maple-tree-add-new-data-structure-fix.patch mm-vmscan-use-vma-iterator-instead-of-vm_next.patch