dart:io HttpServer.serverHeader - tweaks to doc comments

sdk/lib/io/http.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 /**
  * HTTP status codes.
  */
 abstract class HttpStatus {
@@ skipping 76 matching lines @@
  *
  * The HttpRequest exposes the request headers and provides the request body,
  * if it exists, as a Stream of data. If the body is unread, it is drained
  * when the server writes to the HttpResponse or closes it.
  *
  * ## Bind with a secure HTTPS connection
  *
  * Use [bindSecure] to create an HTTPS server.
  *
  * The server presents a certificate to the client. In the following
- * example, the certificate is named `localhost_cert` and comes from 
+ * example, the certificate is named `localhost_cert` and comes from
  * the database found in the `pkcert` directory.
- * 
+ *
  *     import 'dart:io';
  *     import "dart:isolate";
  *
  *     main() {
  *       var testPkcertDatabase = Platform.script.resolve('pkcert')
  *                                        .toFilePath();
  *       SecureSocket.initialize(database: testPkcertDatabase,
  *                               password: 'dartdart');
  *
  *       HttpServer
@@ skipping 28 matching lines @@
  *             socket.write('Hello, client.');
  *           });
  *         });
  *     }
  *
  * ## Other resources
  *
  * * HttpServer is a Stream. Refer to the [Stream] class for information
  * about the streaming qualities of an HttpServer.
  * Pausing the subscription of the stream, pauses at the OS level.
- * 
+ *
  * * The [http_server](https://pub.dartlang.org/packages/http_server)
  * package on pub.dartlang.org contains a set of high-level classes that,
  * together with this class, makes it easy to provide content through HTTP
  * servers.
  */
 abstract class HttpServer implements Stream<HttpRequest> {
   /**
-   * Set and get the default value of the `Server` header for all responses
-   * generated by this [HttpServer]. By default, it's disabled.
+   * Get and set the default value of the `Server` header for all responses
+   * generated by this [HttpServer].
    *
-   * If the serverHeader is set to `null`, no default `Server` header will be
-   * added to each response.
+   * If [serverHeader] is `null`, no `Server` header will be added to each
+   * response.
+   *
+   * The default value is `null`.
    */
   String serverHeader;
 
   /**
    * Get or set the timeout used for idle keep-alive connections. If no further
    * request is seen within [idleTimeout] after the previous request was
    * completed, the connection is dropped.
    *
    * Default is 120 seconds.
    *
@@ skipping 809 matching lines @@
 
 /**
  * An HTTP response, which returns the headers and data
  * from the server to the client in response to an HTTP request.
  *
  * Every HttpRequest object provides access to the associated [HttpResponse]
  * object through the `response` property.
  * The server sends its response to the client by writing to the
  * HttpResponse object.
  *
- * ## Writing the response 
+ * ## Writing the response
  *
  * This class implements [IOSink].
  * After the header has been set up, the methods
  * from IOSink, such as `writeln()`, can be used to write
  * the body of the HTTP response.
  * Use the `close()` method to close the response and send it to the client.
  *
  *     server.listen((HttpRequest request) {
  *       request.response.write('Hello, world!');
  *       request.response.close();
@@ skipping 910 matching lines @@
 class RedirectException implements HttpException {
   final String message;
   final List<RedirectInfo> redirects;
 
   const RedirectException(this.message, this.redirects);
 
   String toString() => "RedirectException: $message";
 
   Uri get uri => redirects.last.location;
 }