more javadoc and fixed bad @sees