number of java.io.File methods has wrong javadoc spec

Name: akR10050 Date: 07/10/2000



Below example belongs to all methods in java.io.File which has '{@link
java.lang.SecurityManager#checkWrite}' in their javadoc comments. Incomplete
reference to the method causes incorrect linking during javadoc run. As far as I
investigate, there are no methods which actually call
java.lang.SecurityManager.checkWrite(java.io.FileDescriptor) to check write
access, moreover this is impossible.

Here is a common example of the described behaviour:

The javadoc specification for java.io.File.createNewFile() states:

--------------- javadoc excerpt ----------------------

Throws:
          
...
          SecurityException - If a security manager exists and its
          SecurityManager.checkWrite(java.io.FileDescriptor) method denies write
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
          access to the file

------------------------------------------------------

When SecurityManager denies read and write access to the specified file, it is
impossible to get java.io.FileDescriptor associated with this File instance,
thus it is impossible to call checkWrite(java.io.FileDescriptor).

======================================================================