--- HttpClient.java 2004-11-20 23:23:51.000000000 +0100
+++ HttpClient.java.new 2004-12-20 14:37:26.561669840 +0100
@@ -88,21 +88,21 @@
// ----------------------------------------------------------- Constructors
/**
- * Creates an instance of HttpClient using default {@link HttpClientParams parameter set}.
- *
- * @see HttpClientParams
+ * Creates a new HttpClient instance using a default
+ * {@link HttpClientParams parameter set}.
*/
public HttpClient() {
this(new HttpClientParams());
}
/**
- * Creates an instance of HttpClient using the given
- * {@link HttpClientParams parameter set}.
- *
- * @param params The {@link HttpClientParams parameters} to use.
+ * Creates a new HttpClient using the given
+ * {@link HttpClientParams parameter set}. The parameter set is required
+ * and must be specified, otherwise an {@link IllegalArgumentException} is
+ * thrown.
*
- * @see HttpClientParams
+ * @param params The {@link HttpClientParams parameters} to use, cannot
+ * be null.
*
* @since 3.0
*/
@@ -132,13 +132,18 @@
}
/**
- * Creates an instance of HttpClient with a user specified
+ * Creates a new HttpClient with the specified
* {@link HttpClientParams parameter set} and
- * {@link HttpConnectionManager HTTP connection manager}.
- *
- * @param params The {@link HttpClientParams parameters} to use.
- * @param httpConnectionManager The {@link HttpConnectionManager connection manager}
- * to use.
+ * {@link HttpConnectionManager HTTP connection manager}. Both the
+ * parameter set and the connection manager are required. If either one is
+ * null, then an {@link IllegalArgumentException} is thrown.
+ *
+ * @param params The {@link HttpClientParams parameters} to use, cannot be
+ * null.
+ *
+ * @param httpConnectionManager The
+ * {@link HttpConnectionManager connection manager} to use, cannot be
+ * null.
*
* @since 3.0
*/
@@ -158,11 +163,14 @@
}
/**
- * Creates an instance of HttpClient with a user specified
- * {@link HttpConnectionManager HTTP connection manager}.
+ * Creates a new HttpClient instance with the specified
+ * {@link HttpConnectionManager HTTP connection manager} and a default
+ * {@link HttpClientParams parameter set}. The connection manager is
+ * required and must be specified, otherwise an
+ * {@link IllegalArgumentException} is thrown.
*
* @param httpConnectionManager The {@link HttpConnectionManager connection manager}
- * to use.
+ * to use, cannot be null.
*
* @since 2.0
*/