Lights and comments

Added lots of comments.
Added init_light_sources to add lights recursively from list of lights.
Added missing return statements.
Removed some deprecated functions.