[PATCH v2] nstree: fix func. parameter kernel-doc warnings

[PATCH v2] nstree: fix func. parameter kernel-doc warnings

[Randy Dunlap]

Use the correct parameter name ("__ns") for function parameter kernel-doc
to avoid 3 warnings:

Warning: include/linux/nstree.h:68 function parameter '__ns' not described in 'ns_tree_add_raw'
Warning: include/linux/nstree.h:77 function parameter '__ns' not described in 'ns_tree_add'
Warning: include/linux/nstree.h:88 function parameter '__ns' not described in 'ns_tree_remove'

Fixes: 885fc8ac0a4d ("nstree: make iterator generic")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
v2: rebase, add Fixes: tag, add linux-fsdevel mailing list

Cc: Christian Brauner <brauner@kernel.org>
Cc: linux-fsdevel@vger.kernel.org

 include/linux/nstree.h |    6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

--- linux-next-20260415.orig/include/linux/nstree.h
+++ linux-next-20260415/include/linux/nstree.h
@@ -61,7 +61,7 @@ static inline void __ns_tree_add(struct
 
 /**
  * ns_tree_add_raw - Add a namespace to a namespace
- * @ns: Namespace to add
+ * @__ns: Namespace to add
  *
  * This function adds a namespace to the appropriate namespace tree
  * without assigning a id.
@@ -70,7 +70,7 @@ static inline void __ns_tree_add(struct
 
 /**
  * ns_tree_add - Add a namespace to a namespace tree
- * @ns: Namespace to add
+ * @__ns: Namespace to add
  *
  * This function assigns a new id to the namespace and adds it to the
  * appropriate namespace tree and list.
@@ -81,7 +81,7 @@ static inline void __ns_tree_add(struct
 
 /**
  * ns_tree_remove - Remove a namespace from a namespace tree
- * @ns: Namespace to remove
+ * @__ns: Namespace to remove
  *
  * This function removes a namespace from the appropriate namespace
  * tree and list.

Re: [PATCH v2] nstree: fix func. parameter kernel-doc warnings

[Christian Brauner]

On Thu, 16 Apr 2026 14:54:29 -0700, Randy Dunlap wrote:
> Use the correct parameter name ("__ns") for function parameter kernel-doc
> to avoid 3 warnings:
> 
> Warning: include/linux/nstree.h:68 function parameter '__ns' not described in 'ns_tree_add_raw'
> Warning: include/linux/nstree.h:77 function parameter '__ns' not described in 'ns_tree_add'
> Warning: include/linux/nstree.h:88 function parameter '__ns' not described in 'ns_tree_remove'
> 
> [...]

Applied to the vfs.fixes branch of the vfs/vfs.git tree.
Patches in the vfs.fixes branch should appear in linux-next soon.

Please report any outstanding bugs that were missed during review in a
new review to the original patch series allowing us to drop it.

It's encouraged to provide Acked-bys and Reviewed-bys even though the
patch has now been applied. If possible patch trailers will be updated.

Note that commit hashes shown below are subject to change due to rebase,
trailer updates or similar. If in doubt, please check the listed branch.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/vfs/vfs.git
branch: vfs.fixes

[1/1] nstree: fix func. parameter kernel-doc warnings
      https://git.kernel.org/vfs/vfs/c/957762b9d1e0