2022-11-01 02:01:32

by Bo Liu

Subject: [PATCH] powerpc: Fix some kernel-doc warnings

The current code provokes some kernel-doc warnings:
arch/powerpc/kernel/process.c:1606: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

Signed-off-by: Bo Liu <[email protected]>
---
arch/powerpc/kernel/process.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/arch/powerpc/kernel/process.c b/arch/powerpc/kernel/process.c
index fcf604370c66..2e78232b1fc9 100644
--- a/arch/powerpc/kernel/process.c
+++ b/arch/powerpc/kernel/process.c
@@ -1602,7 +1602,7 @@ void arch_setup_new_exec(void)
}

#ifdef CONFIG_PPC64
-/**
+/*
* Assign a TIDR (thread ID) for task @t and set it in the thread
* structure. For now, we only support setting TIDR for 'current' task.
*
--
2.27.0

2022-11-02 14:11:59

by Christophe Leroy

Subject: Re: [PATCH] powerpc: Fix some kernel-doc warnings

Le 01/11/2022 à 02:54, Bo Liu a écrit :
> [Vous ne recevez pas souvent de courriers de [email protected]. Découvrez pourquoi ceci est important à https://aka.ms/LearnAboutSenderIdentification ]
>
> The current code provokes some kernel-doc warnings:
> arch/powerpc/kernel/process.c:1606: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
>
> Signed-off-by: Bo Liu <[email protected]>

Reviewed-by: Christophe Leroy <[email protected]>

> ---
> arch/powerpc/kernel/process.c | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/arch/powerpc/kernel/process.c b/arch/powerpc/kernel/process.c
> index fcf604370c66..2e78232b1fc9 100644
> --- a/arch/powerpc/kernel/process.c
> +++ b/arch/powerpc/kernel/process.c
> @@ -1602,7 +1602,7 @@ void arch_setup_new_exec(void)
> }
>
> #ifdef CONFIG_PPC64
> -/**
> +/*
> * Assign a TIDR (thread ID) for task @t and set it in the thread
> * structure. For now, we only support setting TIDR for 'current' task.
> *
> --
> 2.27.0
>

2023-03-22 12:33:40

by Michael Ellerman

Subject: Re: [PATCH] powerpc: Fix some kernel-doc warnings

On Mon, 31 Oct 2022 21:54:52 -0400, Bo Liu wrote:
> The current code provokes some kernel-doc warnings:
> arch/powerpc/kernel/process.c:1606: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
>
>

Applied to powerpc/next.

[1/1] powerpc: Fix some kernel-doc warnings
https://git.kernel.org/powerpc/c/be994293544f1c0b032dabfe0832d9c1dfcea14b

cheers