You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@mina.apache.org by je...@apache.org on 2014/09/16 00:32:14 UTC

git commit: Javadoc warning fixes. Fixes DIRMINA-985. Still some warning related to XBeans tag.

Repository: mina
Updated Branches:
  refs/heads/2.0 50e417e81 -> 7469fd9c4


Javadoc warning fixes. Fixes DIRMINA-985. Still some warning related to XBeans tag.


Project: http://git-wip-us.apache.org/repos/asf/mina/repo
Commit: http://git-wip-us.apache.org/repos/asf/mina/commit/7469fd9c
Tree: http://git-wip-us.apache.org/repos/asf/mina/tree/7469fd9c
Diff: http://git-wip-us.apache.org/repos/asf/mina/diff/7469fd9c

Branch: refs/heads/2.0
Commit: 7469fd9c4cb0d5b1607090c6f0e0cc99a7079450
Parents: 50e417e
Author: Jeff MAURY <je...@apache.org>
Authored: Tue Sep 16 00:32:03 2014 +0200
Committer: Jeff MAURY <je...@apache.org>
Committed: Tue Sep 16 00:32:03 2014 +0200

----------------------------------------------------------------------
 .../main/java/org/apache/mina/core/file/FileRegion.java |  2 +-
 .../mina/core/polling/AbstractPollingIoAcceptor.java    |  5 +++--
 .../mina/core/polling/AbstractPollingIoConnector.java   |  2 +-
 .../mina/core/polling/AbstractPollingIoProcessor.java   |  4 ++--
 .../java/org/apache/mina/core/session/DummySession.java |  4 ++--
 .../org/apache/mina/core/session/IdleStatusChecker.java |  2 +-
 .../java/org/apache/mina/core/session/IoSession.java    | 12 ++++++------
 .../org/apache/mina/core/write/WriteRequestQueue.java   |  2 +-
 .../apache/mina/filter/codec/ProtocolCodecFilter.java   |  4 ++--
 .../filter/errorgenerating/ErrorGeneratingFilter.java   |  4 ++--
 .../org/apache/mina/filter/executor/ExecutorFilter.java |  1 -
 .../java/org/apache/mina/filter/logging/LogLevel.java   |  2 +-
 .../mina/filter/stream/FileRegionWriteFilter.java       |  2 +-
 .../apache/mina/filter/stream/StreamWriteFilter.java    |  3 ++-
 .../java/org/apache/mina/proxy/ProxyAuthException.java  |  4 ++--
 .../main/java/org/apache/mina/proxy/ProxyConnector.java |  2 +-
 .../java/org/apache/mina/proxy/filter/ProxyFilter.java  |  6 +++---
 .../proxy/handlers/http/AbstractHttpLogicHandler.java   |  3 +--
 .../handlers/http/basic/HttpBasicAuthLogicHandler.java  |  2 +-
 .../handlers/http/basic/HttpNoAuthLogicHandler.java     |  2 +-
 .../handlers/http/ntlm/HttpNTLMAuthLogicHandler.java    |  2 +-
 .../mina/proxy/handlers/socks/Socks4LogicHandler.java   |  2 +-
 .../mina/proxy/handlers/socks/Socks5LogicHandler.java   |  2 +-
 .../java/org/apache/mina/proxy/utils/ByteUtilities.java |  7 +++----
 .../org/apache/mina/proxy/utils/IoBufferDecoder.java    |  2 +-
 .../apache/mina/transport/socket/DatagramAcceptor.java  |  2 +-
 .../apache/mina/transport/socket/DatagramConnector.java |  2 +-
 .../apache/mina/transport/socket/SocketAcceptor.java    |  2 +-
 .../apache/mina/transport/socket/SocketConnector.java   |  2 +-
 .../mina/transport/socket/nio/NioDatagramConnector.java |  5 +++--
 .../mina/transport/socket/nio/NioSocketConnector.java   |  4 ++--
 .../org/apache/mina/util/LazyInitializedCacheMap.java   |  2 +-
 .../apache/mina/util/byteaccess/CompositeByteArray.java |  2 +-
 .../main/java/org/apache/mina/http/api/HttpRequest.java |  2 +-
 .../integration/xbean/MinaPropertyEditorRegistrar.java  |  3 +--
 .../mina/transport/socket/apr/AprSocketAcceptor.java    |  2 +-
 36 files changed, 55 insertions(+), 56 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/core/file/FileRegion.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/core/file/FileRegion.java b/mina-core/src/main/java/org/apache/mina/core/file/FileRegion.java
