updated docs on todo methods
cleanup javadoc