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

javadoc mishandles generation of @see tag with references to a statically imported nested type

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P4
    • Resolution: Cannot Reproduce
    • Affects Version/s: 9
    • Fix Version/s: None
    • Component/s: tools
    • Labels:
      None

      Description

      In the type javax.sound.sampled.spi.AudioFileWriter in the java.desktop module, there is an @see reference

          @see #isFileTypeSupported(Type, AudioInputStream)

      where "Type" is the statically imported nested type

          import static javax.sound.sampled.AudioFileFormat.Type;

      While there are many uses of "Type" in the file in question, when javadoc is run over AudioFileWriter, the following warning is produced:

      jdk/src/java.desktop/share/classes/javax/sound/sampled /spi/AudioFileWriter.java:127: warning - Tag @see: can't find isFileTypeSupported(Type, AudioInputStream) in javax.sound.sampled.spi.AudioFileWriter

      Changing the @see reference to

          @see #isFileTypeSupported(AudioFileFormat.Type, AudioInputStream)

      resolve the problem. Therefore, it seems that javadoc is not properly handling the statically imported in this situation since other occurrences of Type do *not* have to be (partially) qualified.

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              ksrini Kumar Srinivasan
              Reporter:
              darcy Joe Darcy
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: