hc-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ol...@apache.org
Subject svn commit: r376961 - in /jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http: ./ entity/ impl/ impl/entity/ impl/io/ io/ message/ params/ protocol/ util/
Date Sat, 11 Feb 2006 10:32:55 GMT
Author: olegk
Date: Sat Feb 11 02:32:50 2006
New Revision: 376961

URL: http://svn.apache.org/viewcvs?rev=376961&view=rev
Log:
Javadoc improvements

Contributed by Roland Weber

Modified:
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionClosedException.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionReuseStrategy.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/Header.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HeaderElement.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpClientConnection.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpConnection.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntity.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntityEnclosingRequest.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMessage.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableEntityEnclosingRequest.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableMessage.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableRequest.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableResponse.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpProxyConnection.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequest.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequestFactory.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponse.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponseFactory.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpServerConnection.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/MethodNotSupportedException.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/NameValuePair.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/RequestLine.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/StatusLine.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/BasicHttpEntity.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityGenerator.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityWriter.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/AbstractHttpConnection.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultConnectionReuseStrategy.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpClientConnection.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpProxyConnection.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestFactory.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestRetryHandler.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpResponseFactory.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpServerConnection.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultClientEntityWriter.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultEntityGenerator.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultServerEntityWriter.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataReceiver.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataTransmitter.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SSLSocketFactory.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataReceiver.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataTransmitter.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ByteArrayBuffer.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/CharArrayBuffer.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedInputStream.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedOutputStream.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ContentLengthOutputStream.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataInputStream.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataOutputStream.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiver.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiverFactory.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitter.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitterFactory.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/IdentityOutputStream.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/MalformedChunkCodingException.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/SecureSocketFactory.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpEntityEnclosingRequest.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpMessage.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpRequest.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpResponse.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpGet.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpHead.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpPost.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpConnectionParams.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpProtocolParams.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/AbstractHttpProcessor.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HTTP.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpContext.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpDateGenerator.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpExecutionContext.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestExecutor.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestRetryHandler.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpService.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestConnControl.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestContent.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestExpectContinue.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestTargetHost.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestUserAgent.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseConnControl.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseContent.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseDate.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseServer.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/DateParseException.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/EntityUtils.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/LangUtils.java
    jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/NumUtils.java

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionClosedException.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionClosedException.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionClosedException.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionClosedException.java Sat Feb 11 02:32:50 2006
@@ -32,8 +32,8 @@
 import java.io.IOException;
 
 /**
- * <p>
- * </p>
+ * Indicates that a connection has been closed.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionReuseStrategy.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionReuseStrategy.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionReuseStrategy.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/ConnectionReuseStrategy.java Sat Feb 11 02:32:50 2006
@@ -31,8 +31,8 @@
 
 
 /**
- * <p>
- * </p>
+ * Interface for deciding whether a connection should be kept alive.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/Header.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/Header.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/Header.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/Header.java Sat Feb 11 02:32:50 2006
@@ -138,7 +138,7 @@
     /**
      * Returns an array of {@link HeaderElement}s constructed from my value.
      *
-     * @see HeaderElement#parseElements(String)
+     * @see HeaderElement#parseAll
      * 
      * @return an array of header elements
      * 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HeaderElement.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HeaderElement.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HeaderElement.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HeaderElement.java Sat Feb 11 02:32:50 2006
@@ -156,8 +156,10 @@
      * This parses the value part of a header. The result is an array of
      * HeaderElement objects.
      *
-     * @param headerValue  the array of char representation of the header value
-     *                     (as received from the web server).
+     * @param buffer    the buffer from which to parse
+     * @param indexFrom where to start parsing in the buffer
+     * @param indexTo   where to stop parsing in the buffer
+     *
      * @return array of {@link HeaderElement}s.
      * 
      * @since 3.0

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpClientConnection.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpClientConnection.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpClientConnection.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpClientConnection.java Sat Feb 11 02:32:50 2006
@@ -35,8 +35,9 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * An HTTP connection for use on the client side.
+ * It is used for sending requests and receiving responses.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpConnection.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpConnection.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpConnection.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpConnection.java Sat Feb 11 02:32:50 2006
@@ -32,8 +32,8 @@
 import java.io.IOException;
 
 /**
- * <p>
- * </p>
+ * A generic HTTP connection, useful on client and server side.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntity.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntity.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntity.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntity.java Sat Feb 11 02:32:50 2006
@@ -45,7 +45,7 @@
  * <li><b>streamed</b>: The content is received from a stream, or
  *     generated on the fly. In particular, this category includes
  *     entities being received from a {@link HttpConnection connection}.
- *     {@link #isStreamed Streamed} entities are generally not
+ *     {@link #isStreaming Streamed} entities are generally not
  *      {@link #isRepeatable repeatable}.
  *     </li>
  * <li><b>self-contained</b>: The content is in memory or obtained by

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntityEnclosingRequest.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntityEnclosingRequest.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntityEnclosingRequest.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpEntityEnclosingRequest.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http;
 
 /**
- * <p>
- * </p>
+ * A request with an entity.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMessage.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMessage.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMessage.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMessage.java Sat Feb 11 02:32:50 2006
@@ -32,8 +32,9 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * A generic HTTP message.
+ * Holds what is common between requests and responses.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableEntityEnclosingRequest.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableEntityEnclosingRequest.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableEntityEnclosingRequest.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableEntityEnclosingRequest.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http;
 
 /**
- * <p>
- * </p>
+ * An HTTP request with an entity that can be modified.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableMessage.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableMessage.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableMessage.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableMessage.java Sat Feb 11 02:32:50 2006
@@ -34,8 +34,8 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * An HTTP message that can be modified.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableRequest.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableRequest.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableRequest.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableRequest.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http;
 
 /**
- * <p>
- * </p>
+ * An HTTP request that can be modified.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableResponse.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableResponse.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableResponse.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpMutableResponse.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http;
 
 /**
- * <p>
- * </p>
+ * An HTTP response that can be modified.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpProxyConnection.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpProxyConnection.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpProxyConnection.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpProxyConnection.java Sat Feb 11 02:32:50 2006
@@ -34,8 +34,8 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * An HTTP connection through a proxy.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequest.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequest.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequest.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequest.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http;
 
 /**
- * <p>
- * </p>
+ * An HTTP request.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequestFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequestFactory.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequestFactory.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpRequestFactory.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http;
 
 /**
- * <p>
- * </p>
+ * A factory for {@link HttpRequest HttpRequest} objects.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponse.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponse.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponse.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponse.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http;
 
 /**
- * <p>
- * </p>
+ * An HTTP response.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponseFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponseFactory.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponseFactory.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpResponseFactory.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http;
 
 /**
- * <p>
- * </p>
+ * A factory for {@link HttpResponse HttpResponse} objects.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpServerConnection.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpServerConnection.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpServerConnection.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/HttpServerConnection.java Sat Feb 11 02:32:50 2006
@@ -35,8 +35,9 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * An HTTP connection for use on the server side.
+ * Requests are received, responses are sent.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/MethodNotSupportedException.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/MethodNotSupportedException.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/MethodNotSupportedException.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/MethodNotSupportedException.java Sat Feb 11 02:32:50 2006
@@ -31,8 +31,8 @@
 
 
 /**
- * <p>
- * </p>
+ * Indicates that an HTTP method is not supported.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/NameValuePair.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/NameValuePair.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/NameValuePair.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/NameValuePair.java Sat Feb 11 02:32:50 2006
@@ -37,7 +37,7 @@
 import org.apache.http.util.LangUtils;
 
 /**
- * <p>A simple class encapsulating an attribute/value pair</p> 
+ * A simple class encapsulating an attribute/value pair.
  * <p>
  *  This class comforms to the generic grammar and formatting rules outlined in the 
  *  <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2">Section 2.2</a>
@@ -382,7 +382,7 @@
      * Produces textual representaion of the attribute/value pair using 
      * formatting rules defined in RFC 2616
      *  
-     * @params param the parameters to be formatted
+     * @param params the parameters to be formatted
      * @param alwaysUseQuotes <tt>true</tt> if the parameter values must 
      * always be enclosed in quotation marks, <tt>false</tt> otherwise
      * 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/RequestLine.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/RequestLine.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/RequestLine.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/RequestLine.java Sat Feb 11 02:32:50 2006
@@ -33,8 +33,10 @@
 import org.apache.http.protocol.HTTP;
 
 /**
- * <p>
- * </p>
+ * The first line of an {@link HttpRequest HttpRequest}.
+ * It contains the method, URI, and HTTP version of the request.
+ * For details, see RFC 2616.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/StatusLine.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/StatusLine.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/StatusLine.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/StatusLine.java Sat Feb 11 02:32:50 2006
@@ -94,7 +94,9 @@
     /**
      * Parses the status line returned from the HTTP server.
      *
-     * @param statusLine the status line to be parsed
+     * @param buffer    the buffer from which to parse
+     * @param indexFrom where to start parsing in the buffer
+     * @param indexTo   where to stop parsing in the buffer
      * 
      * @throws HttpException if the status line is invalid
      * 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/BasicHttpEntity.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/BasicHttpEntity.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/BasicHttpEntity.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/BasicHttpEntity.java Sat Feb 11 02:32:50 2006
@@ -34,8 +34,8 @@
 import java.io.OutputStream;
 
 /**
- * <p>
- * </p>
+ * A generic streamed entity being received on a connection.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityGenerator.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityGenerator.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityGenerator.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityGenerator.java Sat Feb 11 02:32:50 2006
@@ -37,8 +37,8 @@
 import org.apache.http.io.HttpDataReceiver;
 
 /**
- * <p>
- * </p>
+ * Generates entities when HTTP messages are received.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityWriter.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityWriter.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityWriter.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/entity/EntityWriter.java Sat Feb 11 02:32:50 2006
@@ -37,8 +37,8 @@
 import org.apache.http.io.HttpDataTransmitter;
 
 /**
- * <p>
- * </p>
+ * Writes an entity when HTTP messages are sent.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision: $

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/AbstractHttpConnection.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/AbstractHttpConnection.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/AbstractHttpConnection.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/AbstractHttpConnection.java Sat Feb 11 02:32:50 2006
@@ -43,8 +43,8 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * Abstract base class for HTTP connections on the client and server side.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultConnectionReuseStrategy.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultConnectionReuseStrategy.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultConnectionReuseStrategy.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultConnectionReuseStrategy.java Sat Feb 11 02:32:50 2006
@@ -37,8 +37,8 @@
 import org.apache.http.protocol.HTTP;
 
 /**
- * <p>
- * </p>
+ * Default implementation of a strategy deciding about connection re-use.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpClientConnection.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpClientConnection.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpClientConnection.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpClientConnection.java Sat Feb 11 02:32:50 2006
@@ -57,8 +57,8 @@
 import org.apache.http.protocol.HTTP;
 
 /**
- * <p>
- * </p>
+ * Default implementation of a client-side HTTP connection.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpProxyConnection.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpProxyConnection.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpProxyConnection.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpProxyConnection.java Sat Feb 11 02:32:50 2006
@@ -42,8 +42,8 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * Default implementation of a client-side connection through a proxy.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestFactory.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestFactory.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestFactory.java Sat Feb 11 02:32:50 2006
@@ -37,8 +37,8 @@
 import org.apache.http.message.BasicHttpRequest;
 
 /**
- * <p>
- * </p>
+ * Default implementation of a factory for creating request objects.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestRetryHandler.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestRetryHandler.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestRetryHandler.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpRequestRetryHandler.java Sat Feb 11 02:32:50 2006
@@ -41,7 +41,7 @@
 import org.apache.http.protocol.HttpRequestRetryHandler;
 
 /**
- * The default {@link HttpRequestRetryHandler} used by {@link HttpRequestExecutor}s.
+ * The default {@link HttpRequestRetryHandler} used by request executors.
  * 
  * @author Michael Becke
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
@@ -72,8 +72,6 @@
     /** 
      * Used <code>retryCount</code> and <code>requestSentRetryEnabled</code> to determine
      * if the given method should be retried.
-     * 
-     * @see HttpMethodRetryHandler#retryMethod(HttpMethod, IOException, int)
      */
     public boolean retryRequest(
             final IOException exception, 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpResponseFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpResponseFactory.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpResponseFactory.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpResponseFactory.java Sat Feb 11 02:32:50 2006
@@ -37,8 +37,8 @@
 import org.apache.http.message.BasicHttpResponse;
 
 /**
- * <p>
- * </p>
+ * Default implementation of a factory for creating response objects.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpServerConnection.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpServerConnection.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpServerConnection.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/DefaultHttpServerConnection.java Sat Feb 11 02:32:50 2006
@@ -51,8 +51,8 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * Default implementation of a server-side HTTP connection.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultClientEntityWriter.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultClientEntityWriter.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultClientEntityWriter.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultClientEntityWriter.java Sat Feb 11 02:32:50 2006
@@ -42,8 +42,7 @@
 import org.apache.http.io.HttpDataTransmitter;
 
 /**
- * <p>
- * </p>
+ * Default implementation of an entity writer on the client side.
  * 
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultEntityGenerator.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultEntityGenerator.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultEntityGenerator.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultEntityGenerator.java Sat Feb 11 02:32:50 2006
@@ -48,6 +48,7 @@
 import org.apache.http.protocol.HTTP;
 
 /**
+ * Default implementation of an entity generator.
  * <p>
  * This entity generator comforms to the entity transfer rules outlined in the 
  * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec4.4">Section 4.4</a>, 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultServerEntityWriter.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultServerEntityWriter.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultServerEntityWriter.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/entity/DefaultServerEntityWriter.java Sat Feb 11 02:32:50 2006
@@ -42,8 +42,7 @@
 import org.apache.http.io.IdentityOutputStream;
 
 /**
- * <p>
- * </p>
+ * Default implementation of an entity writer on the server side.
  * 
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataReceiver.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataReceiver.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataReceiver.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataReceiver.java Sat Feb 11 02:32:50 2006
@@ -40,7 +40,7 @@
 import org.apache.http.protocol.HTTP;
 
 /**
- * <p></p>
+ * Abstract base class for data receivers using traditional IO.
  *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataTransmitter.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataTransmitter.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataTransmitter.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/AbstractHttpDataTransmitter.java Sat Feb 11 02:32:50 2006
@@ -40,7 +40,7 @@
 import org.apache.http.protocol.HTTP;
 
 /**
- * <p></p>
+ * Abstract base class for data transmitters using traditional IO.
  *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SSLSocketFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SSLSocketFactory.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SSLSocketFactory.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SSLSocketFactory.java Sat Feb 11 02:32:50 2006
@@ -40,7 +40,7 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>A wrapper class for the standard JSSE SSLSocketFactory</p>
+ * .A wrapper class for the standard JSSE SSLSocketFactory.
  *   
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  */
@@ -102,9 +102,7 @@
         }
     }
 
