JDK 9 RFR of JDK-8086029: Fix doclint reference warnings in org.omg.CORBA

[joe darcy]

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>