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

Consider discarding repeated warnings

    XMLWordPrintable

Details

    • Bug
    • Resolution: Unresolved
    • P4
    • tbd
    • 20
    • tools
    • None

    Description

      Writing tests for JDK-8287379 has highlighted the following problem: a tag misuse warning may be repeated multiple times:

      Generating test1/out/B.html...
      test1/src/B.java:1: warning: Tag @inheritDoc cannot be used in class documentation. It can only be used in the following types of documentation: method.
      /** {@inheritDoc} */
          ^
      test1/src/B.java:1: warning: Tag @inheritDoc cannot be used in class documentation. It can only be used in the following types of documentation: method.
      /** {@inheritDoc} */
          ^
      Generating test1/out/package-summary.html...
      test1/src/B.java:1: warning: Tag @inheritDoc cannot be used in class documentation. It can only be used in the following types of documentation: method.
      /** {@inheritDoc} */
          ^
      Generating test1/out/package-tree.html...
      Generating test1/out/overview-tree.html...
      Building index for all classes...
      Generating test1/out/allclasses-index.html...
      test1/src/B.java:1: warning: Tag @inheritDoc cannot be used in class documentation. It can only be used in the following types of documentation: method.
      /** {@inheritDoc} */
          ^
      Generating test1/out/allpackages-index.html...
      Generating test1/out/index-all.html...
      test1/src/B.java:1: warning: Tag @inheritDoc cannot be used in class documentation. It can only be used in the following types of documentation: method.
      /** {@inheritDoc} */
          ^
      Generating test1/out/search.html...
      Generating test1/out/index.html...
      Generating test1/out/help-doc.html...
      5 warnings

      -----
      This might require treatment similar to that for errors; see

      com.sun.tools.javac.util.Log#shouldReport(javax.tools.JavaFileObject, int)
      com.sun.tools.javac.util.Log#recorded

      Attachments

        Activity

          People

            prappo Pavel Rappo
            prappo Pavel Rappo
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated: