Add HttpServer:autoCompress option, to disable auto gzip compression.

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 161 matching lines @@
    *     X-Frame-Options: SAMEORIGIN
    *     X-Content-Type-Options: nosniff
    *     X-XSS-Protection: 1; mode=block
    *
    * If the `Server` header is added here and the `serverHeader` is set as
    * well then the value of `serverHeader` takes precedence.
    */
   HttpHeaders get defaultResponseHeaders;
 
   /**
+   * Get and set if the [HttpServer] should auto-compress the content, when

[Lasse Reichstein Nielsen, 2014/09/23 07:24:52]

Other documentation doesn't use "get and set".
This is a property, so just describe it as a noun (or here, since it's bool, as
a choice), not as its getter/setter's behavior.

"Whether the [HttpServer] will automatically compress the content, if possible."

[Anders Johnsen, 2014/09/23 08:35:34]

Done.

+   * possible.
+   *
+   * The [HttpServer] will only compress when the response is using chunked
+   * Transfer-Encoding and the incoming request has `gzip` set in the
+   * Accept-Encoding header.
+   *
+   * To disable, set to `false`.

[Lasse Reichstein Nielsen, 2014/09/23 07:24:52]

Combine the two short paragrahps?
"The default value is `true` (auto-compress enabled). To disable, set
`autoCompress` to `false`."

[Anders Johnsen, 2014/09/23 08:35:34]

Done.

+   *
+   * The default value is `true`.

[Søren Gjesse, 2014/09/23 07:56:23]

I know the current default is true, but we should consider making the default
false, so nothing "automatic" happens unless explicitly turned on.

[Anders Johnsen, 2014/09/23 08:35:34]

Done.

+   */
+  bool autoCompress;

[Lasse Reichstein Nielsen, 2014/09/23 07:24:52]

If you can enable and disable it, should it still be called "auto", and not just
"compress"?

How about:
  /**
   * Whether the [HttpServer] should compress the content, if possible.
   *
   * The content can only be compressed when the response is using
   * chunked Transfer-Encoding and the incoming request has `gzip` in 
   * as an accepted encoding in the Accept-Encoding header.
   *
   * The default value is `true` (compression enabled). 
   * To disable, set `compress` to false.
   */
  bool compress; 

[Anders Johnsen, 2014/09/23 08:35:34]

Done.

+
+  /**
    * 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.
    *
    * Note that it may take up to `2 * idleTimeout` before a idle connection is
    * aborted.
    *
    * To disable, set [idleTimeout] to `null`.
@@ skipping 1785 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;
 }