Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4351766

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

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P4
    • Resolution: Fixed
    • Affects Version/s: 1.3.0
    • Fix Version/s: 1.4.0
    • Component/s: docs
    • Subcomponent:
    • Resolved In Build:
      beta
    • CPU:
      sparc
    • OS:
      solaris_2.5

      Description



      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).

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

        Attachments

          Activity

            People

            Assignee:
            jhosunw Jamie Ho (Inactive)
            Reporter:
            kaisunw Kai Kai (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: