Bug 151778 Errors in ResourceManager JavaDoc
In the doc of createImage method you read: Creates an image, given an image descriptor. Images allocated in this manner must be disposed by disposeImage, and never by calling Image.dispose(). disposeImage is not present, maybe it should be destroyImage? The same error for the other creation methods.
bundles/org.eclipse.jface/src/org/eclipse/jface/resource/ResourceManager.java
/**
     * Returns the default image that will be returned in the event that the intended
     * image is missing.
     * 
     * @since 3.1
     *
     * @return a default image that will be returned in the event that the intended
     * image is missing.
     */
    protected abstract Image getDefaultImage();
    /**
     * Undoes everything that was done by createImage(...).
     * 
     * @since 3.1 
     *
     * @param descriptor identifier for the image to dispose
     */
    public final void destroyImage(ImageDescriptor descriptor) {
        destroy(descriptor);
    }
    /**
     * Allocates a color, given a color descriptor. Any color allocated in this
     * manner must be disposed by calling disposeColor(...) and never by calling 
     * Color.dispose() directly.
     * 
     * @since 3.1 
     *
     * @param descriptor descriptor for the color to create
     * @return the Color described by the given ColorDescriptor (not null)