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

stddoclet: undesirable warning generated for inherited exception doc

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 1.4.0
    • 1.3.0, 1.4.0
    • tools
    • beta3
    • generic, x86, sparc
    • generic, linux, solaris_2.6
    • Verified

      javadoc generates a warning like this:

      javadoc: warning - Method test.Foo.Bar.foo
              declares that it throws java.lang.ClassNotFoundException,
              but does not document it.

      even though the javadoc that's actually generated for the method does contain documentation for the exception, copied directly from a supertype. No warning should be generated in this case.

      Consider this simple example:

      package test;

      public class Foo {
          /**
           * Does foo.
           *
           * @throws ClassNotFoundException on a whim
           */
          public void foo() throws ClassNotFoundException {}

          public static class Bar extends Foo {
      public void foo() throws ClassNotFoundException {}
          }
      }

            jhosunw Jamie Ho (Inactive)
            bscheiflsunw Bob Scheifler (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: