Re: [PATCH v2 5/5] watchdog: dev: convert to kernel-doc comments

From: Guenter Roeck

Date: Tue Jun 30 2026 - 15:11:09 EST


On 6/30/26 11:54, Manuel Ebner wrote:
On Fri, 2026-05-29 at 14:20 -0700, Randy Dunlap wrote:
[...]

@@ -659,7 +659,7 @@ __ATTRIBUTE_GROUPS(wdt);
 #define wdt_groups NULL
 #endif
-/*
+/**
  * watchdog_ioctl_op - call the watchdog drivers ioctl op if defined

Maybe this is better:
* watchdog_ioctl_op - call the watchdog drivers ioctl operation if defined
[...]
@@ -732,7 +732,7 @@ static ssize_t watchdog_write(struct fil
  return len;
 }
-/*
+/**
  * watchdog_ioctl - handle the different ioctl's for the watchdog device

I think it's plural:
* watchdog_ioctl - handle the different ioctls for the watchdog device

  * @file: File handle to the device
  * @cmd: Watchdog command


This patch is in the upstream kernel. You are a bit late.
Also, the scope of the patch was not to fix the text but
to convert function comments to kernel-doc format.

Please feel free to submit textual changes as separate patches.

Thanks,
Guenter