Java doc, and reviewing

added some more info regarding some classes and methods.