Bug 83248 Warnings in javadoc generation
If you check N20050119-0010/compilelogs/platform.doc.isv.javadoc.txt, you will find that there are a lot of warnings during the javadoc generation of platform plugins. I will attach patches to get rid of them.
bundles/org.eclipse.jface/src/org/eclipse/jface/resource/ImageCache.java
* of images (where equivalent descriptors are <code>equals(Object)</code>).
 * 
 * It is recommended to use this class as a singleton, since it creates a thread
 * for cleaning out images.
 * 
 * It is the responsibility of the user to ensure that the image descriptors are
 * kept around as long as the images are needed. The users of this cache should
 * not explicitly dispose the images.
 * 
 * Upon request of a disabled or gray image, the normal image will be created as
 * well (if it was not already in the cache) in order to create the disabled or
 * gray version of the image.
 * 
 * This cache makes no guarantees on how long the cleaning process will take, or
 * when exactly it will occur.
 * 
 * 
 * This class may be instantiated; it is not intended to be subclassed.
 * 
 * @since 3.1
 */
public final class ImageCache {
	/**
	 * An equivalent set of weak references to equivalent descriptors. The
	 * equivalence of image descriptors is determined through
	 * <code>equals(Object)</code>.
	 * 
	 * @since 3.1
	 */
	private static final class EquivalenceSet {