How are we doing?
mattfinn at gmail.com
Fri Jun 2 20:42:03 CDT 2006
>From the viewpoint of a new developer (Summer of Code), having a few
"The purpose of this function" comments would have been / still would
be very useful!
It's painfully having to figure out what exactly a function does, that
calls five other functions that you have to look into, which each call
another cryptically named function.
Also, sometimes it's not obvious why a function is called. A comment
like "Call funcResetStatusVariables because the above code triggers a
redraw which can break them" would save a new developer twenty minutes
of "But why update them THERE?! Does my code have to do that?".
More information about the wine-devel