Changed the order of function calls within CocosDenshion::SimpleAudioEngine::end()

to first detach the OpenAL source from the buffers so that sound buffers can be successfully deleted afterwards.

Additionally, improved the documentation within the header file a little bit.