Adding explanatory Javadoc.