Bug 73058 [Images] ImageDescriptor.createImage() javadoc needs dispose() reference
org.eclipse.jface.resource.ImageDescriptor.createImage() javadoc needs dispose reference. When creating images using the above call, the Javadoc just says that a new image is created. Reciently I had troubles with a "No more handles" bug, which turned out to be that I was never disposing of the images I had created. It would be very useful to have the Javadoc for the createImage() calls mention that all images must be explictly disposed of. Mentioning this might help other people avoid this problem in the future. Something along the lines of: Note: All Images created using this call must be explictly disposed of using the dispose() call. They will not be automatically garbage collected.
bundles/org.eclipse.jface/src/org/eclipse/jface/resource/ImageDescriptor.java
*/
    public Image createImage(boolean returnMissingImageOnError) {
        return createImage(returnMissingImageOnError, Display.getCurrent());
    }
    /**
     * Creates and returns a new SWT image for this image descriptor.
     * A default image is returned in the event of an error.
     * <p>
     * Note: it is still possible for this method to return <code>null</code> in extreme cases,
     * for example if SWT runs out of image handles.
     * </p>
     *
     * @param device the device on which to create the image
     * @return a new image or <code>null</code> if the image could not be created
     * @since 2.0
     */
    public Image createImage(Device device) {
        return createImage(true, device);
    }
    /**
     * Creates and returns a new SWT image for this image descriptor.
     * In the even of an error, a default image is returned if 
     * <code>returnMissingImageOnError</code> is true, otherwise <code>null</code>
     * is returned.  
     * <p>
     * Note: Even if <code>returnMissingImageOnError</code> is true, 
     * it is still possible for this method to return <code>null</code> in extreme cases,
     * for example if SWT runs out of image handles.
     * </p>
     *