2008-02-03 23:06:54

by Randy Dunlap

[permalink] [raw]
Subject: [PATCH 4/8] kernel-doc: fix drivers/base/ warnings

From: Randy Dunlap <[email protected]>

Fix drivers/base/ missing kernel-doc parameters:
Warning(linux-2.6.24-git12//drivers/base/driver.c:133): No description found for parameter 'drv'
Warning(linux-2.6.24-git12//drivers/base/driver.c:133): No description found for parameter 'kobj'
Warning(linux-2.6.24-git12//drivers/base/driver.c:133): No description found for parameter 'fmt'
Warning(linux-2.6.24-git12//drivers/base/power/main.c:530): No description found for parameter 'state'

Signed-off-by: Randy Dunlap <[email protected]>
---
drivers/base/driver.c | 3 +++
drivers/base/power/main.c | 1 +
2 files changed, 4 insertions(+)

--- linux-2.6.24-git12.orig/drivers/base/driver.c
+++ linux-2.6.24-git12/drivers/base/driver.c
@@ -123,6 +123,9 @@ EXPORT_SYMBOL_GPL(driver_remove_file);

/**
* driver_add_kobj - add a kobject below the specified driver
+ * @drv: requesting device driver
+ * @kobj: kobject to add below this driver
+ * @fmt: format string that names the kobject
*
* You really don't want to do this, this is only here due to one looney
* iseries driver, go poke those developers if you are annoyed about
--- linux-2.6.24-git12.orig/drivers/base/power/main.c
+++ linux-2.6.24-git12/drivers/base/power/main.c
@@ -522,6 +522,7 @@ static void lock_all_devices(void)

/**
* device_suspend - Save state and stop all devices in system.
+ * @state: new power management state
*
* Prevent new devices from being registered, then lock all devices
* and suspend them.