--- a/src/java.net.http/share/classes/java/net/http/HttpClient.java	Sat Feb 24 11:27:11 2018 +0000
+++ b/src/java.net.http/share/classes/java/net/http/HttpClient.java	Mon Feb 26 16:17:03 2018 +0000
@@ -63,7 +63,7 @@
  * HttpRequest} sent. The {@code BodyHandler} determines how to handle the
  * response body, if any. Once an {@link HttpResponse} is received, the
  * headers, response code, and body (typically) are available. Whether the
- * response body bytes has been read or not depends on the type {@code <T>} of
+ * response body bytes has been read or not depends on the type, {@code T}, of
  * the response body.
  *
  * <p> Requests can be sent either synchronously or asynchronously:

--- a/src/java.net.http/share/classes/java/net/http/HttpRequest.java	Sat Feb 24 11:27:11 2018 +0000
+++ b/src/java.net.http/share/classes/java/net/http/HttpRequest.java	Mon Feb 26 16:17:03 2018 +0000
@@ -469,7 +469,7 @@
     /**
      * Implementations of {@link BodyPublisher BodyPublisher} that implement
      * various useful publishers, such as publishing the request body from a
-     * string, or from a file.
+     * String, or from a file.
      *
      * <p> The following are examples of using the predefined body publishers to
      * convert common high-level Java objects into a flow of data suitable for