From 97f682e0085d8dd6cfa0a2e02093381eb50f3e62 Mon Sep 17 00:00:00 2001
From: markt <markt@13f79535-47bb-0310-9956-ffa450edef68>
Date: Fri, 8 Jul 2011 11:19:32 +0000
Subject: [PATCH] Improve comments

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1144264 13f79535-47bb-0310-9956-ffa450edef68
---
 java/org/apache/coyote/ajp/AjpNioProtocol.java | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/java/org/apache/coyote/ajp/AjpNioProtocol.java b/java/org/apache/coyote/ajp/AjpNioProtocol.java
index 412c2ae3d..c515dd0ae 100644
--- a/java/org/apache/coyote/ajp/AjpNioProtocol.java
+++ b/java/org/apache/coyote/ajp/AjpNioProtocol.java
@@ -125,6 +125,10 @@ public class AjpNioProtocol extends AbstractAjpProtocol {
             return null;
         }
 
+        /**
+         * Expected to be used by the Poller to release resources on socket
+         * close, errors etc.
+         */
         @Override
         public void release(SocketChannel socket) {
             if (log.isDebugEnabled()) 
@@ -147,8 +151,8 @@ public class AjpNioProtocol extends AbstractAjpProtocol {
         }
         
         /**
-         * Use this only if the processor is not available, otherwise use
-         * {@link #release(SocketWrapper, AjpNioProcessor, boolean)}.
+         * Expected to be used by the Poller to release resources on socket
+         * close, errors etc.
          */
         @Override
         public void release(SocketWrapper<NioChannel> socket) {
@@ -160,6 +164,10 @@ public class AjpNioProtocol extends AbstractAjpProtocol {
         }
 
 
+        /**
+         * Expected to be used by the handler once the processor is no longer
+         * required.
+         */
         public void release(SocketWrapper<NioChannel> socket,
                 AjpNioProcessor processor, boolean isSocketClosing) {
             connections.remove(socket);
-- 
2.11.0