index 640f36b..eceaef6 100644
--- a/mina-core/src/main/java/org/apache/mina/core/file/FileRegion.java
+++ b/mina-core/src/main/java/org/apache/mina/core/file/FileRegion.java
@@ -46,7 +46,7 @@ public interface FileRegion {
     /**
      * Updates the current file position based on the specified amount. This
      * increases the value returned by {@link #getPosition()} and
-     * {@link getWrittenBytes} by the given amount and decreases the value
+     * {@link #getWrittenBytes()} by the given amount and decreases the value
      * returned by {@link #getRemainingBytes()} by the given {@code amount}.
      * 
      * @param amount

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoAcceptor.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoAcceptor.java b/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoAcceptor.java
index f0300d8..93e4d2d 100644
--- a/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoAcceptor.java
+++ b/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoAcceptor.java
@@ -40,6 +40,7 @@ import java.util.concurrent.atomic.AtomicReference;
 import org.apache.mina.core.RuntimeIoException;
 import org.apache.mina.core.filterchain.IoFilter;
 import org.apache.mina.core.service.AbstractIoAcceptor;
+import org.apache.mina.core.service.AbstractIoService;
 import org.apache.mina.core.service.IoAcceptor;
 import org.apache.mina.core.service.IoHandler;
 import org.apache.mina.core.service.IoProcessor;
@@ -158,7 +159,7 @@ public abstract class AbstractPollingIoAcceptor<S extends AbstractIoSession, H>
      * session configuration, a default {@link Executor} will be created using
      * {@link Executors#newCachedThreadPool()}.
      * 
-     * {@see AbstractIoService#AbstractIoService(IoSessionConfig, Executor)}
+     * @see AbstractIoService
      * 
      * @param sessionConfig
      *            the default configuration for the managed {@link IoSession}
@@ -175,7 +176,7 @@ public abstract class AbstractPollingIoAcceptor<S extends AbstractIoSession, H>
      * events. If a null {@link Executor} is provided, a default one will be
      * created using {@link Executors#newCachedThreadPool()}.
      * 
-     * @see AbstractIoService(IoSessionConfig, Executor)
+     * @see AbstractIoService#AbstractIoService(IoSessionConfig, Executor)
      * 
      * @param sessionConfig
      *            the default configuration for the managed {@link IoSession}

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoConnector.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoConnector.java b/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoConnector.java
index 5d93c9b..147ad1e 100644
--- a/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoConnector.java
+++ b/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoConnector.java
@@ -243,7 +243,7 @@ public abstract class AbstractPollingIoConnector<T extends AbstractIoSession, H>
 
     /**
      * Finish the connection process of a client socket after it was marked as
-     * ready to process by the {@link select(int)} call. The socket will be
+     * ready to process by the {@link #select(int)} call. The socket will be
      * connected or reported as connection failed.
      * 
      * @param handle

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoProcessor.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoProcessor.java b/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoProcessor.java
index 574bb34..a17a3a4 100644
--- a/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoProcessor.java
+++ b/mina-core/src/main/java/org/apache/mina/core/polling/AbstractPollingIoProcessor.java
@@ -230,7 +230,7 @@ public abstract class AbstractPollingIoProcessor<S extends AbstractIoSession> im
     protected abstract boolean isSelectorEmpty();
 
     /**
-     * Interrupt the {@link AbstractPollingIoProcessor#select(int)} call.
+     * Interrupt the {@link #select(long)} call.
      */
     protected abstract void wakeup();
 
@@ -244,7 +244,7 @@ public abstract class AbstractPollingIoProcessor<S extends AbstractIoSession> im
 
     /**
      * Get an {@link Iterator} for the list of {@link IoSession} found selected
-     * by the last call of {@link AbstractPollingIoProcessor#select(int)}
+     * by the last call of {@link #select(long)}
      * 
      * @return {@link Iterator} of {@link IoSession} read for I/Os operation
      */

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/core/session/DummySession.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/core/session/DummySession.java b/mina-core/src/main/java/org/apache/mina/core/session/DummySession.java
index d23b6cc..6976e0e 100644
--- a/mina-core/src/main/java/org/apache/mina/core/session/DummySession.java
+++ b/mina-core/src/main/java/org/apache/mina/core/session/DummySession.java
@@ -45,8 +45,8 @@ import org.apache.mina.transport.socket.SocketSessionConfig;
  * the classes that depends on {@link IoSession}.
  *
  * <h2>Overriding I/O request methods</h2>
- * All I/O request methods (i.e. {@link #close()}, {@link #write(Object)} and
- * {@link #setTrafficMask(TrafficMask)}) are final and therefore cannot be
+ * All I/O request methods (i.e. {@link #close()}, {@link #write(Object)}
+ * are final and therefore cannot be
  * overridden, but you can always add your custom {@link IoFilter} to the
  * {@link IoFilterChain} to intercept any I/O events and requests.
  *

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/core/session/IdleStatusChecker.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/core/session/IdleStatusChecker.java b/mina-core/src/main/java/org/apache/mina/core/session/IdleStatusChecker.java
index db65ddf..0de2bbb 100644
--- a/mina-core/src/main/java/org/apache/mina/core/session/IdleStatusChecker.java
+++ b/mina-core/src/main/java/org/apache/mina/core/session/IdleStatusChecker.java
@@ -76,7 +76,7 @@ public class IdleStatusChecker {
 
     /**
      * get a runnable task able to be scheduled in the {@link IoService} executor.
-     * @return
+     * @return the associated runnable task
      */
     public NotifyingTask getNotifyingTask() {
         return notifyingTask;

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/core/session/IoSession.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/core/session/IoSession.java b/mina-core/src/main/java/org/apache/mina/core/session/IoSession.java
index 0769724..56dd3f7 100644
--- a/mina-core/src/main/java/org/apache/mina/core/session/IoSession.java
+++ b/mina-core/src/main/java/org/apache/mina/core/session/IoSession.java
@@ -61,7 +61,7 @@ import org.apache.mina.core.write.WriteRequestQueue;
  * <h3>Equality of Sessions</h3>
  * TODO : The getId() method is totally wrong. We can't base
  * a method which is designed to create a unique ID on the hashCode method.
- * {@link #equals(Object)} and {@link #hashCode()} shall not be overriden
+ * {@link Object#equals(Object)} and {@link Object#hashCode()} shall not be overriden
  * to the default behavior that is defined in {@link Object}.
  *
  * @author <a href="http://mina.apache.org">Apache MINA Project</a>
@@ -164,10 +164,10 @@ public interface IoSession {
      * {@link CloseFuture} if you want to wait for the session actually closed.
      *
      * @param immediately {@code true} to close this session immediately
-     *                    (i.e. {@link #close()}). The pending write requests
+     *                    . The pending write requests
      *                    will simply be discarded.
      *                    {@code false} to close this session after all queued
-     *                    write requests are flushed (i.e. {@link #closeOnFlush()}).
+     *                    write requests are flushed (i.e. {@link #close()}).
      */
     CloseFuture close(boolean immediately);
 
@@ -175,7 +175,7 @@ public interface IoSession {
      * Closes this session after all queued write requests
      * are flushed. This operation is asynchronous.  Wait for the returned
      * {@link CloseFuture} if you want to wait for the session actually closed.
-     * @deprecated use {@link IoSession#close(boolean)}
+     * @deprecated use {@link #close(boolean)}
      */
     @Deprecated
     CloseFuture close();
@@ -370,9 +370,9 @@ public interface IoSession {
 
     /**
      * 
-     * TODO setWriteRequestQueue.
+     * Associate the current write request with the session
      *
-     * @param writeRequestQueue
+     * @param currentWriteRequest the current write request to associate
      */
     void setCurrentWriteRequest(WriteRequest currentWriteRequest);
 

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/core/write/WriteRequestQueue.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/core/write/WriteRequestQueue.java b/mina-core/src/main/java/org/apache/mina/core/write/WriteRequestQueue.java
index 38446bd..a047598 100644
--- a/mina-core/src/main/java/org/apache/mina/core/write/WriteRequestQueue.java
+++ b/mina-core/src/main/java/org/apache/mina/core/write/WriteRequestQueue.java
@@ -64,7 +64,7 @@ public interface WriteRequestQueue {
 
     /**
      * Returns the number of objects currently stored in the queue.
-     * @return
+     * @return the size of the queue
      */
     int size();
 }

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/filter/codec/ProtocolCodecFilter.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/filter/codec/ProtocolCodecFilter.java b/mina-core/src/main/java/org/apache/mina/filter/codec/ProtocolCodecFilter.java
index b541fbe..c490226 100644
--- a/mina-core/src/main/java/org/apache/mina/filter/codec/ProtocolCodecFilter.java
+++ b/mina-core/src/main/java/org/apache/mina/filter/codec/ProtocolCodecFilter.java
@@ -116,8 +116,8 @@ public class ProtocolCodecFilter extends IoFilterAdapter {
      * the two parameters (encoder and decoder), which are class names. Instances
      * for those classes will be created in this constructor.
      * 
-     * @param encoder The class responsible for encoding the message
-     * @param decoder The class responsible for decoding the message
+     * @param encoderClass The class responsible for encoding the message
+     * @param decoderClass The class responsible for decoding the message
      */
     public ProtocolCodecFilter(final Class<? extends ProtocolEncoder> encoderClass,
             final Class<? extends ProtocolDecoder> decoderClass) {

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/filter/errorgenerating/ErrorGeneratingFilter.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/filter/errorgenerating/ErrorGeneratingFilter.java b/mina-core/src/main/java/org/apache/mina/filter/errorgenerating/ErrorGeneratingFilter.java
index 84661e6..d9b1612 100644
--- a/mina-core/src/main/java/org/apache/mina/filter/errorgenerating/ErrorGeneratingFilter.java
+++ b/mina-core/src/main/java/org/apache/mina/filter/errorgenerating/ErrorGeneratingFilter.java
@@ -225,7 +225,7 @@ public class ErrorGeneratingFilter extends IoFilterAdapter {
      * Set the probability for the insert byte error.
      * If this probability is > 0 the filter will insert a random number of byte
      * in the processed {@link IoBuffer}.
-     * @param changeByteProbability probability of inserting in IoBuffer out of 1000 processed {@link IoBuffer} 
+     * @param insertByteProbability probability of inserting in IoBuffer out of 1000 processed {@link IoBuffer} 
      */
     public void setInsertByteProbability(int insertByteProbability) {
         this.insertByteProbability = insertByteProbability;
@@ -263,7 +263,7 @@ public class ErrorGeneratingFilter extends IoFilterAdapter {
      * Set the probability for the remove byte error.
      * If this probability is > 0 the filter will remove a random number of byte
      * in the processed {@link IoBuffer}.
-     * @param changeByteProbability probability of modifying an {@link IoBuffer} out of 1000 processed IoBuffer 
+     * @param removeByteProbability probability of modifying an {@link IoBuffer} out of 1000 processed IoBuffer 
      */
     public void setRemoveByteProbability(int removeByteProbability) {
         this.removeByteProbability = removeByteProbability;

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/filter/executor/ExecutorFilter.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/filter/executor/ExecutorFilter.java b/mina-core/src/main/java/org/apache/mina/filter/executor/ExecutorFilter.java
index 7d778c8..325f79a 100644
--- a/mina-core/src/main/java/org/apache/mina/filter/executor/ExecutorFilter.java
+++ b/mina-core/src/main/java/org/apache/mina/filter/executor/ExecutorFilter.java
@@ -472,7 +472,6 @@ public class ExecutorFilter extends IoFilterAdapter {
      * @param executor The underlying {@link Executor} in charge of managing the Thread pool.
      * @param manageableExecutor Tells if the Executor's Life Cycle can be managed or not
      * @param eventTypes The lit of event which are handled by the executor
-     * @param
      */
     private void init(Executor executor, boolean manageableExecutor, IoEventType... eventTypes) {
         if (executor == null) {

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/filter/logging/LogLevel.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/filter/logging/LogLevel.java b/mina-core/src/main/java/org/apache/mina/filter/logging/LogLevel.java
index 4c4f04b..9ec3a04 100644
--- a/mina-core/src/main/java/org/apache/mina/filter/logging/LogLevel.java
+++ b/mina-core/src/main/java/org/apache/mina/filter/logging/LogLevel.java
@@ -24,7 +24,7 @@ package org.apache.mina.filter.logging;
  * 
  * @author <a href="http://mina.apache.org">Apache MINA Project</a>
  * 
- * @see NoopFilter
+ * @see LoggingFilter
  */
 public enum LogLevel {
 

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/filter/stream/FileRegionWriteFilter.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/filter/stream/FileRegionWriteFilter.java b/mina-core/src/main/java/org/apache/mina/filter/stream/FileRegionWriteFilter.java
index 814ee24..7d1c5ea 100644
--- a/mina-core/src/main/java/org/apache/mina/filter/stream/FileRegionWriteFilter.java
+++ b/mina-core/src/main/java/org/apache/mina/filter/stream/FileRegionWriteFilter.java
@@ -28,7 +28,7 @@ import org.apache.mina.core.file.FileRegion;
  * Filter implementation that converts a {@link FileRegion} to {@link IoBuffer}
  * objects and writes those buffers to the next filter. When end of the
  * {@code FileRegion} has been reached this filter will call
- * {@link IoFilter.NextFilter#messageSent(IoSession,WriteRequest)} using the
+ * {@link org.apache.mina.core.filterchain.IoFilter.NextFilter#messageSent(org.apache.mina.core.session.IoSession, org.apache.mina.core.write.WriteRequest)} using the
  * original {@link FileRegion} written to the session and notifies
  * {@link org.apache.mina.core.future.WriteFuture} on the original
  * {@link org.apache.mina.core.write.WriteRequest}.

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/filter/stream/StreamWriteFilter.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/filter/stream/StreamWriteFilter.java b/mina-core/src/main/java/org/apache/mina/filter/stream/StreamWriteFilter.java
index c55fa5c..6d546f1 100644
--- a/mina-core/src/main/java/org/apache/mina/filter/stream/StreamWriteFilter.java
+++ b/mina-core/src/main/java/org/apache/mina/filter/stream/StreamWriteFilter.java
@@ -24,6 +24,7 @@ import java.io.InputStream;
 
 import org.apache.mina.core.buffer.IoBuffer;
 import org.apache.mina.core.filterchain.IoFilter;
+import org.apache.mina.core.session.IoSession;
 
 /**
  * Filter implementation which makes it possible to write {@link InputStream}
@@ -31,7 +32,7 @@ import org.apache.mina.core.filterchain.IoFilter;
  * {@link InputStream} is written to a session this filter will read the bytes
  * from the stream into {@link IoBuffer} objects and write those buffers
  * to the next filter. When end of stream has been reached this filter will
- * call {@link IoFilter.NextFilter#messageSent(IoSession,WriteRequest)} using the original
+ * call {@link org.apache.mina.core.filterchain.IoFilter.NextFilter#messageSent(org.apache.mina.core.session.IoSession, org.apache.mina.core.write.WriteRequest)} using the original
  * {@link InputStream} written to the session and notifies
  * {@link org.apache.mina.core.future.WriteFuture} on the
  * original {@link org.apache.mina.core.write.WriteRequest}.

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/ProxyAuthException.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/ProxyAuthException.java b/mina-core/src/main/java/org/apache/mina/proxy/ProxyAuthException.java
index 87d993a..10b0714 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/ProxyAuthException.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/ProxyAuthException.java
@@ -32,14 +32,14 @@ public class ProxyAuthException extends SaslException {
     private static final long serialVersionUID = -6511596809517532988L;
 
     /**
-     * {@inheritDoc}
+     * @see SaslException#SaslException(String)
      */
     public ProxyAuthException(String message) {
         super(message);
     }
 
     /**
-     * {@inheritDoc}
+     * @see SaslException#SaslException(String, Throwable)
      */
     public ProxyAuthException(String message, Throwable ex) {
         super(message, ex);

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/ProxyConnector.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/ProxyConnector.java b/mina-core/src/main/java/org/apache/mina/proxy/ProxyConnector.java
index 1c6fc3a..257b15b 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/ProxyConnector.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/ProxyConnector.java
@@ -104,7 +104,7 @@ public class ProxyConnector extends AbstractIoConnector {
 
     /**
      * Creates a new proxy connector.
-     * @see AbstractIoConnector(IoSessionConfig, Executor).
+     * @see AbstractIoConnector#AbstractIoConnector(IoSessionConfig, Executor).
      */
     public ProxyConnector(final SocketConnector connector, IoSessionConfig config, Executor executor) {
         super(config, executor);

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/filter/ProxyFilter.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/filter/ProxyFilter.java b/mina-core/src/main/java/org/apache/mina/proxy/filter/ProxyFilter.java
index 7a605a0..8b1880c 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/filter/ProxyFilter.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/filter/ProxyFilter.java
@@ -100,9 +100,9 @@ public class ProxyFilter extends IoFilterAdapter {
      * {@link ProxyIoSession} session's instance to signal that handshake
      * failed.  
      * 
-     * @param chain the filter chain
-     * @param name the name assigned to this filter
-     * @param nextFilter the next filter
+     * @param nextFilter next filter in the filter chain
+     * @param session the MINA session
+     * @param cause the original exception
      */
     @Override
     public void exceptionCaught(NextFilter nextFilter, IoSession session, Throwable cause) throws Exception {

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
index 6ebbd35..65cdf31 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/AbstractHttpLogicHandler.java
@@ -102,7 +102,6 @@ public abstract class AbstractHttpLogicHandler extends AbstractProxyLogicHandler
      * Creates a new {@link AbstractHttpLogicHandler}.
      * 
      * @param proxyIoSession the {@link ProxyIoSession} in use.
-     * @param request the requested url to negotiate with the proxy.
      */
     public AbstractHttpLogicHandler(final ProxyIoSession proxyIoSession) {
         super(proxyIoSession);
@@ -284,7 +283,7 @@ public abstract class AbstractHttpLogicHandler extends AbstractProxyLogicHandler
     public abstract void handleResponse(final HttpProxyResponse response) throws ProxyAuthException;
 
     /**
-     * Calls{@link #writeRequest0(NextFilter, HttpProxyRequest)} to write the request. 
+     * Calls writeRequest0(NextFilter, HttpProxyRequest) to write the request. 
      * If needed a reconnection to the proxy is done previously.
      * 
      * @param nextFilter the next filter

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
index ecfdd97..43cea3e 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpBasicAuthLogicHandler.java
@@ -45,7 +45,7 @@ public class HttpBasicAuthLogicHandler extends AbstractAuthLogicHandler {
     private final static Logger logger = LoggerFactory.getLogger(HttpBasicAuthLogicHandler.class);
 
     /**
-     * {@inheritDoc}
+     * Build an HttpBasicAuthLogicHandler
      */
     public HttpBasicAuthLogicHandler(final ProxyIoSession proxyIoSession) throws ProxyAuthException {
         super(proxyIoSession);

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
index 9a32e31..e58a4b1 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/basic/HttpNoAuthLogicHandler.java
@@ -38,7 +38,7 @@ public class HttpNoAuthLogicHandler extends AbstractAuthLogicHandler {
     private final static Logger logger = LoggerFactory.getLogger(HttpNoAuthLogicHandler.class);
 
     /**
-     * {@inheritDoc}
+     * Build an HttpNoAuthLogicHandler
      */
     public HttpNoAuthLogicHandler(final ProxyIoSession proxyIoSession) throws ProxyAuthException {
         super(proxyIoSession);

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
index dbb321f..d1202a7 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/handlers/http/ntlm/HttpNTLMAuthLogicHandler.java
@@ -52,7 +52,7 @@ public class HttpNTLMAuthLogicHandler extends AbstractAuthLogicHandler {
     private byte[] challengePacket = null;
 
     /**
-     * {@inheritDoc}
+     * Build an HttpNTLMAuthLogicHandler
      */
     public HttpNTLMAuthLogicHandler(final ProxyIoSession proxyIoSession) throws ProxyAuthException {
         super(proxyIoSession);

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
index 7141be2..6b55eb1 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks4LogicHandler.java
@@ -39,7 +39,7 @@ public class Socks4LogicHandler extends AbstractSocksLogicHandler {
     private final static Logger logger = LoggerFactory.getLogger(Socks4LogicHandler.class);
 
     /**
-     * {@inheritDoc}
+     * @see AbstractSocksLogicHandler#AbstractSocksLogicHandler(ProxyIoSession)
      */
     public Socks4LogicHandler(final ProxyIoSession proxyIoSession) {
         super(proxyIoSession);

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
index cd55a3d..e773a83 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/handlers/socks/Socks5LogicHandler.java
@@ -67,7 +67,7 @@ public class Socks5LogicHandler extends AbstractSocksLogicHandler {
     private final static String GSS_TOKEN = Socks5LogicHandler.class.getName() + ".GSSToken";
 
     /**
-     * {@inheritDoc}
+     * @see AbstractSocksLogicHandler#AbstractSocksLogicHandler(ProxyIoSession)
      */
     public Socks5LogicHandler(final ProxyIoSession proxyIoSession) {
         super(proxyIoSession);

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/utils/ByteUtilities.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/utils/ByteUtilities.java b/mina-core/src/main/java/org/apache/mina/proxy/utils/ByteUtilities.java
index 00b2e1c..9102668 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/utils/ByteUtilities.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/utils/ByteUtilities.java
@@ -35,7 +35,7 @@ public class ByteUtilities {
      * @param buf the buffer to read the bytes from
      * @param start
      * @param count
-     * @return
+     * @return the integer value        
      */
     public static int networkByteOrderToInt(byte[] buf, int start, int count) {
         if (count > 4) {
@@ -276,8 +276,7 @@ public class ByteUtilities {
      * Reads an int from 4 bytes of the given array at offset 0.
      * 
      * @param b the byte array to read
-     * @param offset the offset at which to start
-     * @return the int value
+     * @return the integer value
      */
     public static final int makeIntFromByte4(byte[] b) {
         return makeIntFromByte4(b, 0);
@@ -319,7 +318,7 @@ public class ByteUtilities {
      * Returns true if the flag <code>testFlag</code> is set in the
      * <code>flags</code> flagset.
      * 
-     * @param flagset the flagset to test
+     * @param flagSet the flagset to test
      * @param testFlag the flag we search the presence of
      * @return true if testFlag is present in the flagset, false otherwise.
      */

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/proxy/utils/IoBufferDecoder.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/proxy/utils/IoBufferDecoder.java b/mina-core/src/main/java/org/apache/mina/proxy/utils/IoBufferDecoder.java
index 7c581c1..0da5e8d 100644
--- a/mina-core/src/main/java/org/apache/mina/proxy/utils/IoBufferDecoder.java
+++ b/mina-core/src/main/java/org/apache/mina/proxy/utils/IoBufferDecoder.java
@@ -148,7 +148,7 @@ public class IoBufferDecoder {
 
     /**
      * Dynamically sets a new delimiter. Next time 
-     * {@link IoBufferDecoder#decodeOnce(IoSession, int) } will be called it will use the new 
+     * {@link #decodeFully(IoBuffer)} will be called it will use the new 
      * delimiter. Delimiter matching is reset only if <tt>resetMatchCount</tt> is true but 
      * decoding will continue from current position.
      * 

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramAcceptor.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramAcceptor.java b/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramAcceptor.java
index cd7f0c9..99b2b99 100644
--- a/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramAcceptor.java
+++ b/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramAcceptor.java
@@ -50,7 +50,7 @@ public interface DatagramAcceptor extends IoAcceptor {
      * Sets the default local InetSocketAddress to bind when no argument is specified in
      * {@link #bind()} method. Please note that the default will not be used
      * if any local InetSocketAddress is specified.
-     * This method overrides the {@link IoAcceptor#setDefaultLocalAddress()} method.
+     * This method overrides the {@link IoAcceptor#setDefaultLocalAddress(java.net.SocketAddress)} method.
      */
     void setDefaultLocalAddress(InetSocketAddress localAddress);
 

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramConnector.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramConnector.java b/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramConnector.java
index 4763dd6..4775ef4 100644
--- a/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramConnector.java
+++ b/mina-core/src/main/java/org/apache/mina/transport/socket/DatagramConnector.java
@@ -45,7 +45,7 @@ public interface DatagramConnector extends IoConnector {
     /**
      * Sets the default remote InetSocketAddress to connect to when no argument is
      * specified in {@link #connect()} method.
-     * This method overrides the {@link IoConnector#setDefaultRemoteAddress()} method.
+     * This method overrides the {@link IoConnector#setDefaultRemoteAddress(java.net.SocketAddress)} method.
      */
     void setDefaultRemoteAddress(InetSocketAddress remoteAddress);
 }

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/transport/socket/SocketAcceptor.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/transport/socket/SocketAcceptor.java b/mina-core/src/main/java/org/apache/mina/transport/socket/SocketAcceptor.java
index ca16a79..2b655b9 100644
--- a/mina-core/src/main/java/org/apache/mina/transport/socket/SocketAcceptor.java
+++ b/mina-core/src/main/java/org/apache/mina/transport/socket/SocketAcceptor.java
@@ -50,7 +50,7 @@ public interface SocketAcceptor extends IoAcceptor {
      * Sets the default local InetSocketAddress to bind when no argument is specified in
      * {@link #bind()} method. Please note that the default will not be used
      * if any local InetSocketAddress is specified.
-     * This method overrides the {@link IoAcceptor#setDefaultLocalAddress()} method.
+     * This method overrides the {@link IoAcceptor#setDefaultLocalAddress(java.net.SocketAddress)} method.
      */
     void setDefaultLocalAddress(InetSocketAddress localAddress);
 

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/transport/socket/SocketConnector.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/transport/socket/SocketConnector.java b/mina-core/src/main/java/org/apache/mina/transport/socket/SocketConnector.java
index 235b484..2cf216a 100644
--- a/mina-core/src/main/java/org/apache/mina/transport/socket/SocketConnector.java
+++ b/mina-core/src/main/java/org/apache/mina/transport/socket/SocketConnector.java
@@ -45,7 +45,7 @@ public interface SocketConnector extends IoConnector {
     /**
      * Sets the default remote InetSocketAddress to connect to when no argument is
      * specified in {@link #connect()} method.
-     * This method overrides the {@link IoConnector#setDefaultRemoteAddress()} method.
+     * This method overrides the {@link IoConnector#setDefaultRemoteAddress(java.net.SocketAddress)} method.
      */
     void setDefaultRemoteAddress(InetSocketAddress remoteAddress);
 }
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioDatagramConnector.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioDatagramConnector.java b/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioDatagramConnector.java
index 54eb260..b232f9e 100644
--- a/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioDatagramConnector.java
+++ b/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioDatagramConnector.java
@@ -30,6 +30,7 @@ import java.util.concurrent.Executor;
 import org.apache.mina.core.polling.AbstractPollingIoConnector;
 import org.apache.mina.core.service.IoConnector;
 import org.apache.mina.core.service.IoProcessor;
+import org.apache.mina.core.service.SimpleIoProcessorPool;
 import org.apache.mina.core.service.TransportMetadata;
 import org.apache.mina.transport.socket.DatagramConnector;
 import org.apache.mina.transport.socket.DatagramSessionConfig;
@@ -72,7 +73,7 @@ DatagramConnector {
      * 
      * @param processorClass the processor class.
      * @param processorCount the number of processors to instantiate.
-     * @see org.apache.mina.core.service.SimpleIoProcessorPool#SimpleIoProcessorPool(Class, Executor, int)
+     * @see SimpleIoProcessorPool#SimpleIoProcessorPool(Class, Executor, int, java.nio.channels.spi.SelectorProvider)
      * @since 2.0.0-M4
      */
     public NioDatagramConnector(Class<? extends IoProcessor<NioSession>> processorClass, int processorCount) {
@@ -87,7 +88,7 @@ DatagramConnector {
      * in the system, plus one.
      * 
      * @param processorClass the processor class.
-     * @see org.apache.mina.core.service.SimpleIoProcessorPool#SimpleIoProcessorPool(Class, Executor, int)
+     * @see SimpleIoProcessorPool#SimpleIoProcessorPool(Class, Executor, int, java.nio.channels.spi.SelectorProvider)
      * @see org.apache.mina.core.service.SimpleIoProcessorPool#DEFAULT_SIZE
      * @since 2.0.0-M4
      */

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioSocketConnector.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioSocketConnector.java b/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioSocketConnector.java
index 2dc2b40..d24f593 100644
--- a/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioSocketConnector.java
+++ b/mina-core/src/main/java/org/apache/mina/transport/socket/nio/NioSocketConnector.java
@@ -99,7 +99,7 @@ SocketConnector {
      * 
      * @param processorClass the processor class.
      * @param processorCount the number of processors to instantiate.
-     * @see org.apache.mina.core.service.SimpleIoProcessorPool#SimpleIoProcessorPool(Class, Executor, int)
+     * @see SimpleIoProcessorPool#SimpleIoProcessorPool(Class, Executor, int, java.nio.channels.spi.SelectorProvider)
      * @since 2.0.0-M4
      */
     public NioSocketConnector(Class<? extends IoProcessor<NioSession>> processorClass, int processorCount) {
@@ -114,7 +114,7 @@ SocketConnector {
      * in the system, plus one.
      * 
      * @param processorClass the processor class.
-     * @see org.apache.mina.core.service.SimpleIoProcessorPool#SimpleIoProcessorPool(Class, Executor, int)
+     * @see SimpleIoProcessorPool#SimpleIoProcessorPool(Class, Executor, int, java.nio.channels.spi.SelectorProvider)
      * @see org.apache.mina.core.service.SimpleIoProcessorPool#DEFAULT_SIZE
      * @since 2.0.0-M4
      */

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/util/LazyInitializedCacheMap.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/util/LazyInitializedCacheMap.java b/mina-core/src/main/java/org/apache/mina/util/LazyInitializedCacheMap.java
index 9b2e5c9..6f68c6f 100644
--- a/mina-core/src/main/java/org/apache/mina/util/LazyInitializedCacheMap.java
+++ b/mina-core/src/main/java/org/apache/mina/util/LazyInitializedCacheMap.java
@@ -174,7 +174,7 @@ public class LazyInitializedCacheMap<K, V> implements Map<K, V> {
     }
 
     /**
-     * {@inheritDoc}
+     * @return return the values from the cache
      */
     public Collection<LazyInitializer<V>> getValues() {
         return cache.values();

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArray.java
----------------------------------------------------------------------
diff --git a/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArray.java b/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArray.java
index 0a674c2..7dc3efa 100644
--- a/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArray.java
+++ b/mina-core/src/main/java/org/apache/mina/util/byteaccess/CompositeByteArray.java
@@ -341,7 +341,7 @@ public final class CompositeByteArray extends AbstractByteArray {
      * array) and with the given listener.
      * 
      * @param listener
-     *  Returns a new {@link Cursor} instance
+     *  Returns a new {@link ByteArray.Cursor} instance
      */
     public Cursor cursor(CursorListener listener) {
         return new CursorImpl(listener);

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-http/src/main/java/org/apache/mina/http/api/HttpRequest.java
----------------------------------------------------------------------
diff --git a/mina-http/src/main/java/org/apache/mina/http/api/HttpRequest.java b/mina-http/src/main/java/org/apache/mina/http/api/HttpRequest.java
index 5deec08..1671fce 100644
--- a/mina-http/src/main/java/org/apache/mina/http/api/HttpRequest.java
+++ b/mina-http/src/main/java/org/apache/mina/http/api/HttpRequest.java
@@ -67,7 +67,7 @@ public interface HttpRequest extends HttpMessage {
     
     /**
      * Retrurn the HTTP request path
-     * @retrun the request path
+     * @return the request path
      */
     String getRequestPath();
 }

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-integration-xbean/src/main/java/org/apache/mina/integration/xbean/MinaPropertyEditorRegistrar.java
----------------------------------------------------------------------
diff --git a/mina-integration-xbean/src/main/java/org/apache/mina/integration/xbean/MinaPropertyEditorRegistrar.java b/mina-integration-xbean/src/main/java/org/apache/mina/integration/xbean/MinaPropertyEditorRegistrar.java
index 2ae67f3..4870498 100644
--- a/mina-integration-xbean/src/main/java/org/apache/mina/integration/xbean/MinaPropertyEditorRegistrar.java
+++ b/mina-integration-xbean/src/main/java/org/apache/mina/integration/xbean/MinaPropertyEditorRegistrar.java
@@ -56,8 +56,7 @@ public class MinaPropertyEditorRegistrar implements PropertyEditorRegistrar {
      *   <li>org.apache.mina.integration.beans.VmPipeAddressEditor</li>
      * </ul>
      * 
-     * @see org.springframework.beans.PropertyEditorRegistrar#
-     * registerCustomEditors(org.springframework.beans.PropertyEditorRegistry)
+     * @see PropertyEditorRegistrar#registerCustomEditors(PropertyEditorRegistry)
      */
     public void registerCustomEditors(PropertyEditorRegistry registry) {
         // it is expected that new PropertyEditor instances are created

http://git-wip-us.apache.org/repos/asf/mina/blob/7469fd9c/mina-transport-apr/src/main/java/org/apache/mina/transport/socket/apr/AprSocketAcceptor.java
----------------------------------------------------------------------
diff --git a/mina-transport-apr/src/main/java/org/apache/mina/transport/socket/apr/AprSocketAcceptor.java b/mina-transport-apr/src/main/java/org/apache/mina/transport/socket/apr/AprSocketAcceptor.java
index 3a1cef9..2ecf4ed 100644
--- a/mina-transport-apr/src/main/java/org/apache/mina/transport/socket/apr/AprSocketAcceptor.java
+++ b/mina-transport-apr/src/main/java/org/apache/mina/transport/socket/apr/AprSocketAcceptor.java
@@ -344,7 +344,7 @@ public final class AprSocketAcceptor extends AbstractPollingIoAcceptor<AprSessio
     }
 
     /**
-     * {@inheritDoc}
+     * @see #setDefaultLocalAddress(SocketAddress)
      */
     public void setDefaultLocalAddress(InetSocketAddress localAddress) {
         super.setDefaultLocalAddress(localAddress);