changing public api ?

[Brad Walker]

I'm in need of some help!

I'm working on cleaning up uses of deprecated API usages and when I do
this, there are impacts on the public API because an exception that was
previously being thrown is now no longer.

For example, in
*ide/image/src/org/netbeans/modules/image/ImageDataObject.java* there is
this method..

            /** Gets value of property. Overrides superclass method. */
            public Icon getValue() throws InvocationTargetException {
                try {
                    return new ImageIcon(obj.getPrimaryFile().getURL());
                } catch (FileStateInvalidException fsie) {
                    throw new InvocationTargetException(fsie);
                }
            }

If I do something simple like change the getURL() to toURL() to remove the
deprecation warning, the exception will no longer be thrown.

This means I have to change the Public API and remove the throws statement..

What is the process (files, docs, etc.) for changing a public API?

Thanks.

-brad w.