diff --git a/httpclient/src/main/java/org/apache/http/client/protocol/RequestAcceptEncoding.java b/httpclient/src/main/java/org/apache/http/client/protocol/RequestAcceptEncoding.java
index 192c50cc0..1df09a9b5 100644
--- a/httpclient/src/main/java/org/apache/http/client/protocol/RequestAcceptEncoding.java
+++ b/httpclient/src/main/java/org/apache/http/client/protocol/RequestAcceptEncoding.java
@@ -45,7 +45,7 @@ import org.apache.http.protocol.HttpContext;
 public class RequestAcceptEncoding implements HttpRequestInterceptor {
 
     /**
-     * {@inheritDoc}
+     * Adds the header {@code "Accept-Encoding: gzip,deflate"} to the request.
      */
     public void process(
             final HttpRequest request,
diff --git a/httpclient/src/main/java/org/apache/http/client/protocol/ResponseContentEncoding.java b/httpclient/src/main/java/org/apache/http/client/protocol/ResponseContentEncoding.java
index f2708593f..330155779 100644
--- a/httpclient/src/main/java/org/apache/http/client/protocol/ResponseContentEncoding.java
+++ b/httpclient/src/main/java/org/apache/http/client/protocol/ResponseContentEncoding.java
@@ -52,7 +52,18 @@ import org.apache.http.protocol.HttpContext;
 public class ResponseContentEncoding implements HttpResponseInterceptor {
 
     /**
-     * {@inheritDoc}
+     * Handles the following {@code Content-Encoding}s by 
+     * using the appropriate decompressor to wrap the response Entity:
+     * <ul>
+     * <li>gzip - see {@link GzipDecompressingEntity}</li>
+     * <li>deflate - see {@link DeflateDecompressingEntity}</li>
+     * <li>identity - no action needed</li>
+     * </ul>
+     * 
+     * @param response the response which contains the entity
+     * @param  context not currently used
+     * 
+     * @throws HttpException if the {@code Content-Encoding} is none of the above
      */
     public void process(
             final HttpResponse response,