> P.S. I'll note, though, that adding comments of the form
>
> /*
> * Add one to cobol
> */
> cobol++;
>
> Doesn't necessary make the code easier to read. It's better to optimize
> comments for readiability of those people who *are* willing to spend a
> little bit of time understanding the module, since those are the ones
> which are most likely to give us usable patches. Some duffer which
> expects to pick up the VM code in Linux, and understand it all in 15
> minutes is not someone whom I'll going to trust take patches from
> blindly!
I sometimes miss a description what a funcion does. Reading the code
usually works, but I've seen functions that I had to read 10 times before
I understood them.
I agree that comment on line as variable++ really sucks..
And if someone could explain that to my teachers at school I would be very
happy :-))))
Regards,
Igmar
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.rutgers.edu
Please read the FAQ at http://www.tux.org/lkml/
This archive was generated by hypermail 2b29 : Mon May 15 2000 - 21:00:24 EST