So, you need people to analyze the 'core code' of the game? Hmm. I like poking through code, trying to figure out what it does. It's like a crossword puzzle, with extremely cryptic clues, and the lines aren't put one above the other.
What source files are the most mystifying and need the most demystification?
Not that I'll necessarily actually do it... classes are about to resume.
There isn't really a single source file that you could independantly "demystify", especially in the "core code". Everything is connected, and if you want to explain in detail what a specific field of a structure is used for, you'll have to look for clues everywhere where it is used. And figuring out the core functionality for some part of the game means you have to know exactly how every structure that is involved fits in. Add to that the fact that some variables and structure fields are used multiple times for different things, and you may be able to imagine the work involved (but at the same time, the value of such documentation). Fortunately, it gets easier as you know more of the code already, and so I occasionally document things like this myself when I'm working on something related. As an example, look at doc/devel/generate, which I recently wrote (you'll need a current CVS version).
Logged
“When Juffo-Wup is complete when at last there is no Void, no Non when the Creators return then we can finally rest.”