better java docs , and gave a big picture section to the javadocs