* [PATCH] powerpc: kgdb: fix kernel-doc warnings
@ 2025-10-14 3:11 Randy Dunlap
0 siblings, 0 replies; only message in thread
From: Randy Dunlap @ 2025-10-14 3:11 UTC (permalink / raw)
To: linuxppc-dev
Cc: Randy Dunlap, Tiejun Chen, Benjamin Herrenschmidt,
Madhavan Srinivasan, Michael Ellerman, Nicholas Piggin,
Christophe Leroy
Remove empty comment line at the beginning of a kernel-doc function
block. Add a "Return:" section for this function.
These changes prevent 2 kernel-doc warnings:
Warning: ../arch/powerpc/kernel/kgdb.c:103 Cannot find identifier on line:
*
Warning: kgdb.c:113 No description found for return value of 'kgdb_skipexception'
Fixes: 949616cf2d30 ("powerpc/kgdb: Bail out of KGDB when we've been triggered")
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
---
Cc: Tiejun Chen <tiejun.chen@windriver.com>
Cc: Benjamin Herrenschmidt <benh@kernel.crashing.org>
Cc: Madhavan Srinivasan <maddy@linux.ibm.com>
Cc: Michael Ellerman <mpe@ellerman.id.au>
Cc: Nicholas Piggin <npiggin@gmail.com>
Cc: Christophe Leroy <christophe.leroy@csgroup.eu>
---
arch/powerpc/kernel/kgdb.c | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
--- linux-next-20251013.orig/arch/powerpc/kernel/kgdb.c
+++ linux-next-20251013/arch/powerpc/kernel/kgdb.c
@@ -101,7 +101,6 @@ static int computeSignal(unsigned int tt
}
/**
- *
* kgdb_skipexception - Bail out of KGDB when we've been triggered.
* @exception: Exception vector number
* @regs: Current &struct pt_regs.
@@ -109,6 +108,8 @@ static int computeSignal(unsigned int tt
* On some architectures we need to skip a breakpoint exception when
* it occurs after a breakpoint has been removed.
*
+ * Return: return %1 if the breakpoint for this address has been removed,
+ * otherwise return %0
*/
int kgdb_skipexception(int exception, struct pt_regs *regs)
{
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2025-10-14 3:12 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-10-14 3:11 [PATCH] powerpc: kgdb: fix kernel-doc warnings Randy Dunlap
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).