[patch 2/19] pci: bridge resource handling update

Russell King rmk+pcmcia at arm.linux.org.uk
Sun Mar 20 07:30:32 EST 2005

On Sun, Mar 20, 2005 at 11:38:07AM +0100, Dominik Brodowski wrote:
>  /**
> - * pci_find_parent_resource - return resource region of parent bus of given region
> - * @dev: PCI device structure contains resources to be searched
> - * @res: child resource record for which parent is sought
> + * pci_bus_find_parent_resource

These aren't entirely free-style comments, but are designed to be parsed.
See Documentation/kernel-doc-nano-HOWTO.txt for their description.

If you're going to add kernel-doc like comments, please ensure that
they're appropriately fleshed out (iow, including a description of
the parameters.)  Alternatively, if you don't want to kernel-doc
internal functions, please don't use the initial /**.  (/** should
only be used with kerneldoc comments, not standard comments.)

Russell King
 Linux kernel    2.6 ARM Linux   - http://www.arm.linux.org.uk/
 maintainer of:  2.6 Serial core

More information about the linux-pcmcia mailing list