Can we add javadocs to both public methods, as this class is part of the Java API? We recently decided to use javadocs properly (finally). We'll fix existing classes that don't have it yet, but newly added methods or classes need to have it, especially if they are public or protected classes which are part of the Java API.