ACPI: watchdog: fix kernel-doc warnings

rddunlap · rafaeljw · commit 8a3134a02538 · 2023-12-12T20:27:20.000+01:00
Fix kernel-doc warnings found when using "W=1".

acpi_watchdog.c:85: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
acpi_watchdog.c:85: warning: missing initial short description on line:
 * Returns true if this system should prefer ACPI based watchdog instead of

Signed-off-by: Randy Dunlap &lt;rdunlap@infradead.org&gt;
Signed-off-by: Rafael J. Wysocki &lt;rafael.j.wysocki@intel.com&gt;
diff --git a/drivers/acpi/acpi_watchdog.c b/drivers/acpi/acpi_watchdog.c
@@ -81,7 +81,7 @@ static const struct acpi_table_wdat *acpi_watchdog_get_wdat(void)
 	return wdat;
 }
 
-/**
+/*
  * Returns true if this system should prefer ACPI based watchdog instead of
  * the native one (which are typically the same hardware).
  */

Original file line number	Diff line number	Diff line change
`@@ -81,7 +81,7 @@ static const struct acpi_table_wdat *acpi_watchdog_get_wdat(void)`
`81`	`81`	`return wdat;`
`82`	`82`	`}`
`83`	`83`
`84`		`-/**`
	`84`	`+/*`
`85`	`85`	`* Returns true if this system should prefer ACPI based watchdog instead of`
`86`	`86`	`* the native one (which are typically the same hardware).`
`87`	`87`	`*/`