svn commit: r1595790 - /httpcomponents/project-website/trunk/src/site/apt/httpcomponents-client-4.3.x/quickstart.apt

[ol...@apache.org]

Author: olegk
Date: Mon May 19 09:26:24 2014
New Revision: 1595790

URL: http://svn.apache.org/r1595790
Log:
HTTPCLIENT-1507: clarified behavior of CloseableHttpResponse#close()

Modified:
    httpcomponents/project-website/trunk/src/site/apt/httpcomponents-client-4.3.x/quickstart.apt

Modified: httpcomponents/project-website/trunk/src/site/apt/httpcomponents-client-4.3.x/quickstart.apt
URL: http://svn.apache.org/viewvc/httpcomponents/project-website/trunk/src/site/apt/httpcomponents-client-4.3.x/quickstart.apt?rev=1595790&r1=1595789&r2=1595790&view=diff
==============================================================================
--- httpcomponents/project-website/trunk/src/site/apt/httpcomponents-client-4.3.x/quickstart.apt (original)
+++ httpcomponents/project-website/trunk/src/site/apt/httpcomponents-client-4.3.x/quickstart.apt Mon May 19 09:26:24 2014
@@ -48,9 +48,10 @@ CloseableHttpResponse response1 = httpcl
 // The underlying HTTP connection is still held by the response object
 // to allow the response content to be streamed directly from the network socket.
 // In order to ensure correct deallocation of system resources
-// the user MUST either fully consume the response content  or abort request
-// execution by calling CloseableHttpResponse#close().
-
+// the user MUST call CloseableHttpResponse#close() from a finally clause.
+// Please note that if response content is not fully consumed the underlying
+// connection cannot be safely re-used and will be shut down and discarded
+// by the connection manager. 
 try {
     System.out.println(response1.getStatusLine());
     HttpEntity entity1 = response1.getEntity();