From: Randy Dunlap Don't have macros between a function's kernel-doc block and the function definition. This is not valid for kernel-doc. Warning(/var/linsrc/linux-2.6.20-rc1-git8//drivers/pci/probe.c:653): No description found for parameter 'IORESOURCE_PCI_FIXED' Signed-off-by: Randy Dunlap Cc: Greg KH Signed-off-by: Andrew Morton --- drivers/pci/probe.c | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff -puN drivers/pci/probe.c~pci-probe-fix-macro-that-confuses-kernel-doc drivers/pci/probe.c --- a/drivers/pci/probe.c~pci-probe-fix-macro-that-confuses-kernel-doc +++ a/drivers/pci/probe.c @@ -682,6 +682,8 @@ static void pci_read_irq(struct pci_dev dev->irq = irq; } +#define LEGACY_IO_RESOURCE (IORESOURCE_IO | IORESOURCE_PCI_FIXED) + /** * pci_setup_device - fill in class and map information of a device * @dev: the device structure to fill @@ -692,9 +694,6 @@ static void pci_read_irq(struct pci_dev * Returns 0 on success and -1 if unknown type of device (not normal, bridge * or CardBus). */ - -#define LEGACY_IO_RESOURCE (IORESOURCE_IO | IORESOURCE_PCI_FIXED) - static int pci_setup_device(struct pci_dev * dev) { u32 class; _