From d562ee461735a6daa6dcdfcc559f851cad160aaf Mon Sep 17 00:00:00 2001
From: Michael Stahl <mstahl@redhat.com>
Date: Wed, 17 Feb 2016 00:04:51 +0100
Subject: ridljar: fix javadoc warnings

Change-Id: Ifa85299dd3366fb9a9639e669a02678ea9268260
---
 ridljar/com/sun/star/uno/IBridge.java          |  3 +++
 ridljar/com/sun/star/uno/ITypeDescription.java |  9 +++++++++
 ridljar/com/sun/star/uno/UnoRuntime.java       | 11 +++++++++++
 3 files changed, 23 insertions(+)

diff --git a/ridljar/com/sun/star/uno/IBridge.java b/ridljar/com/sun/star/uno/IBridge.java
index 298378f32e60..26fe58015daa 100644
--- a/ridljar/com/sun/star/uno/IBridge.java
+++ b/ridljar/com/sun/star/uno/IBridge.java
@@ -85,6 +85,9 @@ public interface IBridge {
      *
      * <p>Sends involved threads an <code>InterruptedException</code>.  Releases
      * mapped objects.</p>
+     *
+     * @throws InterruptedException it's deprecated so who cares.
+     * @throws IOException it's deprecated so who cares.
      */
     void dispose() throws InterruptedException, IOException;
 }
diff --git a/ridljar/com/sun/star/uno/ITypeDescription.java b/ridljar/com/sun/star/uno/ITypeDescription.java
index b326e9c421bc..1495c54f5a8c 100644
--- a/ridljar/com/sun/star/uno/ITypeDescription.java
+++ b/ridljar/com/sun/star/uno/ITypeDescription.java
@@ -45,6 +45,9 @@ public interface ITypeDescription {
      * Gets the <code>IMethodDescription</code> for the
      * method with index methodId, if it exists, otherwise
      * returns <code>null</code>.
+     *
+     * @param methodId the index.
+     *
      * @return  the <code>IMethodDescription</code>.
      */
     IMethodDescription getMethodDescription(int methodId);
@@ -53,6 +56,9 @@ public interface ITypeDescription {
      * Gets the <code>IMethodDescription</code> for the
      * method with the name <code>name</code>, if it exists,
      * otherwise returns <code>null</code>.
+     *
+     * @param name the name of the method.
+     *
      * @return  the <code>IMethodDescription</code>.
      */
     IMethodDescription getMethodDescription(String name);
@@ -69,6 +75,9 @@ public interface ITypeDescription {
      * Gets the <code>IFieldDescription</code> for the
      * field with the name <code>name</code>, if it exists,
      * otherwise returns <code>null</code>.
+     *
+     * @param name the name of the field.
+     *
      * @return  the <code>IFieldDescription</code>.
      */
       IFieldDescription getFieldDescription(String name);
diff --git a/ridljar/com/sun/star/uno/UnoRuntime.java b/ridljar/com/sun/star/uno/UnoRuntime.java
index 8c822d33b969..114753d71d49 100644
--- a/ridljar/com/sun/star/uno/UnoRuntime.java
+++ b/ridljar/com/sun/star/uno/UnoRuntime.java
@@ -160,6 +160,7 @@ public class UnoRuntime {
      * Queries the given UNO object for the given Java class (which must
      * represent a UNO interface type).
      *
+     * @param <T> the requested UNO interface type.
      * @param zInterface a Java class representing a UNO interface type
      * @param object a reference to any Java object representing (a facet of) a
      * UNO object; may be <code>null</code>
@@ -401,6 +402,8 @@ public class UnoRuntime {
      *
      * @param name the name of the environment
      * @param context the context of the environment
+     * @throws Exception if something goes awry.
+     * @return an environment.
      * @see com.sun.star.uno.IEnvironment
      *
      * @deprecated As of UDK&nbsp;3.2.0, this method is deprecated, without
@@ -440,6 +443,7 @@ public class UnoRuntime {
      * @param from the source environment
      * @param to the target environment
      * @param args the initial arguments for the bridge
+     * @throws Exception if something goes awry.
      * @return the requested bridge
      * @see #getBridgeByName
      * @see com.sun.star.uno.IBridge
@@ -496,6 +500,7 @@ public class UnoRuntime {
      * @param to the name of the target environment
      * @param toContext the context for the target environment
      * @param args the initial arguments for the bridge
+     * @throws Exception if something goes awry.
      * @return the requested bridge
      * @see #getBridge
      * @see #getEnvironment
@@ -546,6 +551,7 @@ public class UnoRuntime {
      *
      * @param from the source environment
      * @param to the target environment
+     * @throws Exception if something goes awry.
      * @return the requested mapping
      * @see com.sun.star.uno.IEnvironment
      * @see com.sun.star.uno.IMapping
@@ -575,6 +581,7 @@ public class UnoRuntime {
      *
      * @param from the name of the source environment
      * @param to the name of the target environment
+     * @throws Exception if something goes awry.
      * @return the requested mapping
      * @see #getEnvironment
      * @see #getMapping
@@ -594,6 +601,10 @@ public class UnoRuntime {
      *
      * <p>Releases all references to bridges and environments.</p>
      *
+     * @return true if another thread didn't re-insert some bridge or
+     *         environment before the method returns.  Why that information
+     *         would be useful is anybody's guess.
+     *
      * @deprecated As of UDK&nbsp;3.2.0, this method is deprecated, without
      * offering a replacement.
      */
-- 
cgit