On 07/06/2012 10:05 AM, Dan Bernstein wrote:
It appears that lately most WebCore change log entires don’t include any
comments on individual functions. An overall description of the change at the
top of the change log entry is valuable, but it is no substitute for describing
the changes to each function. Good function-level comments are useful both
while reviewing a patch and while revisiting existing code. Personally, I find
that writing the function-level comments helps me a lot in reviewing my own
patches before I post them.
You forget there is a WebKit policy of not writing comments
or otherwise documenting the code.
Or at least that's what it looks like. :-(
--
--Per Bothner
[email protected] [email protected] http://per.bothner.com/
_______________________________________________
webkit-dev mailing list
[email protected]
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev
