Update HTTP documentation

Update HTTP documentation

BUG= http://dartbug.com/17989
R=ajohnsen@google.com

Committed: https://code.google.com/p/dart/source/detail?r=34733

[Anders Johnsen, 2014-04-04 12:56:40]

LGTM, with comments.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart
File sdk/lib/io/http.dart (right):

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode928
sdk/lib/io/http.dart:928: * The request headers are immutable.
This looks like half a copy of the above line. Consider:

  The returned [HttpHeaders] are immutable.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode...
sdk/lib/io/http.dart:1051: * to. Setting the status code after writing to the
body will throw
or closed.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode...
sdk/lib/io/http.dart:1061: * to. Setting the reason phrase after writing to the
body will throw
ditto.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode...
sdk/lib/io/http.dart:1089: * to. After that they become immutable.
ditto.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode...
sdk/lib/io/http.dart:1569: * The client request headers can be modified until
the body is
ditto, and below

[Søren Gjesse, 2014-04-04 13:05:27]

Committed patchset #2 manually as r34733 (presubmit successful).

[Søren Gjesse, 2014-04-04 13:06:13]

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart
File sdk/lib/io/http.dart (right):

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode928
sdk/lib/io/http.dart:928: * The request headers are immutable.
On 2014/04/04 12:56:40, Anders Johnsen wrote:
> This looks like half a copy of the above line. Consider:
> 
>   The returned [HttpHeaders] are immutable.

Done.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode...
sdk/lib/io/http.dart:1051: * to. Setting the status code after writing to the
body will throw
On 2014/04/04 12:56:40, Anders Johnsen wrote:
> or closed.

Done.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode...
sdk/lib/io/http.dart:1061: * to. Setting the reason phrase after writing to the
body will throw
On 2014/04/04 12:56:40, Anders Johnsen wrote:
> ditto.

Done.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode...
sdk/lib/io/http.dart:1089: * to. After that they become immutable.
On 2014/04/04 12:56:40, Anders Johnsen wrote:
> ditto.

Done.

https://codereview.chromium.org/225323005/diff/1/sdk/lib/io/http.dart#newcode...
sdk/lib/io/http.dart:1569: * The client request headers can be modified until
the body is
On 2014/04/04 12:56:40, Anders Johnsen wrote:
> ditto, and below

Done.