Heavy commenting

Plenty of comments now in place, some minor modifications due to errors