Bug 150593 Enhancements for ResourceManager
The attached patch addresses the following in ResourceManager - Fixes several JavaDoc bugs - Adds a "getImage" method that implements the common pattern of "return existing image if known, or allocate a new image otherwise"
bundles/org.eclipse.jface/src/org/eclipse/jface/resource/ResourceManager.java
*
     * @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();
		}
    }
    
    /**
     * Returns the default image that will be returned in the event that the intended
     * image is missing.