powerpc: kgdb: fix kernel-doc warnings

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>
Signed-off-by: Madhavan Srinivasan <maddy@linux.ibm.com>
Link: https://patch.msgid.link/20260225055314.247966-1-rdunlap@infradead.org

diff --git a/arch/powerpc/kernel/kgdb.c b/arch/powerpc/kernel/kgdb.c
index 5081334b7bd217be9fa232f5254cb05f23c6e956..861db2334db87ed735beeabd7fcd5c0b1f9883f3 100644 (file)
--- a/arch/powerpc/kernel/kgdb.c
+++ b/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)
 {