Commit 40681b95 authored by Michael Ellerman's avatar Michael Ellerman Committed by Paul Mackerras
Browse files

[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: default avatarMichael Ellerman <michael@ellerman.id.au>
Signed-off-by: default avatarPaul Mackerras <paulus@samba.org>
parent 3ab2b385

arch/powerpc/kernel/crash_dump.c

+1 −1
Original line number Diff line number Diff line
@@ -80,7 +80,7 @@ static int __init parse_savemaxmem(char *p) 
}

__setup("savemaxmem=", parse_savemaxmem);



/*

/**

 * copy_oldmem_page - copy one page from "oldmem"

 * @pfn: page frame number to be copied

 * @buf: target memory address for the copy; this can be in kernel address

arch/powerpc/sysdev/i8259.c

+1 −1
Original line number Diff line number Diff line
@@ -224,7 +224,7 @@ static struct irq_host_ops i8259_host_ops = { 
	.xlate = i8259_host_xlate,

};



/****

/**

 * i8259_init - Initialize the legacy controller

 * @node: device node of the legacy PIC (can be NULL, but then, it will match

 *        all interrupts, so beware)

include/asm-powerpc/irq.h

+12 −12
Original line number Diff line number Diff line
@@ -137,7 +137,7 @@ struct irq_map_entry { 
extern struct irq_map_entry irq_map[NR_IRQS];





/***

/**

 * irq_alloc_host - Allocate a new irq_host data structure

 * @node: device-tree node of the interrupt controller

 * @revmap_type: type of reverse mapping to use
@@ -159,14 +159,14 @@ extern struct irq_host *irq_alloc_host(unsigned int revmap_type, 
				       irq_hw_number_t inval_irq);





/***

/**

 * irq_find_host - Locates a host for a given device node

 * @node: device-tree node of the interrupt controller

 */

extern struct irq_host *irq_find_host(struct device_node *node);





/***

/**

 * irq_set_default_host - Set a "default" host

 * @host: default host pointer

 *
@@ -178,7 +178,7 @@ extern struct irq_host *irq_find_host(struct device_node *node); 
extern void irq_set_default_host(struct irq_host *host);





/***

/**

 * irq_set_virq_count - Set the maximum number of virt irqs

 * @count: number of linux virtual irqs, capped with NR_IRQS

 *
@@ -188,7 +188,7 @@ extern void irq_set_default_host(struct irq_host *host); 
extern void irq_set_virq_count(unsigned int count);





/***

/**

 * irq_create_mapping - Map a hardware interrupt into linux virq space

 * @host: host owning this hardware interrupt or NULL for default host

 * @hwirq: hardware irq number in that host space
@@ -202,13 +202,13 @@ extern unsigned int irq_create_mapping(struct irq_host *host, 
				       irq_hw_number_t hwirq);





/***

/**

 * irq_dispose_mapping - Unmap an interrupt

 * @virq: linux virq number of the interrupt to unmap

 */

extern void irq_dispose_mapping(unsigned int virq);



/***

/**

 * irq_find_mapping - Find a linux virq from an hw irq number.

 * @host: host owning this hardware interrupt

 * @hwirq: hardware irq number in that host space
@@ -221,7 +221,7 @@ extern unsigned int irq_find_mapping(struct irq_host *host, 
				     irq_hw_number_t hwirq);





/***

/**

 * irq_radix_revmap - Find a linux virq from a hw irq number.

 * @host: host owning this hardware interrupt

 * @hwirq: hardware irq number in that host space
@@ -232,7 +232,7 @@ extern unsigned int irq_find_mapping(struct irq_host *host, 
extern unsigned int irq_radix_revmap(struct irq_host *host,

				     irq_hw_number_t hwirq);



/***

/**

 * irq_linear_revmap - Find a linux virq from a hw irq number.

 * @host: host owning this hardware interrupt

 * @hwirq: hardware irq number in that host space
@@ -247,7 +247,7 @@ extern unsigned int irq_linear_revmap(struct irq_host *host, 






/***

/**

 * irq_alloc_virt - Allocate virtual irq numbers

 * @host: host owning these new virtual irqs

 * @count: number of consecutive numbers to allocate
@@ -261,7 +261,7 @@ extern unsigned int irq_alloc_virt(struct irq_host *host, 
				   unsigned int count,

				   unsigned int hint);



/***

/**

 * irq_free_virt - Free virtual irq numbers

 * @virq: virtual irq number of the first interrupt to free

 * @count: number of interrupts to free
@@ -300,7 +300,7 @@ extern unsigned int irq_of_parse_and_map(struct device_node *dev, int index); 


/* -- End OF helpers -- */



/***

/**

 * irq_early_init - Init irq remapping subsystem

 */

extern void irq_early_init(void);

include/asm-powerpc/prom.h

+4 −4
Original line number Diff line number Diff line
@@ -259,7 +259,7 @@ struct of_irq { 
	u32 specifier[OF_MAX_IRQ_SPEC];	/* Specifier copy */

};



/***

/**

 * of_irq_map_init - Initialize the irq remapper

 * @flags:	flags defining workarounds to enable

 *
@@ -272,7 +272,7 @@ struct of_irq { 


extern void of_irq_map_init(unsigned int flags);



/***

/**

 * of_irq_map_raw - Low level interrupt tree parsing

 * @parent:	the device interrupt parent

 * @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, 
			  const u32 *addr, struct of_irq *out_irq);





/***

/**

 * of_irq_map_one - Resolve an interrupt for a device

 * @device:	the device whose interrupt is to be resolved

 * @index:     	index of the interrupt to resolve
@@ -305,7 +305,7 @@ extern int of_irq_map_raw(struct device_node *parent, const u32 *intspec, 
extern int of_irq_map_one(struct device_node *device, int index,

			  struct of_irq *out_irq);



/***

/**

 * of_irq_map_pci - Resolve the interrupt for a PCI device

 * @pdev:	the device whose interrupt is to be resolved

 * @out_irq:	structure of_irq filled by this function