diff options
author | Michael Ellerman <michael@ellerman.id.au> | 2006-08-01 21:13:50 -0400 |
---|---|---|
committer | Paul Mackerras <paulus@samba.org> | 2006-08-08 03:07:04 -0400 |
commit | 40681b95a4ef798bc38c92e0d9b8c06bbdd34409 (patch) | |
tree | 8de6bebd3c876737a6c55263548ad1002fe5cbe2 /include/asm-powerpc | |
parent | 3ab2b385c8a5cdf060c6a41582118a0cb27d0910 (diff) |
[POWERPC] Make doc comments extractable
We don't have much in the way of doc comments, but some of those we do have
don't work because they start with "/***" or "/*", not "/**" which is what
kernel-doc requires.
Signed-off-by: Michael Ellerman <michael@ellerman.id.au>
Signed-off-by: Paul Mackerras <paulus@samba.org>
Diffstat (limited to 'include/asm-powerpc')
-rw-r--r-- | include/asm-powerpc/irq.h | 24 | ||||
-rw-r--r-- | include/asm-powerpc/prom.h | 8 |
2 files changed, 16 insertions, 16 deletions
diff --git a/include/asm-powerpc/irq.h b/include/asm-powerpc/irq.h index d903a62959da..4da41efb1319 100644 --- a/include/asm-powerpc/irq.h +++ b/include/asm-powerpc/irq.h | |||
@@ -137,7 +137,7 @@ struct irq_map_entry { | |||
137 | extern struct irq_map_entry irq_map[NR_IRQS]; | 137 | extern struct irq_map_entry irq_map[NR_IRQS]; |
138 | 138 | ||
139 | 139 | ||
140 | /*** | 140 | /** |
141 | * irq_alloc_host - Allocate a new irq_host data structure | 141 | * irq_alloc_host - Allocate a new irq_host data structure |
142 | * @node: device-tree node of the interrupt controller | 142 | * @node: device-tree node of the interrupt controller |
143 | * @revmap_type: type of reverse mapping to use | 143 | * @revmap_type: type of reverse mapping to use |
@@ -159,14 +159,14 @@ extern struct irq_host *irq_alloc_host(unsigned int revmap_type, | |||
159 | irq_hw_number_t inval_irq); | 159 | irq_hw_number_t inval_irq); |
160 | 160 | ||
161 | 161 | ||
162 | /*** | 162 | /** |
163 | * irq_find_host - Locates a host for a given device node | 163 | * irq_find_host - Locates a host for a given device node |
164 | * @node: device-tree node of the interrupt controller | 164 | * @node: device-tree node of the interrupt controller |
165 | */ | 165 | */ |
166 | extern struct irq_host *irq_find_host(struct device_node *node); | 166 | extern struct irq_host *irq_find_host(struct device_node *node); |
167 | 167 | ||
168 | 168 | ||
169 | /*** | 169 | /** |
170 | * irq_set_default_host - Set a "default" host | 170 | * irq_set_default_host - Set a "default" host |
171 | * @host: default host pointer | 171 | * @host: default host pointer |
172 | * | 172 | * |
@@ -178,7 +178,7 @@ extern struct irq_host *irq_find_host(struct device_node *node); | |||
178 | extern void irq_set_default_host(struct irq_host *host); | 178 | extern void irq_set_default_host(struct irq_host *host); |
179 | 179 | ||
180 | 180 | ||
181 | /*** | 181 | /** |
182 | * irq_set_virq_count - Set the maximum number of virt irqs | 182 | * irq_set_virq_count - Set the maximum number of virt irqs |
183 | * @count: number of linux virtual irqs, capped with NR_IRQS | 183 | * @count: number of linux virtual irqs, capped with NR_IRQS |
184 | * | 184 | * |
@@ -188,7 +188,7 @@ extern void irq_set_default_host(struct irq_host *host); | |||
188 | extern void irq_set_virq_count(unsigned int count); | 188 | extern void irq_set_virq_count(unsigned int count); |
189 | 189 | ||
190 | 190 | ||
191 | /*** | 191 | /** |
192 | * irq_create_mapping - Map a hardware interrupt into linux virq space | 192 | * irq_create_mapping - Map a hardware interrupt into linux virq space |
193 | * @host: host owning this hardware interrupt or NULL for default host | 193 | * @host: host owning this hardware interrupt or NULL for default host |
194 | * @hwirq: hardware irq number in that host space | 194 | * @hwirq: hardware irq number in that host space |
@@ -202,13 +202,13 @@ extern unsigned int irq_create_mapping(struct irq_host *host, | |||
202 | irq_hw_number_t hwirq); | 202 | irq_hw_number_t hwirq); |
203 | 203 | ||
204 | 204 | ||
205 | /*** | 205 | /** |
206 | * irq_dispose_mapping - Unmap an interrupt | 206 | * irq_dispose_mapping - Unmap an interrupt |
207 | * @virq: linux virq number of the interrupt to unmap | 207 | * @virq: linux virq number of the interrupt to unmap |
208 | */ | 208 | */ |
209 | extern void irq_dispose_mapping(unsigned int virq); | 209 | extern void irq_dispose_mapping(unsigned int virq); |
210 | 210 | ||
211 | /*** | 211 | /** |
212 | * irq_find_mapping - Find a linux virq from an hw irq number. | 212 | * irq_find_mapping - Find a linux virq from an hw irq number. |
213 | * @host: host owning this hardware interrupt | 213 | * @host: host owning this hardware interrupt |
214 | * @hwirq: hardware irq number in that host space | 214 | * @hwirq: hardware irq number in that host space |
@@ -221,7 +221,7 @@ extern unsigned int irq_find_mapping(struct irq_host *host, | |||
221 | irq_hw_number_t hwirq); | 221 | irq_hw_number_t hwirq); |
222 | 222 | ||
223 | 223 | ||
224 | /*** | 224 | /** |
225 | * irq_radix_revmap - Find a linux virq from a hw irq number. | 225 | * irq_radix_revmap - Find a linux virq from a hw irq number. |
226 | * @host: host owning this hardware interrupt | 226 | * @host: host owning this hardware interrupt |
227 | * @hwirq: hardware irq number in that host space | 227 | * @hwirq: hardware irq number in that host space |
@@ -232,7 +232,7 @@ extern unsigned int irq_find_mapping(struct irq_host *host, | |||
232 | extern unsigned int irq_radix_revmap(struct irq_host *host, | 232 | extern unsigned int irq_radix_revmap(struct irq_host *host, |
233 | irq_hw_number_t hwirq); | 233 | irq_hw_number_t hwirq); |
234 | 234 | ||
235 | /*** | 235 | /** |
236 | * irq_linear_revmap - Find a linux virq from a hw irq number. | 236 | * irq_linear_revmap - Find a linux virq from a hw irq number. |
237 | * @host: host owning this hardware interrupt | 237 | * @host: host owning this hardware interrupt |
238 | * @hwirq: hardware irq number in that host space | 238 | * @hwirq: hardware irq number in that host space |
@@ -247,7 +247,7 @@ extern unsigned int irq_linear_revmap(struct irq_host *host, | |||
247 | 247 | ||
248 | 248 | ||
249 | 249 | ||
250 | /*** | 250 | /** |
251 | * irq_alloc_virt - Allocate virtual irq numbers | 251 | * irq_alloc_virt - Allocate virtual irq numbers |
252 | * @host: host owning these new virtual irqs | 252 | * @host: host owning these new virtual irqs |
253 | * @count: number of consecutive numbers to allocate | 253 | * @count: number of consecutive numbers to allocate |
@@ -261,7 +261,7 @@ extern unsigned int irq_alloc_virt(struct irq_host *host, | |||
261 | unsigned int count, | 261 | unsigned int count, |
262 | unsigned int hint); | 262 | unsigned int hint); |
263 | 263 | ||
264 | /*** | 264 | /** |
265 | * irq_free_virt - Free virtual irq numbers | 265 | * irq_free_virt - Free virtual irq numbers |
266 | * @virq: virtual irq number of the first interrupt to free | 266 | * @virq: virtual irq number of the first interrupt to free |
267 | * @count: number of interrupts to free | 267 | * @count: number of interrupts to free |
@@ -300,7 +300,7 @@ extern unsigned int irq_of_parse_and_map(struct device_node *dev, int index); | |||
300 | 300 | ||
301 | /* -- End OF helpers -- */ | 301 | /* -- End OF helpers -- */ |
302 | 302 | ||
303 | /*** | 303 | /** |
304 | * irq_early_init - Init irq remapping subsystem | 304 | * irq_early_init - Init irq remapping subsystem |
305 | */ | 305 | */ |
306 | extern void irq_early_init(void); | 306 | extern void irq_early_init(void); |
diff --git a/include/asm-powerpc/prom.h b/include/asm-powerpc/prom.h index 31bfea4686a6..7a457bd462a2 100644 --- a/include/asm-powerpc/prom.h +++ b/include/asm-powerpc/prom.h | |||
@@ -259,7 +259,7 @@ struct of_irq { | |||
259 | u32 specifier[OF_MAX_IRQ_SPEC]; /* Specifier copy */ | 259 | u32 specifier[OF_MAX_IRQ_SPEC]; /* Specifier copy */ |
260 | }; | 260 | }; |
261 | 261 | ||
262 | /*** | 262 | /** |
263 | * of_irq_map_init - Initialize the irq remapper | 263 | * of_irq_map_init - Initialize the irq remapper |
264 | * @flags: flags defining workarounds to enable | 264 | * @flags: flags defining workarounds to enable |
265 | * | 265 | * |
@@ -272,7 +272,7 @@ struct of_irq { | |||
272 | 272 | ||
273 | extern void of_irq_map_init(unsigned int flags); | 273 | extern void of_irq_map_init(unsigned int flags); |
274 | 274 | ||
275 | /*** | 275 | /** |
276 | * of_irq_map_raw - Low level interrupt tree parsing | 276 | * of_irq_map_raw - Low level interrupt tree parsing |
277 | * @parent: the device interrupt parent | 277 | * @parent: the device interrupt parent |
278 | * @intspec: interrupt specifier ("interrupts" property of the device) | 278 | * @intspec: interrupt specifier ("interrupts" property of the device) |
@@ -292,7 +292,7 @@ extern int of_irq_map_raw(struct device_node *parent, const u32 *intspec, | |||
292 | const u32 *addr, struct of_irq *out_irq); | 292 | const u32 *addr, struct of_irq *out_irq); |
293 | 293 | ||
294 | 294 | ||
295 | /*** | 295 | /** |
296 | * of_irq_map_one - Resolve an interrupt for a device | 296 | * of_irq_map_one - Resolve an interrupt for a device |
297 | * @device: the device whose interrupt is to be resolved | 297 | * @device: the device whose interrupt is to be resolved |
298 | * @index: index of the interrupt to resolve | 298 | * @index: index of the interrupt to resolve |
@@ -305,7 +305,7 @@ extern int of_irq_map_raw(struct device_node *parent, const u32 *intspec, | |||
305 | extern int of_irq_map_one(struct device_node *device, int index, | 305 | extern int of_irq_map_one(struct device_node *device, int index, |
306 | struct of_irq *out_irq); | 306 | struct of_irq *out_irq); |
307 | 307 | ||
308 | /*** | 308 | /** |
309 | * of_irq_map_pci - Resolve the interrupt for a PCI device | 309 | * of_irq_map_pci - Resolve the interrupt for a PCI device |
310 | * @pdev: the device whose interrupt is to be resolved | 310 | * @pdev: the device whose interrupt is to be resolved |
311 | * @out_irq: structure of_irq filled by this function | 311 | * @out_irq: structure of_irq filled by this function |