Improve the HttpClient documentation

Improve the HttpClient documentation

BUG=http://dartbug.org/9534

R=whesse@google.com

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

[Bill Hesse, 2013-08-01 08:33:31]

lgtm

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

https://codereview.chromium.org/20781005/diff/1/sdk/lib/io/http.dart#newcode959
sdk/lib/io/http.dart:959: * and the flow of the HTTP request, see the overall
documentation
Would

completes, and on using the HttpClientRequest that it completes with, see the

or

For additional information on the sequence of events during an HTTP transaction,
and the objects returned by the futures, see the

be better?

https://codereview.chromium.org/20781005/diff/1/sdk/lib/io/http.dart#newcode989
sdk/lib/io/http.dart:989: * specified using [path].
path (and possible query)
?

[Søren Gjesse, 2013-08-01 09:25:59]

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

https://codereview.chromium.org/20781005/diff/1/sdk/lib/io/http.dart#newcode959
sdk/lib/io/http.dart:959: * and the flow of the HTTP request, see the overall
documentation
On 2013/08/01 08:33:31, Bill Hesse wrote:
> Would
> 
> completes, and on using the HttpClientRequest that it completes with, see the
> 
> or
> 
> For additional information on the sequence of events during an HTTP
transaction,
> and the objects returned by the futures, see the
> 
> be better?

Yes, thanks (picked the second one).

https://codereview.chromium.org/20781005/diff/1/sdk/lib/io/http.dart#newcode989
sdk/lib/io/http.dart:989: * specified using [path].
On 2013/08/01 08:33:31, Bill Hesse wrote:
> path (and possible query)
> ?

Done, added fragment as well.

[Søren Gjesse, 2013-08-01 09:26:35]

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