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
/**
     * Deallocates a resource previously allocated by create(...). Descriptors are compared
     * by equality, not identity. If the same resource was created multiple times, this may
     * decrement a reference count rather than disposing the actual resource.  
     * 
     * @since 3.1 
     *
     * @param descriptor identifier for the resource
     */
    public abstract void destroy(DeviceResourceDescriptor descriptor);
    
    /**
     * Creates an image, given an image descriptor. Images allocated in this manner must
     * be disposed by disposeImage, and never by calling Image.dispose().
     * 
     * @since 3.1 
     *
     * @param descriptor descriptor for the image to create
     * @return the Image described by this descriptor (possibly shared by other equivalent
     * ImageDescriptors)
     * @throws DeviceResourceException if unable to allocate the Image
     */
    public final Image createImage(ImageDescriptor descriptor) throws DeviceResourceException {
    	
    	Assert.isNotNull(descriptor);
    	
        return (Image)create(descriptor);
    }
    
    /**