Updated commentary for better javadoc support.