To me, it seems the authors' style is this. Once you get within the
thinking, it's not that hard to follow the code.
What could be useful, though, would be a completely separate
"walkthrough" of the source, a narrative tour of Luaville. This
reminds me of the "ZX Spectrum Complete Disassembly" book of the 80's,
where the whole 16K of ROM assembly was narrated, telling exactly what
every bit does (and listing bugs found ;). Such a commentary could be
done by others than the authors.
It only makes sense when the code base isn't changing much.
-asko
Bru, Pierre kirjoitti 3.3.2008 kello 1:39:
People have been asking for more comments in the source code. I
wouldn't necessarily agree, [...]