(spec) File.renameTo and File class javadoc - misleading immutability statement

A DESCRIPTION OF THE REQUEST :
In the Java 2 std edition the File api documentation states "Instances of the File class are immutable; that is, once created, the abstract pathname represented by a File object will never change."

This is inconsistent with the effect of the renameTo (File des) method. After a successful rename, the pathname is different.

JUSTIFICATION :
Improve accuracy of API

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
not applicable
ACTUAL -
not applicable
###@###.### 2005-03-28 05:14:44 GMT