Saturday, 23rd June 2012, 18:31 by galehar
Heh, sorry.
There has been an attempt at using doxygen to document the code. A few function and variables use doxygen style comment for self documenting, but I doubt it would be really useful to you.
Anyway, sometimes variables have a comment next to their declaration explaining their role or purpose. Otherwise, just use some tool to find declaration and occurrences of the variable to see where and how it's used. Some devs use ctags, I use eclipse, there also grep and git grep.
You can also ask in ##crawl-dev, or in the coding forum like you just did (and where I'm moving this thread btw).
Regarding coding a feature before discussing it, I can totally understand the feeling, and I did it in the past. If it can be controversial, then you take the risk that the feature will be rejected. If it's a straight interface improvement, then there's not much risk.
Have fun coding, looking forward to reviewing your work.
<+Grunt> You dereference an invalid pointer! Ouch! That really hurt! The game dies...