[PATCH] mm: leafops.h: correct kernel-doc function param. names

[PATCH] mm: leafops.h: correct kernel-doc function param. names

[Randy Dunlap]

Modify the kernel-doc function parameter names to prevent kernel-doc
warnings:

Warning: include/linux/leafops.h:135 function parameter 'entry' not
 described in 'leafent_type'
Warning: include/linux/leafops.h:540 function parameter 'pte' not
 described in 'pte_is_uffd_marker'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
Cc: Andrew Morton <akpm@linux-foundation.org>
Cc: David Hildenbrand <david@kernel.org>
Cc: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Cc: Liam R. Howlett <Liam.Howlett@oracle.com>
Cc: Vlastimil Babka <vbabka@suse.cz>
Cc: Mike Rapoport <rppt@kernel.org>
Cc: Suren Baghdasaryan <surenb@google.com>
Cc: Michal Hocko <mhocko@suse.com>
---
 include/linux/leafops.h |    4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

--- linux-next-20251201.orig/include/linux/leafops.h
+++ linux-next-20251201/include/linux/leafops.h
@@ -133,7 +133,7 @@ static inline bool softleaf_is_none(soft
 
 /**
  * softleaf_type() - Identify the type of leaf entry.
- * @enntry: Leaf entry.
+ * @entry: Leaf entry.
  *
  * Returns: the leaf entry type associated with @entry.
  */
@@ -534,7 +534,7 @@ static inline bool pte_is_uffd_wp_marker
 /**
  * pte_is_uffd_marker() - Does this PTE entry encode a userfault-specific marker
  * leaf entry?
- * @entry: Leaf entry.
+ * @pte: PTE entry.
  *
  * It's useful to be able to determine which leaf entries encode UFFD-specific
  * markers so we can handle these correctly.

Re: [PATCH] mm: leafops.h: correct kernel-doc function param. names

[Lorenzo Stoakes]

On Sun, Dec 14, 2025 at 12:15:17PM -0800, Randy Dunlap wrote:
> Modify the kernel-doc function parameter names to prevent kernel-doc
> warnings:
>
> Warning: include/linux/leafops.h:135 function parameter 'entry' not
>  described in 'leafent_type'
> Warning: include/linux/leafops.h:540 function parameter 'pte' not
>  described in 'pte_is_uffd_marker'
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

Yikes my bad, thanks for fixing this! :)

Reviewed-by: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>

> ---
> Cc: Andrew Morton <akpm@linux-foundation.org>
> Cc: David Hildenbrand <david@kernel.org>
> Cc: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
> Cc: Liam R. Howlett <Liam.Howlett@oracle.com>
> Cc: Vlastimil Babka <vbabka@suse.cz>
> Cc: Mike Rapoport <rppt@kernel.org>
> Cc: Suren Baghdasaryan <surenb@google.com>
> Cc: Michal Hocko <mhocko@suse.com>
> ---
>  include/linux/leafops.h |    4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
>
> --- linux-next-20251201.orig/include/linux/leafops.h
> +++ linux-next-20251201/include/linux/leafops.h
> @@ -133,7 +133,7 @@ static inline bool softleaf_is_none(soft
>
>  /**
>   * softleaf_type() - Identify the type of leaf entry.
> - * @enntry: Leaf entry.
> + * @entry: Leaf entry.
>   *
>   * Returns: the leaf entry type associated with @entry.
>   */
> @@ -534,7 +534,7 @@ static inline bool pte_is_uffd_wp_marker
>  /**
>   * pte_is_uffd_marker() - Does this PTE entry encode a userfault-specific marker
>   * leaf entry?
> - * @entry: Leaf entry.
> + * @pte: PTE entry.
>   *
>   * It's useful to be able to determine which leaf entries encode UFFD-specific
>   * markers so we can handle these correctly.
>