further comments in the code

more description of what does what!!!