Re: [PATCH 04/10] PTI Makefile and Kconfig additions.

From: Arnd Bergmann
Date: Tue Mar 01 2011 - 06:37:57 EST


On Monday 28 February 2011, J Freyensee wrote:
> On Mon, 2011-02-28 at 10:31 +0100, Arnd Bergmann wrote:
>
> > The Kconfig description is a nice text, how about copying it to the
> > changeset so that reviewers know what the driver is about?
> >
>
> I thought patch 02/10, 'Kernel documentation', would had been first and
> met this need?

Documentation in source files is not the same as documentation in the
changelog, you need both. The changeset comments are usually just one
sentence in your series, and a little more would certainly be helpful.

Also, if you have one changeset with the documentation, that does
not help anyone who looks at another changeset.

Arnd
--
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/