--- 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 */