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
*/
    protected static final ImageData DEFAULT_IMAGE_DATA = new ImageData(6, 6,
            1, new PaletteData(new RGB[] { new RGB(255, 0, 0) }));
    /**
     * Constructs an image descriptor.
     */
    protected ImageDescriptor() {
        
    }
    /**
     * Creates and returns a new image descriptor from a file.
     * Convenience method for
     * <code>new FileImageDescriptor(location,filename)</code>.
     *
     * @param location the class whose resource directory contain the file
     * @param filename the file name
     * @return a new image descriptor
     */
    public static ImageDescriptor createFromFile(Class location, String filename) {
        return new FileImageDescriptor(location, filename);
    }
    /**
     * Creates and returns a new image descriptor from a URL.
     *
     * @param url The URL of the image file.
     * @return a new image descriptor
     */
    public static ImageDescriptor createFromURL(URL url) {
        if (url == null) {
            return getMissingImageDescriptor();