Hello,

As an addendum to the fix-the-warnings JEP, please review this change which fixes some bad @throws references and the like over in corba:

    8086029: Fix doclint reference warnings in org.omg.CORBA
    http://cr.openjdk.java.net/~darcy/8086029.0/

Patch below.

Thanks,

-Joe

--- old/src/java.corba/share/classes/org/omg/CORBA/DynAny.java  2015-06-08 
18:21:46.550021735 -0700
+++ new/src/java.corba/share/classes/org/omg/CORBA/DynAny.java  2015-06-08 
18:21:46.478021732 -0700
@@ -52,8 +52,8 @@
      *
      * @param dyn_any the <code>DynAny</code> object whose contents
      *                are assigned to this <code>DynAny</code>.
-     * @throws Invalid if the source <code>DynAny</code> is
-     *            invalid
+     * @throws org.omg.CORBA.DynAnyPackage.Invalid if the source
+     * <code>DynAny</code> is invalid
      */
     public void assign(org.omg.CORBA.DynAny dyn_any)
         throws org.omg.CORBA.DynAnyPackage.Invalid;
@@ -63,8 +63,8 @@
      * object.
      *
      * @param value the <code>Any</code> object.
-     * @throws Invalid if the source <code>Any</code> object is
-     *                    empty or bad
+     * @throws org.omg.CORBA.DynAnyPackage.Invalid if the source
+     * <code>Any</code> object is empty or bad
      */
     public void from_any(org.omg.CORBA.Any value)
         throws org.omg.CORBA.DynAnyPackage.Invalid;
@@ -74,9 +74,9 @@
      * object.
      *
      * @return the <code>Any</code> object.
-     * @throws Invalid if this <code>DynAny</code> is empty or
-     *                    bad.
-     *            created or does not contain a meaningful value
+     * @throws org.omg.CORBA.DynAnyPackage.Invalid if this
+     * <code>DynAny</code> is empty or bad.  created or does not
+     * contain a meaningful value
      */
     public org.omg.CORBA.Any to_any()
         throws org.omg.CORBA.DynAnyPackage.Invalid;
--- old/src/java.corba/share/classes/org/omg/CORBA/DynArray.java        
2015-06-08 18:21:46.866021744 -0700
+++ new/src/java.corba/share/classes/org/omg/CORBA/DynArray.java        
2015-06-08 18:21:46.798021742 -0700
@@ -38,8 +38,8 @@
      * Returns the value of all the elements of this array.
      *
      * @return the array of <code>Any</code> objects that is the value
-         *         for this <code>DynArray</code> object
-         * @see #set_elements
+     *         for this <code>DynArray</code> object
+     * @see #set_elements
      */
     public org.omg.CORBA.Any[] get_elements();
@@ -48,8 +48,9 @@
      * <code>DynArray</code> object to the given array.
      *
      * @param value the array of <code>Any</code> objects
-     * @exception InvalidSeq if the sequence is bad
-         * @see #get_elements
+     * @exception org.omg.CORBA.DynAnyPackage.InvalidSeq if the
+     * sequence is bad
+     * @see #get_elements
      */
     public void set_elements(org.omg.CORBA.Any[] value)
         throws org.omg.CORBA.DynAnyPackage.InvalidSeq;
--- old/src/java.corba/share/classes/org/omg/CORBA/DynSequence.java     
2015-06-08 18:21:47.154021753 -0700
+++ new/src/java.corba/share/classes/org/omg/CORBA/DynSequence.java     
2015-06-08 18:21:47.082021751 -0700
@@ -65,8 +65,9 @@
          * array.
      *
      * @param value the array of <code>Any</code> objects to be set
-     * @exception InvalidSeq if the array of values is bad
-         * @see #get_elements
+     * @exception org.omg.CORBA.DynAnyPackage.InvalidSeq if the array
+     * of values is bad
+     * @see #get_elements
      */
     public void set_elements(org.omg.CORBA.Any[] value)
         throws org.omg.CORBA.DynAnyPackage.InvalidSeq;
--- old/src/java.corba/share/classes/org/omg/CORBA/ServerRequest.java   
2015-06-08 18:21:47.450021762 -0700
+++ new/src/java.corba/share/classes/org/omg/CORBA/ServerRequest.java   
2015-06-08 18:21:47.374021759 -0700
@@ -248,7 +248,7 @@
      * contain an exception will result in a BAD_PARAM system exception. 
Passing
      * in an unlisted user exception will result in either the DIR receiving a
      * BAD_PARAM system exception or in the client receiving an
-     * UNKNOWN_EXCEPTION system exception.
+     * UNKNOWN system exception.
      *
      * @param any       the <code>Any</code> object containing the exception
      * @deprecated use set_exception()
@@ -272,13 +272,13 @@
      * will cause a BAD_PARAM system exception to be thrown. Passing
      * in an unlisted user exception will result in either the DIR receiving a
      * BAD_PARAM system exception or in the client receiving an
-     * UNKNOWN_EXCEPTION system exception.
+     * UNKNOWN system exception.
      *
      * @param any       the <code>Any</code> object containing the exception
      * @exception BAD_PARAM if the given <code>Any</code> object does not
      *                      contain an exception or the exception is an
      *                      unlisted user exception
-     * @exception UNKNOWN_EXCEPTION if the given exception is an unlisted
+     * @exception UNKNOWN if the given exception is an unlisted
      *                              user exception and the DIR did not
      *                              receive a BAD_PARAM exception
      * @see <a href="package-summary.html#unimpl"><code>CORBA</code>


Reply via email to