I was debugging an application that uses the renameTo() method of the File class in the java io package. The problem was that in certain situations, the application uses renameTo() to rename a file to a location on a different NFS mounted filesystem. However, the renameTo method does not support this.

I spent a lot of time debugging this until I realized that renameTo() doesn't support renaming a file to a location on a different filesystem. I assume others have expected renameTo() to support this because of bug 4073756. I think it would be a good idea to mention this in the javadocs on the web. That is, if there are no plans on adding more functionality to the renameTo() method.