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

line numbers in warnings are misleading (start of class rather than bad line)

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P5 P5
    • 8
    • 1.4.0
    • tools
    • sparc
    • solaris_9
    • Not verified

      For build 83 of Merlin,
      -=---------------------


      for the following testcase,

      jtools-sqe:/home/vr128054/vertest/4493048 143 % more test.java
      /**
       * @bug EmitAWarningAndStop
       * @bogusTag NoMoreThanOneWarning
       * @IAmNotATag JustOneWarning
       * @author ValidTag
       */
      public class test
      {
      }

      the following runtime log is got.
      =================================

      jtools-sqe:/home/vr128054/vertest/4493048 144 % javadoc test.java
      Loading source file test.java...
      Constructing Javadoc information...
      Standard Doclet version 1.4.0

      Generating constant-values.html...
      Building tree for all the packages and classes...
      Building index for all the packages and classes...
      Generating overview-tree.html...
      Generating index-all.html...
      Generating deprecated-list.html...
      Building index for all classes...
      Generating allclasses-frame.html...
      Generating allclasses-noframe.html...
      Generating index.html...
      Generating packages.html...
      Generating test.html...
      test.java:7: warning - @bug is an unknown tag.
      test.java:7: warning - @bogusTag is an unknown tag.
      test.java:7: warning - @IAmNotATag is an unknown tag.
      Generating package-list...
      Generating help-doc.html...
      Generating stylesheet.css...
      3 warnings

      All the three warnings are reported at line number 7, which is the location of the start of the class which is documented. This might be misleading when the classes have huge documentations with identical tags, descriptions etc.

            jjg Jonathan Gibbons
            rvijayansunw Ra Vijayan (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: