updated all comments to be cleaner, more understandable, and work with
the java documentation viewer