-    /**
-     * @see SecureProtocolSocketFactory#createSocket(java.net.Socket,java.lang.String,int,boolean)
-     */
+    // non-javadoc, see interface SocketFactory
     public Socket createSocket(
         Socket socket,
         String host,

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataReceiver.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataReceiver.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataReceiver.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataReceiver.java Sat Feb 11 02:32:50 2006
@@ -35,8 +35,8 @@
 
 
 /**
- * <p>
- * </p>
+ * A data receiver using a Java {@link Socket} and traditional IO.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataTransmitter.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataTransmitter.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataTransmitter.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/impl/io/SocketHttpDataTransmitter.java Sat Feb 11 02:32:50 2006
@@ -34,8 +34,8 @@
 
 
 /**
- * <p>
- * </p>
+ * A data transmitter using a Java {@link Socket} and traditional IO.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ByteArrayBuffer.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ByteArrayBuffer.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ByteArrayBuffer.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ByteArrayBuffer.java Sat Feb 11 02:32:50 2006
@@ -30,6 +30,8 @@
 package org.apache.http.io;
 
 /**
+ * A resizable byte array.
+ *
  * @author <a href="mailto:oleg@ural.ru">Oleg Kalnichevski</a>
  * 
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/CharArrayBuffer.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/CharArrayBuffer.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/CharArrayBuffer.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/CharArrayBuffer.java Sat Feb 11 02:32:50 2006
@@ -32,6 +32,8 @@
 import org.apache.http.protocol.HTTP;
 
 /**
+ * A resizable char array.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * 
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedInputStream.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedInputStream.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedInputStream.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedInputStream.java Sat Feb 11 02:32:50 2006
@@ -164,8 +164,6 @@
      * @return -1 of the end of the stream has been reached or the next data
      * byte
      * @throws IOException If an IO problem occurs
-     * 
-     * @see HttpMethod#getResponseFooters()
      */
     public int read() throws IOException {
         if (this.closed) {

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedOutputStream.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedOutputStream.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedOutputStream.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ChunkedOutputStream.java Sat Feb 11 02:32:50 2006
@@ -116,7 +116,7 @@
     // ----------------------------------------------------------- Constructors
     /**
      * Wraps a stream and chunks the output.
-     * @param stream to wrap
+     * @param out the transmitter to wrap
      * @param bufferSize minimum chunk size (excluding last chunk)
      * @throws IOException
      * 
@@ -132,7 +132,7 @@
     /**
      * Wraps a data transmitter and chunks the output. The default buffer size of 2048 was 
      * chosen because the chunk overhead is less than 0.5%
-     * @param stream
+     * @param datatransmitter the transmitter to wrap
      * @throws IOException
      */
     public ChunkedOutputStream(final HttpDataTransmitter datatransmitter) 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ContentLengthOutputStream.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ContentLengthOutputStream.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ContentLengthOutputStream.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/ContentLengthOutputStream.java Sat Feb 11 02:32:50 2006
@@ -33,8 +33,8 @@
 import java.io.OutputStream;
 
 /**
- * <p>
- * </p>
+ * A stream wrapper that closes itself after a defined number of bytes.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataInputStream.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataInputStream.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataInputStream.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataInputStream.java Sat Feb 11 02:32:50 2006
@@ -33,8 +33,8 @@
 import java.io.InputStream;
 
 /**
- * <p>
- * </p>
+ * A stream for reading from a {@link HttpDataReceiver HttpDataReceiver}.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataOutputStream.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataOutputStream.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataOutputStream.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataOutputStream.java Sat Feb 11 02:32:50 2006
@@ -33,8 +33,8 @@
 import java.io.OutputStream;
 
 /**
- * <p>
- * </p>
+ * A stream for writing to a {@link HttpDataTransmitter HttpDataTransmitter}.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiver.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiver.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiver.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiver.java Sat Feb 11 02:32:50 2006
@@ -34,8 +34,10 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * Interface for receiving data.
+ * Unlike {@link java.io.InputStream}, this interface is tailored
+ * to the needs of the HTTP components.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiverFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiverFactory.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiverFactory.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataReceiverFactory.java Sat Feb 11 02:32:50 2006
@@ -33,8 +33,8 @@
 import java.net.Socket;
 
 /**
- * <p>
- * </p>
+ * Factory for {@link HttpDataReceiver HttpDataReceiver} objects.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitter.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitter.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitter.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitter.java Sat Feb 11 02:32:50 2006
@@ -34,8 +34,10 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * Interface for sending data.
+ * Unlike {@link java.io.OutputStream}, this interface is tailored
+ * to the needs of the HTTP components.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitterFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitterFactory.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitterFactory.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/HttpDataTransmitterFactory.java Sat Feb 11 02:32:50 2006
@@ -33,8 +33,8 @@
 import java.net.Socket;
 
 /**
- * <p>
- * </p>
+ * Factory for {@link HttpDataTransmitter HttpDataTransmitter} objects.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/IdentityOutputStream.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/IdentityOutputStream.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/IdentityOutputStream.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/IdentityOutputStream.java Sat Feb 11 02:32:50 2006
@@ -33,8 +33,8 @@
 import java.io.OutputStream;
 
 /**
- * <p>
- * </p>
+ * A stream for writing with an "identity" transport encoding.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/MalformedChunkCodingException.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/MalformedChunkCodingException.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/MalformedChunkCodingException.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/MalformedChunkCodingException.java Sat Feb 11 02:32:50 2006
@@ -32,7 +32,7 @@
 import java.io.IOException;
 
 /**
- * Signals a malformed chunked stream
+ * Signals a malformed chunked stream.
  */
 public class MalformedChunkCodingException extends IOException {
 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/SecureSocketFactory.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/SecureSocketFactory.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/SecureSocketFactory.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/io/SecureSocketFactory.java Sat Feb 11 02:32:50 2006
@@ -34,9 +34,8 @@
 import java.net.UnknownHostException;
 
 /**
- * A ProtocolSocketFactory that is secure.
- * 
- * @see org.apache.commons.httpclient.protocol.ProtocolSocketFactory
+ * A {@link SocketFactory SocketFactory} for secure sockets (SSL/TLS).
+ * See there for things to consider when implementing a socket factory.
  * 
  * @author Michael Becke
  * @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpEntityEnclosingRequest.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpEntityEnclosingRequest.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpEntityEnclosingRequest.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpEntityEnclosingRequest.java Sat Feb 11 02:32:50 2006
@@ -36,8 +36,8 @@
 import org.apache.http.protocol.HTTP;
 
 /**
- * <p>
- * </p>
+ * Basic implementation of a request with an entity that can be modified.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpMessage.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpMessage.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpMessage.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpMessage.java Sat Feb 11 02:32:50 2006
@@ -38,8 +38,8 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * Basic implementation of an HTTP message that can be modified.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpRequest.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpRequest.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpRequest.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpRequest.java Sat Feb 11 02:32:50 2006
@@ -35,8 +35,8 @@
 import org.apache.http.params.HttpProtocolParams;
 
 /**
- * <p>
- * </p>
+ * Basic implementation of an HTTP request that can be modified.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpResponse.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpResponse.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpResponse.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/BasicHttpResponse.java Sat Feb 11 02:32:50 2006
@@ -36,8 +36,8 @@
 import org.apache.http.params.HttpProtocolParams;
 
 /**
- * <p>
- * </p>
+ * Basic implementation of an HTTP response that can be modified.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpGet.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpGet.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpGet.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpGet.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http.message;
 
 /**
- * <p>
- * </p>
+ * A modifiable HTTP request with GET as the method.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpHead.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpHead.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpHead.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpHead.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http.message;
 
 /**
- * <p>
- * </p>
+ * A modifiable HTTP request with HEAD as the method.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpPost.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpPost.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpPost.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/message/HttpPost.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http.message;
 
 /**
- * <p>
- * </p>
+ * A modifiable HTTP request with POST as the method.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpConnectionParams.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpConnectionParams.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpConnectionParams.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpConnectionParams.java Sat Feb 11 02:32:50 2006
@@ -45,7 +45,7 @@
      * Defines the default socket timeout (<tt>SO_TIMEOUT</tt>) in milliseconds which is the 
      * timeout for waiting for data. A timeout value of zero is interpreted as an infinite 
      * timeout. This value is used when no socket timeout is set in the 
-     * {@link HttpMethodParams HTTP method parameters}. 
+     * method parameters. 
      * <p>
      * This parameter expects a value of type {@link Integer}.
      * </p>
@@ -68,7 +68,7 @@
 
     /**
      * Determines the size of the internal socket buffer used to buffer data
-     * while receiving / transmitting HTTP messages 
+     * while receiving / transmitting HTTP messages.
      * <p>
      * This parameter expects a value of type {@link Integer}.
      * </p>
@@ -117,7 +117,7 @@
      * Returns the default socket timeout (<tt>SO_TIMEOUT</tt>) in milliseconds which is the 
      * timeout for waiting for data. A timeout value of zero is interpreted as an infinite 
      * timeout. This value is used when no socket timeout is set in the 
-     * {@link HttpMethodParams HTTP method parameters}. 
+     * method parameters. 
      *
      * @return timeout in milliseconds
      */
@@ -132,7 +132,7 @@
      * Sets the default socket timeout (<tt>SO_TIMEOUT</tt>) in milliseconds which is the 
      * timeout for waiting for data. A timeout value of zero is interpreted as an infinite 
      * timeout. This value is used when no socket timeout is set in the 
-     * {@link HttpMethodParams HTTP method parameters}. 
+     * method parameters. 
      *
      * @param timeout Timeout in milliseconds
      */

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpProtocolParams.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpProtocolParams.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpProtocolParams.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/params/HttpProtocolParams.java Sat Feb 11 02:32:50 2006
@@ -34,7 +34,7 @@
 
 /**
  * This class implements an adaptor around the {@link HttpParams} interface
- * to simplify manipulation of the HTTP connection specific parameters.
+ * to simplify manipulation of the HTTP protocol specific parameters.
  * 
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * 
@@ -53,8 +53,8 @@
     public static final String PROTOCOL_VERSION = "http.protocol.version"; 
 
     /**
-     * Defines the charset to be used when encoding 
-     * {@link org.apache.commons.httpclient.Credentials}. If not defined then the 
+     * Defines the charset to be used when encoding credentials.
+     * If not defined then the 
      * {@link #HTTP_ELEMENT_CHARSET} should be used.
      * <p>
      * This parameter expects a value of type {@link String}.
@@ -144,8 +144,7 @@
     /**
      * <p>
      * Activates 'Expect: 100-Continue' handshake for the 
-     * {@link org.apache.commons.httpclient.methods.ExpectContinueMethod 
-     * entity enclosing methods}. The purpose of the 'Expect: 100-Continue'
+     * entity enclosing methods. The purpose of the 'Expect: 100-Continue'
      * handshake to allow a client that is sending a request message with 
      * a request body to determine if the origin server is willing to 
      * accept the request (based on the request headers) before the client
@@ -230,8 +229,9 @@
     }
 
     /**
-     * Returns the charset to be used for {@link org.apache.commons.httpclient.Credentials}. If
-     * not configured the {@link #HTTP_ELEMENT_CHARSET HTTP element charset} is used.
+     * Returns the charset to be used for credentials.
+     * If not configured the {@link #HTTP_ELEMENT_CHARSET HTTP element charset}
+     * is used.
      * @return The charset
      */
     public static String getCredentialCharset(final HttpParams params) {
@@ -274,8 +274,7 @@
     
     /**
      * Assigns the {@link HttpVersion HTTP protocol version} to be used by the 
-     * {@link org.apache.commons.httpclient.HttpMethod HTTP methods} that 
-     * this collection of parameters applies to. 
+     * HTTP methods that this collection of parameters applies to. 
      *
      * @param version the {@link HttpVersion HTTP protocol version}
      */

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/AbstractHttpProcessor.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/AbstractHttpProcessor.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/AbstractHttpProcessor.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/AbstractHttpProcessor.java Sat Feb 11 02:32:50 2006
@@ -41,8 +41,8 @@
 import org.apache.http.HttpResponseInterceptor;
 
 /**
- * <p>
- * </p>
+ * Keeps lists of interceptors for processing requests and responses.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HTTP.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HTTP.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HTTP.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HTTP.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http.protocol;
 
 /**
- * <p>
- * </p>
+ * Constants and static helpers related to the HTTP protocol
+ * 
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpContext.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpContext.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpContext.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpContext.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,12 @@
 package org.apache.http.protocol;
 
 /**
- * <p>
- * </p>
+ * A context for executing a request.
+ * The context is used to tie together the request, the response,
+ * and optional application data. It is also used for internal data.
+ * Attribute names starting with the prefix "http." are
+ * {@link #RESERVED_PREFIX reserved} for internal data.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$
@@ -40,6 +44,8 @@
  */
 public interface HttpContext {
 
+    /** The prefix reserved for use by HTTP components. "http." */
+    public static final String RESERVED_PREFIX  = "http.";
     public static final String HTTP_CONNECTION  = "http.connection"; 
     public static final String HTTP_REQUEST     = "http.request"; 
     public static final String HTTP_RESPONSE    = "http.response"; 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpDateGenerator.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpDateGenerator.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpDateGenerator.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpDateGenerator.java Sat Feb 11 02:32:50 2006
@@ -37,8 +37,8 @@
 import org.apache.http.util.DateUtils;
 
 /**
- * <p>
- * </p>
+ * Generates a date in the format required by the HTTP protocol.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpExecutionContext.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpExecutionContext.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpExecutionContext.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpExecutionContext.java Sat Feb 11 02:32:50 2006
@@ -34,8 +34,8 @@
 
 
 /**
- * <p>
- * </p>
+ * Default implementation of the {@link HttpContext HttpContext}.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestExecutor.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestExecutor.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestExecutor.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestExecutor.java Sat Feb 11 02:32:50 2006
@@ -45,8 +45,10 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * Sends HTTP requests and receives the responses.
+ * Takes care of request preprocessing and response postprocessing
+ * by the respective interceptors.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestRetryHandler.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestRetryHandler.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestRetryHandler.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpRequestRetryHandler.java Sat Feb 11 02:32:50 2006
@@ -50,10 +50,10 @@
      * Determines if a method should be retried after an IOException
      * occurs during execution.
      * 
-     * @param request the request being executed
      * @param exception the exception that occurred
      * @param executionCount the number of times this method has been 
      * unsuccessfully executed
+     * @param context the context for the request execution
      * 
      * @return <code>true</code> if the method should be retried, <code>false</code>
      * otherwise

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpService.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpService.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpService.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/HttpService.java Sat Feb 11 02:32:50 2006
@@ -51,8 +51,13 @@
 import org.apache.http.params.HttpParams;
 
 /**
- * <p>
- * </p>
+ * Minimalistic server-side implementation of an HTTP processor.
+ * We have no intention of competing with the Servlet API.
+ * This implementation will remain minimalistic. It is here as
+ * a proof-of-concept for our API. It can also be used for
+ * implementing simple server-side applications or tests that
+ * can be run without installing a servlet container first.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestConnControl.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestConnControl.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestConnControl.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestConnControl.java Sat Feb 11 02:32:50 2006
@@ -37,8 +37,8 @@
 import org.apache.http.HttpRequestInterceptor;
 
 /**
- * <p>
- * </p>
+ * A request interceptor that suggests connection keep-alive to the server.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestContent.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestContent.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestContent.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestContent.java Sat Feb 11 02:32:50 2006
@@ -41,8 +41,8 @@
 import org.apache.http.ProtocolException;
 
 /**
- * <p>
- * </p>
+ * A request interceptor that decides about the transport encoding.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestExpectContinue.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestExpectContinue.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestExpectContinue.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestExpectContinue.java Sat Feb 11 02:32:50 2006
@@ -41,8 +41,8 @@
 import org.apache.http.params.HttpProtocolParams;
 
 /**
- * <p>
- * </p>
+ * A request interceptor that enables the expect-continue handshake.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestTargetHost.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestTargetHost.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestTargetHost.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestTargetHost.java Sat Feb 11 02:32:50 2006
@@ -39,8 +39,8 @@
 import org.apache.http.params.HttpProtocolParams;
 
 /**
- * <p>
- * </p>
+ * A request interceptor that sets the Host header for HTTP/1.1 requests.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestUserAgent.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestUserAgent.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestUserAgent.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/RequestUserAgent.java Sat Feb 11 02:32:50 2006
@@ -38,8 +38,8 @@
 import org.apache.http.params.HttpProtocolParams;
 
 /**
- * <p>
- * </p>
+ * A request interceptor that adds a User-Agent header.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseConnControl.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseConnControl.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseConnControl.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseConnControl.java Sat Feb 11 02:32:50 2006
@@ -41,8 +41,9 @@
 import org.apache.http.HttpVersion;
 
 /**
- * <p>
- * </p>
+ * A response interceptor that suggests connection keep-alive to the client.
+ * For use on the server side.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseContent.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseContent.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseContent.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseContent.java Sat Feb 11 02:32:50 2006
@@ -39,8 +39,9 @@
 import org.apache.http.HttpVersion;
 
 /**
- * <p>
- * </p>
+ * A response interceptor that sets up entity-related headers.
+ * For use on the server side.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseDate.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseDate.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseDate.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseDate.java Sat Feb 11 02:32:50 2006
@@ -38,8 +38,9 @@
 import org.apache.http.HttpStatus;
 
 /**
- * <p>
- * </p>
+ * A response interceptor that adds a Date header.
+ * For use on the server side.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseServer.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseServer.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseServer.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/protocol/ResponseServer.java Sat Feb 11 02:32:50 2006
@@ -38,8 +38,9 @@
 import org.apache.http.params.HttpProtocolParams;
 
 /**
- * <p>
- * </p>
+ * A response interceptor that adds a Server header.
+ * For use on the server side.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/DateParseException.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/DateParseException.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/DateParseException.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/DateParseException.java Sat Feb 11 02:32:50 2006
@@ -33,7 +33,7 @@
 /**
  * An exception to indicate an error parsing a date string.
  * 
- * @see DateUtil
+ * @see DateUtils
  * 
  * @author Michael Becke
  */

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/EntityUtils.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/EntityUtils.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/EntityUtils.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/EntityUtils.java Sat Feb 11 02:32:50 2006
@@ -42,8 +42,8 @@
 import org.apache.http.protocol.HTTP;
 
 /**
- * <p>
- * </p>
+ * Static helpers for dealing with {@link HttpEntity entities}.
+ *
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  *
  * @version $Revision$

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/LangUtils.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/LangUtils.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/LangUtils.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/LangUtils.java Sat Feb 11 02:32:50 2006
@@ -30,8 +30,8 @@
 package org.apache.http.util;
 
 /**
- * A set of utility methods to help produce consistent Object#equals(Object) and
- * Object#hashCode methods.
+ * A set of utility methods to help produce consistent
+ * {@link Object#equals equals} and {@link Object#hashCode hashCode} methods.
  *  
  * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a>
  * 

Modified: jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/NumUtils.java
URL: http://svn.apache.org/viewcvs/jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/NumUtils.java?rev=376961&r1=376960&r2=376961&view=diff
==============================================================================
--- jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/NumUtils.java (original)
+++ jakarta/httpcomponents/trunk/http-core/src/java/org/apache/http/util/NumUtils.java Sat Feb 11 02:32:50 2006
@@ -3,6 +3,10 @@
 import org.apache.http.io.CharArrayBuffer;
 import org.apache.http.protocol.HTTP;
 
+
+/**
+ * Static helpers for dealing with numbers in string representation.
+ */
 public class NumUtils {
 
     private NumUtils() {



Mime
View raw message