diff options
author | Randy Dunlap <randy.dunlap@oracle.com> | 2008-02-03 09:29:12 -0500 |
---|---|---|
committer | Adrian Bunk <bunk@kernel.org> | 2008-02-03 09:29:12 -0500 |
commit | 771fcb58e5cd7feaf544552519319e7e8a5cace3 (patch) | |
tree | 6cbcd653573b79f1db469fe93639caf679c00234 /drivers/dio | |
parent | d81919c9c22466183115f83645128da4c2482fcd (diff) |
dio: fix kernel-doc notation
Fix kernel-doc in drivers/dio/ so that it is formatted correctly
and the parameter names match the function parameters.
Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Acked-By: Jochen Friedrich <jochen@scram.de>
Signed-off-by: Adrian Bunk <bunk@kernel.org>
Diffstat (limited to 'drivers/dio')
-rw-r--r-- | drivers/dio/dio-driver.c | 70 |
1 files changed, 34 insertions, 36 deletions
diff --git a/drivers/dio/dio-driver.c b/drivers/dio/dio-driver.c index e4c48e329367..8cd8507b1a8a 100644 --- a/drivers/dio/dio-driver.c +++ b/drivers/dio/dio-driver.c | |||
@@ -15,16 +15,15 @@ | |||
15 | #include <linux/dio.h> | 15 | #include <linux/dio.h> |
16 | 16 | ||
17 | 17 | ||
18 | /** | 18 | /** |
19 | * dio_match_device - Tell if a DIO device structure has a matching | 19 | * dio_match_device - Tell if a DIO device structure has a matching DIO device id structure |
20 | * DIO device id structure | 20 | * @ids: array of DIO device id structures to search in |
21 | * @ids: array of DIO device id structures to search in | 21 | * @d: the DIO device structure to match against |
22 | * @dev: the DIO device structure to match against | 22 | * |
23 | * | 23 | * Used by a driver to check whether a DIO device present in the |
24 | * Used by a driver to check whether a DIO device present in the | 24 | * system is in its list of supported devices. Returns the matching |
25 | * system is in its list of supported devices. Returns the matching | 25 | * dio_device_id structure or %NULL if there is no match. |
26 | * dio_device_id structure or %NULL if there is no match. | 26 | */ |
27 | */ | ||
28 | 27 | ||
29 | const struct dio_device_id * | 28 | const struct dio_device_id * |
30 | dio_match_device(const struct dio_device_id *ids, | 29 | dio_match_device(const struct dio_device_id *ids, |
@@ -66,13 +65,13 @@ static int dio_device_probe(struct device *dev) | |||
66 | } | 65 | } |
67 | 66 | ||
68 | 67 | ||
69 | /** | 68 | /** |
70 | * dio_register_driver - register a new DIO driver | 69 | * dio_register_driver - register a new DIO driver |
71 | * @drv: the driver structure to register | 70 | * @drv: the driver structure to register |
72 | * | 71 | * |
73 | * Adds the driver structure to the list of registered drivers | 72 | * Adds the driver structure to the list of registered drivers |
74 | * Returns zero or a negative error value. | 73 | * Returns zero or a negative error value. |
75 | */ | 74 | */ |
76 | 75 | ||
77 | int dio_register_driver(struct dio_driver *drv) | 76 | int dio_register_driver(struct dio_driver *drv) |
78 | { | 77 | { |
@@ -85,15 +84,15 @@ int dio_register_driver(struct dio_driver *drv) | |||
85 | } | 84 | } |
86 | 85 | ||
87 | 86 | ||
88 | /** | 87 | /** |
89 | * dio_unregister_driver - unregister a DIO driver | 88 | * dio_unregister_driver - unregister a DIO driver |
90 | * @drv: the driver structure to unregister | 89 | * @drv: the driver structure to unregister |
91 | * | 90 | * |
92 | * Deletes the driver structure from the list of registered DIO drivers, | 91 | * Deletes the driver structure from the list of registered DIO drivers, |
93 | * gives it a chance to clean up by calling its remove() function for | 92 | * gives it a chance to clean up by calling its remove() function for |
94 | * each device it was responsible for, and marks those devices as | 93 | * each device it was responsible for, and marks those devices as |
95 | * driverless. | 94 | * driverless. |
96 | */ | 95 | */ |
97 | 96 | ||
98 | void dio_unregister_driver(struct dio_driver *drv) | 97 | void dio_unregister_driver(struct dio_driver *drv) |
99 | { | 98 | { |
@@ -101,16 +100,15 @@ void dio_unregister_driver(struct dio_driver *drv) | |||
101 | } | 100 | } |
102 | 101 | ||
103 | 102 | ||
104 | /** | 103 | /** |
105 | * dio_bus_match - Tell if a DIO device structure has a matching DIO | 104 | * dio_bus_match - Tell if a DIO device structure has a matching DIO device id structure |
106 | * device id structure | 105 | * @dev: the DIO device structure to match against |
107 | * @ids: array of DIO device id structures to search in | 106 | * @drv: the &device_driver that points to the array of DIO device id structures to search |
108 | * @dev: the DIO device structure to match against | 107 | * |
109 | * | 108 | * Used by a driver to check whether a DIO device present in the |
110 | * Used by a driver to check whether a DIO device present in the | 109 | * system is in its list of supported devices. Returns the matching |
111 | * system is in its list of supported devices. Returns the matching | 110 | * dio_device_id structure or %NULL if there is no match. |
112 | * dio_device_id structure or %NULL if there is no match. | 111 | */ |
113 | */ | ||
114 | 112 | ||
115 | static int dio_bus_match(struct device *dev, struct device_driver *drv) | 113 | static int dio_bus_match(struct device *dev, struct device_driver *drv) |
116 | { | 114 | { |