improved Javadoc