Fix documentation in dart:io.

sdk/lib/io/http.dart

Index: sdk/lib/io/http.dart
diff --git a/sdk/lib/io/http.dart b/sdk/lib/io/http.dart
index dd9de06f476984382d0ebe701a09e0baebaeef6a..366fd8dec00a33ad1a7764e03f15a30954a72d9a 100644
--- a/sdk/lib/io/http.dart
+++ b/sdk/lib/io/http.dart
@@ -748,19 +748,19 @@ abstract class Cookie {
  * package, which makes working with the low-level
  * dart:io HTTP server subsystem easier.
  *
- * HttpRequest objects are generated by an [HttpServer],
+ * `HttpRequest` objects are generated by an [HttpServer],
  * which listens for HTTP requests on a specific host and port.
  * For each request received, the HttpServer, which is a [Stream],
- * generates an HttpRequest object and adds it to the stream.
+ * generates an `HttpRequest` object and adds it to the stream.
  *
- * An HttpRequest object delivers the body content of the request
- * as a stream of bytes.
+ * An `HttpRequest` object delivers the body content of the request
+ * as a stream of byte lists.
  * The object also contains information about the request,
  * such as the method, URI, and headers.
  *
  * In the following code, an HttpServer listens
  * for HTTP requests and, within the callback function,
- * uses the HttpRequest object's `method` property to dispatch requests.
+ * uses the `HttpRequest` object's `method` property to dispatch requests.
  *
  *     final HOST = InternetAddress.LOOPBACK_IP_V4;
  *     final PORT = 4040;
@@ -778,9 +778,9 @@ abstract class Cookie {
  *       onError: handleError);    // listen() failed.
  *     }).catchError(handleError);
  *
- * Listen to the HttpRequest stream to handle the
+ * Listen to the `HttpRequest` stream to handle the
  * data and be notified once the entire body is received.
- * An HttpRequest object contains an [HttpResponse] object,
+ * An `HttpRequest` object contains an [HttpResponse] object,
  * to which the server can write its response.
  * For example, here's a skeletal callback function
  * that responds to a request:
@@ -1375,6 +1375,7 @@ abstract class HttpClient {
 abstract class HttpClientRequest implements IOSink {
   /**
    * Gets and sets the requested persistent connection state.
+   *
    * The default value is [:true:].
    */
   bool persistentConnection;