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

False warning: x declares that it throws exception but does not document it

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P3 P3
    • None
    • 1.3.0
    • tools

      When we run Javadoc over our source using the following version of Java:

      java version "1.4.0-beta"
      Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-beta-b65)
      Java HotSpot(TM) Client VM (build 1.4.0-beta-b65, mixed mode)

      We get a lot of these Warnings:

      javadoc: warning - Method xxx.yyy.FooBarImpl.fooMethod
              declares that it throws java.beans.PropertyVetoException,
              but does not document it.

      Even though the interface it implements *does* have the following


        /**
         * Does blah blah blah
         *
         * @param param1 the first parameter
         * @param param2 the second parameter
         *
         * @throws PropertyVetoException if either the
         * <code>param1</code> or <code>param2</code> parameters are
         * <code>null</code>
         *
         */
        public void fooMethod(String param1, Object param2) throws
      PropertyVetoException;

      This does not happen when running the Javadoc out of Java 1.3.1

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

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: