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
* 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)
     */
    public final Image createImageWithDefault(ImageDescriptor descriptor) {
        if (descriptor == null) {
        	return getDefaultImage();
        }
        
        try {
			return (Image) create(descriptor);
		} catch (DeviceResourceException e) {
			Policy.getLog().log(
					new Status(IStatus.WARNING, "org.eclipse.jface", 0, 
							"The image could not be loaded: " + descriptor, 
							e));
			return getDefaultImage();
		} catch (SWTException e) {
			Policy.getLog().log(
					new Status(IStatus.WARNING, "org.eclipse.jface", 0, 
							"The image could not be loaded: " + descriptor, 
							e));
			return getDefaultImage();
		}
    }