More doc on connection checking
Fix bug in Javadoc - default is now false.

git-svn-id: https://svn.apache.org/repos/asf/httpcomponents/httpclient/trunk@1604897 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/httpclient/src/main/java/org/apache/http/client/config/RequestConfig.java b/httpclient/src/main/java/org/apache/http/client/config/RequestConfig.java
index f6dd0a5..7a171b5 100644
--- a/httpclient/src/main/java/org/apache/http/client/config/RequestConfig.java
+++ b/httpclient/src/main/java/org/apache/http/client/config/RequestConfig.java
@@ -31,7 +31,14 @@
 import java.util.Collection;
 
 import org.apache.http.HttpHost;
+import org.apache.http.annotation.Immutable;
 
+/**
+ *  Immutable class encapsulating request configuration items.
+ *  The default setting for stale connection checking changed
+ *  to false, and the feature was deprecated starting with version 4.4.
+ */
+@Immutable
 public class RequestConfig implements Cloneable {
 
     public static final RequestConfig DEFAULT = new Builder().build();
@@ -140,7 +147,7 @@
      * should be used only when appropriate. For performance critical
      * operations this check should be disabled.
      * <p/>
-     * Default: <code>true</code>
+     * Default: <code>false</code> since 4.4
      *
      * @deprecated (4.4) Use {@link
      *   org.apache.http.impl.conn.PoolingHttpClientConnectionManager#getValidateAfterInactivity()}