Re: [PATCH][1/6] perfctr-2.7.3 for 2.6.7-rc1-mm1: core

[Andrew Morton <akpm@osdl.org>]

Mikael Pettersson <mikpe@csd.uu.se> wrote:
>
>  > We need (especially at this stage in the kernel cycle) at least a couple of
>   > pages of design documentation which describes
> 
>  Speaking of documentation, I have a strong preference for using
>  LaTeX for all papers, reports, docs, etc, except man pages.
>  Is that an acceptable format?

Sounds fine, but excessive for this exercise.  At this stage I'm asking for
sufficient description of the kernel patch to allow other developers to
understand and review the patch, maybe hack on it a bit.  A couple of pages
of ascii should suffice.  I'd consider it compulsory for patches of this
magnitude and scope.

Longer term, yes - having added a bunch of new syscalls to the kernel we
have a responsibility to document the user/kernel API for downstream users,
but that's not a requirement for reviewing the patch.