Re: [PATCH 1/3] kernel-doc: ignore __devinit

From: Randy.Dunlap
Date: Wed Jul 19 2006 - 08:37:57 EST


On Wed, 19 Jul 2006, Martin Waitz wrote:

> hoi :)
>
> On Tue, Jul 18, 2006 at 02:32:35PM -0700, Randy Dunlap wrote:
> > From: Randy Dunlap <rdunlap@xxxxxxxxxxxx>
> >
> > Ignore __devinit in function definitions so that kernel-doc won't
> > fail on them.
>
> why would it fall over __devinit?

It doesn't match any of those awful regex strings when
looking for function prototypes, so kernel-doc (the script)
coughs and dies, as noted in DocBook/kernel-api.tmpl
for drivers/pci/search.c.

> And shouldn't we add __{dev}?init{data}? while we are at it?

Yes, in theory at least (for __init and __exit, not __initdata,
since this is in function definitios).
I just haven't run into the need for those yet.

--
~Randy
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/