updated code docs. prefixed names of non-public methods with an underscore according to our coding standard.
added blank lines to code comments to improve legibility.