Hi,
I thought that this was to be higher-level documentation of the OS,
not the documentation _of_ (and _in_) src files.
Is this advisable at this stage, or in such a project?!
_My_ professional advice is: yuch! :-)
later,
ali
Jan Atle Ramsli <[EMAIL PROTECTED]> wrote --
> I would like to begin every source file with a description of the module
> If you have to describe each source file, you will automatically think
> about whether the different functions in the source file
> module'. This will also keep us thinking about interfaces
> between modules and functions, and such thoughts can be good for the
> When coding, we will be invited to think about the function's purpose, when
