Java cleanup - fix various javadoc issues

Change-Id: Ic292fddb1b9c0ba98b983b257059e50aa1963e46

7 files changed, 29 insertions, 33 deletions

diff --git a/jurt/com/sun/star/comp/connections/Acceptor.java b/jurt/com/sun/star/comp/connections/Acceptor.java
index 2d2f8af982a9..e70398dbf47c 100644
--- a/jurt/com/sun/star/comp/connections/Acceptor.java
+++ b/jurt/com/sun/star/comp/connections/Acceptor.java
@@ -34,9 +34,9 @@ import com.sun.star.registry.XRegistryKey;
  * components (like <code>com.sun.star.connection.socketAcceptor</code>) to
  * implement its functionality.</p>
  *
- * @see com.sun.star.connections.XAcceptor
- * @see com.sun.star.connections.XConnection
- * @see com.sun.star.connections.XConnector
+ * @see com.sun.star.connection.XAcceptor
+ * @see com.sun.star.connection.XConnection
+ * @see com.sun.star.connection.XConnector
  * @see com.sun.star.loader.JavaLoader
  *
  * @since UDK 1.0
@@ -100,8 +100,8 @@ public final class Acceptor implements XAcceptor {
      * @param connectionDescription the description of the connection.
      * @return an <code>XConnection</code> to the client.
      *
-     * @see com.sun.star.connections.XConnection
-     * @see com.sun.star.connections.XConnector
+     * @see com.sun.star.connection.XConnection
+     * @see com.sun.star.connection.XConnector
      */
     public XConnection accept(String connectionDescription) throws
         AlreadyAcceptingException, ConnectionSetupException,
diff --git a/jurt/com/sun/star/comp/connections/Connector.java b/jurt/com/sun/star/comp/connections/Connector.java
index da5925c6666f..98a065ed9679 100644
--- a/jurt/com/sun/star/comp/connections/Connector.java
+++ b/jurt/com/sun/star/comp/connections/Connector.java
@@ -34,9 +34,9 @@ import com.sun.star.registry.XRegistryKey;
  * components (like <code>com.sun.star.connection.socketConnector</code>) to
  * implement its functionality.</p>
  *
- * @see com.sun.star.connections.XAcceptor
- * @see com.sun.star.connections.XConnection
- * @see com.sun.star.connections.XConnector
+ * @see com.sun.star.connection.XAcceptor
+ * @see com.sun.star.connection.XConnection
+ * @see com.sun.star.connection.XConnector
  * @see com.sun.star.loader.JavaLoader
  *
  * @since UDK 1.0
@@ -98,8 +98,8 @@ public class Connector implements XConnector {
      * @param connectionDescription the description of the connection.
      * @return an <code>XConnection</code> to the server.
      *
-     * @see com.sun.star.connections.XAcceptor
-     * @see com.sun.star.connections.XConnection
+     * @see com.sun.star.connection.XAcceptor
+     * @see com.sun.star.connection.XConnection
      */
     public synchronized XConnection connect(String connectionDescription)
         throws NoConnectException, ConnectionSetupException
diff --git a/jurt/com/sun/star/comp/connections/ConstantInstanceProvider.java b/jurt/com/sun/star/comp/connections/ConstantInstanceProvider.java
index 4711b654ca33..f9dd02caea1f 100644
--- a/jurt/com/sun/star/comp/connections/ConstantInstanceProvider.java
+++ b/jurt/com/sun/star/comp/connections/ConstantInstanceProvider.java
@@ -89,7 +89,7 @@ public class ConstantInstanceProvider implements XInstanceProvider {
      * Constructs a new <code>ConstantInstanceProvider</code>.
      * Uses the provided ServiceManager as the provided instance.
      * <p>
-     * @param    serviceName   the provided service manager
+     * @param    serviceManager   the provided service manager
      */
     public ConstantInstanceProvider(XMultiServiceFactory serviceManager) {
         _serviceManager = serviceManager;
diff --git a/jurt/com/sun/star/comp/connections/PipedConnection.java b/jurt/com/sun/star/comp/connections/PipedConnection.java
index a972ea977fea..04856ba925bf 100644
--- a/jurt/com/sun/star/comp/connections/PipedConnection.java
+++ b/jurt/com/sun/star/comp/connections/PipedConnection.java
@@ -35,7 +35,7 @@ import com.sun.star.registry.XRegistryKey;
  * in one Process.
  * <p>
  * @author      Kay Ramme
- * @see         com.sun.star.connections.XConnection
+ * @see         com.sun.star.connection.XConnection
  * @see         com.sun.star.loader.JavaLoader
  * @since       UDK1.0
  */
@@ -158,9 +158,9 @@ public class PipedConnection implements XConnection {
      * Read the required number of bytes.
      * <p>
      * @return   the number of bytes read
-     * @param    aReadBytes   the outparameter, where the bytes have to be placed
+     * @param    aReadBytes   the out parameter, where the bytes have to be placed
      * @param    nBytesToRead the number of bytes to read
-     * @see       com.sun.star.connections.XConnection#read
+     * @see      com.sun.star.connection.XConnection#read
      */
     public synchronized int read(/*OUT*/byte[][] aReadBytes, int nBytesToRead) throws com.sun.star.io.IOException, com.sun.star.uno.RuntimeException {
         aReadBytes[0] = new byte[nBytesToRead];
@@ -214,7 +214,7 @@ public class PipedConnection implements XConnection {
      * Write bytes.
      * <p>
      * @param    aData the bytes to write
-     * @see       com.sun.star.connections.XConnection#write
+     * @see       com.sun.star.connection.XConnection#write
      */
     public void write(byte aData[]) throws com.sun.star.io.IOException, com.sun.star.uno.RuntimeException {
         _otherSide.receive(aData);
@@ -223,7 +223,7 @@ public class PipedConnection implements XConnection {
     /**
      * Flushes the buffer, notifies if necessary the other side that new data has arrived.
      * <p>
-     * @see       com.sun.star.connections.XConnection#flush
+     * @see       com.sun.star.connection.XConnection#flush
      */
     public void flush() throws com.sun.star.io.IOException, com.sun.star.uno.RuntimeException {
         synchronized(_otherSide) {
@@ -234,7 +234,7 @@ public class PipedConnection implements XConnection {
     /**
      * Closes the pipe.
      * <p>
-     * @see       com.sun.star.connections.XConnection#closed
+     * @see       com.sun.star.connection.XConnection#close()
      */
     public synchronized void close() throws com.sun.star.io.IOException, com.sun.star.uno.RuntimeException {
         if(!_closed) {
@@ -250,7 +250,7 @@ public class PipedConnection implements XConnection {
      * Gives a description of this pipe.
      * <p>
      * @return  the description
-     * @see       com.sun.star.connections.XConnection#getDescription
+     * @see       com.sun.star.connection.XConnection#getDescription
      */
     public String getDescription() throws com.sun.star.uno.RuntimeException {
         return getClass().getName();
diff --git a/jurt/com/sun/star/comp/loader/JavaLoader.java b/jurt/com/sun/star/comp/loader/JavaLoader.java
index 9ac66d00211b..73ff9d3f37bf 100644
--- a/jurt/com/sun/star/comp/loader/JavaLoader.java
+++ b/jurt/com/sun/star/comp/loader/JavaLoader.java
@@ -57,7 +57,6 @@ import com.sun.star.uno.AnyConverter;
  * @see         com.sun.star.loader.XImplementationLoader
  * @see         com.sun.star.loader.Java
  * @see         com.sun.star.comp.servicemanager.ServiceManager
- * @see         com.sun.star.lang.ServiceManager
  * @since       UDK1.0
  */
 public class JavaLoader implements XImplementationLoader,
@@ -143,7 +142,6 @@ public class JavaLoader implements XImplementationLoader,
     /**
      * Creates a new instance of the <code>JavaLoader</code> class.
      * <p>
-     * @return  new instance
      */
     public JavaLoader() {}
 
@@ -153,10 +151,8 @@ public class JavaLoader implements XImplementationLoader,
      * loading.
      * To set the <code>MultiServiceFactory</code> you can use the <code>com.sun.star.lang.XInitialization</code> interface, either.
      * <p>
-     * @return  new instance
      * @param   factory     the <code>ServiceManager</code>
-     * @see     com.sun.star.lang.ServiceManager
-     * @see     com.sun.star.lang.ServiceManager
+     * @see     com.sun.star.comp.servicemanager.ServiceManager
      * @see     com.sun.star.lang.XInitialization
      */
     public JavaLoader(XMultiServiceFactory factory) {
@@ -169,7 +165,7 @@ public class JavaLoader implements XImplementationLoader,
      * <p>
      * @param       args - the first parameter (args[0]) specifices the <code>ServiceManager</code>
      * @see         com.sun.star.lang.XInitialization
-     * @see         com.sun.star.lang.ServiceManager
+     * @see         com.sun.star.comp.servicemanager.ServiceManager
      */
     public void initialize( java.lang.Object[] args )
             throws com.sun.star.uno.Exception,
@@ -241,9 +237,9 @@ public class JavaLoader implements XImplementationLoader,
      * @param       implementationName          the implementation (class) name of the component
      * @param       implementationLoaderUrl     the URL of the implementation loader. Not used.
      * @param       locationUrl                 points to an archive (JAR file) which contains a component
-     * @param       xKey
-     * @see         com.sun.star.lang.XImplementationLoader
-     * @see         com.sun.star.com.loader.RegistrationClassFinder
+     * @param       xKey                        registry key
+     * @see         com.sun.star.loader.XImplementationLoader
+     * @see         com.sun.star.comp.loader.RegistrationClassFinder
      */
     public java.lang.Object activate( String implementationName,
                                       String implementationLoaderUrl,
diff --git a/jurt/com/sun/star/comp/servicemanager/ServiceManager.java b/jurt/com/sun/star/comp/servicemanager/ServiceManager.java
index 673db0468c3c..cc9b0323e8d8 100644
--- a/jurt/com/sun/star/comp/servicemanager/ServiceManager.java
+++ b/jurt/com/sun/star/comp/servicemanager/ServiceManager.java
@@ -216,7 +216,7 @@ public class ServiceManager implements XMultiServiceFactory,
      * @param   args    the first argument ( args[0] ) specifices the SimpleRegistry object
      * @see     com.sun.star.lang.XInitialization
      * @see     com.sun.star.lang.RegistryServiceManager
-     * @see     com.sun.star.lang.XSimpleRegistry
+     * @see     com.sun.star.registry.XSimpleRegistry
      */
     public void initialize( Object args[] )
                 throws  com.sun.star.uno.Exception,
@@ -294,7 +294,7 @@ public class ServiceManager implements XMultiServiceFactory,
      * the name is looked up in the the implementation list.
      * <p>
      * @return  the factory of the service / implementation
-     * @param   serviceSpecifier    indicates the service or implementation name
+     * @param   serviceName    indicates the service or implementation name
      * @see     com.sun.star.lang.XMultiServiceFactory
      */
     private Object queryServiceFactory(String serviceName)
@@ -626,10 +626,10 @@ public class ServiceManager implements XMultiServiceFactory,
     }
 
     /**
-     * Provides an enumeration of all registred services.
+     * Provides an enumeration of all registered services.
      * <p>
-     * @return  an enumeration of all avialable services.
-     * @see     com.sun.star.conatiner.XEnumerationAccess
+     * @return  an enumeration of all available services.
+     * @see     com.sun.star.container.XEnumerationAccess
      */
     public XEnumeration createEnumeration()
             throws com.sun.star.uno.RuntimeException
diff --git a/jurt/com/sun/star/comp/urlresolver/UrlResolver.java b/jurt/com/sun/star/comp/urlresolver/UrlResolver.java
index fefe9cad0c7a..0d73e70a5c0b 100644
--- a/jurt/com/sun/star/comp/urlresolver/UrlResolver.java
+++ b/jurt/com/sun/star/comp/urlresolver/UrlResolver.java
@@ -43,7 +43,7 @@ import com.sun.star.uno.UnoRuntime;
  * This component gives a factory for an <code>UnoUrlResolver</code> service.
  * <p>
  * @author      Kay Ramme
- * @see         com.sun.star.brige.XBrideFactory
+ * @see         com.sun.star.bridge.XBridgeFactory
  * @see         com.sun.star.connection.Connector
  * @since       UDK1.0
  */