Move the comments into code to the body text

I have moved the comments into code to the body text for a better read!
please, keep this javadoc...