The big documentation commit

Load of documentation, formatting tweaks. 
Been applying Obj-C best practice to quite a few headers as I go.
Retired a couple of bits.
Updated cocos2d.h headers, added basic sound support.