All of lore.kernel.org
 help / color / mirror / Atom feed
* + rbtree-fixup-kernel-doc-names.patch added to mm-nonmm-unstable branch
@ 2026-07-22 23:55 Andrew Morton
  0 siblings, 0 replies; only message in thread
From: Andrew Morton @ 2026-07-22 23:55 UTC (permalink / raw)
  To: mm-commits, tglx, peterz, rdunlap, akpm


The patch titled
     Subject: rbtree: fixup kernel-doc names
has been added to the -mm mm-nonmm-unstable branch.  Its filename is
     rbtree-fixup-kernel-doc-names.patch

This patch will shortly appear at
     https://git.kernel.org/pub/scm/linux/kernel/git/akpm/25-new.git/tree/patches/rbtree-fixup-kernel-doc-names.patch

This patch will later appear in the mm-nonmm-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 various
branches at git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm
and is updated there most days

------------------------------------------------------
From: Randy Dunlap <rdunlap@infradead.org>
Subject: rbtree: fixup kernel-doc names
Date: Tue, 21 Jul 2026 22:07:59 -0700

Use the correct function parameter name in rb_next_match().  Use the
struct keyword when describing struct latch_tree_ops.

Prevents the following kernel-doc warnings:

Warning: ./include/linux/rbtree.h:510 function parameter 'node' not
 described in 'rb_next_match'
Warning: ./include/linux/rbtree.h:510 Excess function parameter 'tree'
 description in 'rb_next_match'
Warning: ./include/linux/rbtree_latch.h:63 cannot understand function
 prototype: 'struct latch_tree_ops'

Link: https://lore.kernel.org/20260722050759.3892887-1-rdunlap@infradead.org
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: "Peter Zijlstra (Intel)" <peterz@infradead.org>
Cc: Thomas Gleixner <tglx@kernel.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
---

 include/linux/rbtree.h       |    2 +-
 include/linux/rbtree_latch.h |    2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

--- a/include/linux/rbtree.h~rbtree-fixup-kernel-doc-names
+++ a/include/linux/rbtree.h
@@ -500,7 +500,7 @@ rb_find_first(const void *key, const str
 /**
  * rb_next_match() - find the next @key in @tree
  * @key: key to match
- * @tree: tree to search
+ * @node: tree to search
  * @cmp: operator defining node order
  *
  * Returns the next node matching @key, or NULL.
--- a/include/linux/rbtree_latch.h~rbtree-fixup-kernel-doc-names
+++ a/include/linux/rbtree_latch.h
@@ -47,7 +47,7 @@ struct latch_tree_root {
 };
 
 /**
- * latch_tree_ops - operators to define the tree order
+ * struct latch_tree_ops - operators to define the tree order
  * @less: used for insertion; provides the (partial) order between two elements.
  * @comp: used for lookups; provides the order between the search key and an element.
  *
_

Patches currently in -mm which might be from rdunlap@infradead.org are

mm-migrate-use-migrate_info-field-instead-of-private-fix.patch
mm-page_owner-document-page_owner-filter-fix.patch
radix-tree-add-correct-some-kernel-doc.patch
delaytop-sort-by-max-delay-to-highlight-top-latency-processes-fix.patch
rbtree-fixup-kernel-doc-names.patch


^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2026-07-22 23:55 UTC | newest]

Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-07-22 23:55 + rbtree-fixup-kernel-doc-names.patch added to mm-nonmm-unstable branch Andrew Morton

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.