watchdog: Correct kerneldoc warnings
authorKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Sun, 6 Apr 2025 20:35:31 +0000 (22:35 +0200)
committerWim Van Sebroeck <wim@linux-watchdog.org>
Sat, 24 May 2025 14:57:54 +0000 (16:57 +0200)
Correct kerneldoc syntax or drop kerneldoc entirely for function
comments not being kerneldoc to fix warnings like:

  pretimeout_noop.c:19: warning: Function parameter or struct member 'wdd' not described in 'pretimeout_noop'

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: Guenter Roeck <linux@roeck-us.net>
Link: https://lore.kernel.org/r/20250406203531.61322-2-krzysztof.kozlowski@linaro.org
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
Signed-off-by: Wim Van Sebroeck <wim@linux-watchdog.org>
drivers/watchdog/pcwd_usb.c
drivers/watchdog/pretimeout_noop.c
drivers/watchdog/pretimeout_panic.c
drivers/watchdog/wdt_pci.c

index 132699e2f2478d68b9df3782d3b5a9677b467539..b636650b714b20c25db7563e350cb46a851e4a3a 100644 (file)
@@ -579,7 +579,7 @@ static struct notifier_block usb_pcwd_notifier = {
        .notifier_call =        usb_pcwd_notify_sys,
 };
 
-/**
+/*
  *     usb_pcwd_delete
  */
 static inline void usb_pcwd_delete(struct usb_pcwd_private *usb_pcwd)
@@ -590,7 +590,7 @@ static inline void usb_pcwd_delete(struct usb_pcwd_private *usb_pcwd)
        kfree(usb_pcwd);
 }
 
-/**
+/*
  *     usb_pcwd_probe
  *
  *     Called by the usb core when a new device is connected that it thinks
@@ -758,7 +758,7 @@ error:
 }
 
 
-/**
+/*
  *     usb_pcwd_disconnect
  *
  *     Called by the usb core when the device is removed from the system.
index 4799551dd7849a21223af4ed616c2e241ec96329..74ec02b9ffca4b20ed116770d22887005d3d7451 100644 (file)
@@ -11,7 +11,7 @@
 
 /**
  * pretimeout_noop - No operation on watchdog pretimeout event
- * @wdd - watchdog_device
+ * @wdd: watchdog_device
  *
  * This function prints a message about pretimeout to kernel log.
  */
index 2cc3c41d2be5b8a85b958dec24edb9818f2d9984..8c3ac674dc456527409c47e208a066e85665e0cc 100644 (file)
@@ -11,7 +11,7 @@
 
 /**
  * pretimeout_panic - Panic on watchdog pretimeout event
- * @wdd - watchdog_device
+ * @wdd: watchdog_device
  *
  * Panic, watchdog has not been fed till pretimeout event.
  */
index dc5f29560e9bd1ed95f9644807ba2986e0862734..3918a600f2a00b866704efd047e36b1e01a4f6bb 100644 (file)
@@ -264,7 +264,7 @@ static int wdtpci_get_status(int *status)
        return 0;
 }
 
-/**
+/*
  *     wdtpci_get_temperature:
  *
  *     Reports the temperature in degrees Fahrenheit. The API is in