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

stddoclet: All warnings and errors should show the responsible file

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 1.4.0
    • 1.2.2, 1.3.0, 1.3.1
    • tools
    • beta2
    • generic, x86, sparc
    • solaris_2.6, windows_2000
    • Verified

      Name: rlT66838 Date: 04/13/2000
      java version "1.2.2"
      Classic VM (build JDK-1.2.2.-001, native threads, symcjit)


      The following code and javadoc command displays the following
      warning, which is an example of how it can be extremely hard to find
      the java source code responsible for this bug:

        javadoc: warning - Tag @link: Class or Package not found: Math Math link
        (Review ID: 103623)

      Warnings show up at different places in the output, many times they
      are caused by the same source. If all warnings and errors showed
      the responsible file, life would be easier.


      (another bug #.....
      speaks to the problem with {@link} that causes the warning).

      ------------------------ CODE ------------------------
      package nl.virgil;

      import java.lang.*;
      import java.lang.Integer;

      public class Test {

          /**
           * This {@link Math Math link} won't work, not even when it is fully
           * qualified as this link {@link java.lang.Math} shows, even importing
           * java.lang.* doesn't help.
           * <p>
           * The funny thing is that everything for a {@link String String link}
           * seems to work.
           * <p>
           * You can get it working by importing all classes explicitly as you can
           * see in this {@link Integer Integer link}.
           */
          public Test() {

          }
      }

      javac nl/virgil/Test.java
      javadoc -link http://java.sun.com/products/jdk/1.2/docs/api nl.virgil

            jhosunw Jamie Ho (Inactive)
            dkramersunw Douglas Kramer (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: