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/irq.h | |
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/irq.h')
-rw-r--r-- | include/asm-powerpc/irq.h | 24 |
1 files changed, 12 insertions, 12 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); |