#31 - Tidy related javadoc

Author: rbygrave

client/src/main/java/io/avaje/http/client/HttpClientContext.java

@@ -172,15 +172,16 @@ interface Builder {
      * Disable or enable built in request and response logging.
      * <p>
      * By default request logging is enabled. Set this to false to stop
-     * the default {@link RequestLogger} being registered to log
-     * request and response headers and bodies etc.
+     * the default {@link RequestLogger} being registered to log request
+     * and response headers and bodies etc.
      * <p>
      * With logging level set to {@code DEBUG} for
-     * {@code io.avaje.http.client.RequestLogger} the request and
-     * response are logged with headers only.
+     * {@code io.avaje.http.client.RequestLogger} the request and response
+     * are logged as a summary with response status and time.
      * <p>
      * Set the logging level to {@code TRACE} to include the request
-     * and response body payloads (with truncation for large bodies).
+     * and response headers and body payloads with truncation for large
+     * bodies.
      *
      * <h3>Suppression</h3>
      * <p>
@@ -190,7 +191,7 @@ interface Builder {
      * Logging of Authorization headers is suppressed.
      * {@link AuthTokenProvider} requests are suppressed.
      *
-     * @param requestLogging To turn disable/enable the registration of the default logger
+     * @param requestLogging Disable/enable the registration of the default logger
      * @see RequestLogger
      */
     Builder requestLogging(boolean requestLogging);

client/src/main/java/io/avaje/http/client/RequestLogger.java

@@ -16,6 +16,14 @@
  * This implementation logs the request and response with the same
  * single logging entry rather than separate logging of the request
  * and response.
+ * <p>
+ * With logging level set to {@code DEBUG} for
+ * {@code io.avaje.http.client.RequestLogger} the request and response
+ * are logged as a summary with response status and time.
+ * <p>
+ * Set the logging level to {@code TRACE} to include the request
+ * and response headers and body payloads with truncation for large
+ * bodies.
  */
 public class RequestLogger implements RequestListener {