User Guide: fixed one spelling mistake
Others: javadoc comments added (+also some improvements to method names)