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

[Lance @ Oracle]

+1


Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive
Burlington, MA 01803
Lance.Andersen at oracle.com
Sent from my iPad

> On Jun 8, 2015, at 9:27 PM, joe darcy <joe.darcy at oracle.com> wrote:
> 
> 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>
> 
>