updating javadocs
code and doc cleanup
adding documentation