added additional javadoc comments