Re: [PATCH 3/4] padata: Add some code comments

From: Steffen Klassert
Date: Mon May 17 2010 - 03:04:52 EST

Hi Randy,

On Fri, May 14, 2010 at 09:18:57AM -0700, Randy Dunlap wrote:
> Hi Steffen,
> These comments are roughly 90% of the way to being kernel-doc notation,
> so how about going the rest of the way, please?

yes of course we can. I read Documentation/kernel-doc-nano-HOWTO.txt,
so I need to use /** for all comments that I want to add to kernel-doc.
Anything else to do?

> Use:
> /**
> in multiple places.

I wondered several times why some comments start with /** while
others start with /*. Anyway, I did not pay too much attention
to this, because it was just the beginning line of a comment.
Now I know the difference :)

> /**
> > + * padata_get_next - Get the next object that needs serialization.

This one is a static function, I would not mind to add it to kernel-doc
too, but that's probaply not needed.

I'll resend this one with the suggested changes,
thanks for pointing this out.

To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at
Please read the FAQ at