commit | 9ff2c109bb4035e992189547c933e15dd7083fee | [log] [tgz] |
---|---|---|
author | Jonas Termansen <sortie@google.com> | Fri Jun 07 15:03:30 2019 +0000 |
committer | commit-bot@chromium.org <commit-bot@chromium.org> | Fri Jun 07 15:03:30 2019 +0000 |
tree | f6347a88d3f20b776b765cd1f70bdddaee280f9c | |
parent | 8a57c1d463699ed1237d96e0d0025176868e64ec [diff] |
[dart:io] Clarify CompressionOptions null window bits means default window. CompressionOptions's clientMaxWindowBits and serverMaxWindowBits are null by default, indicating that no particular window size is negotiated in the protocol, instead implying that the connection can handle a default window size of 15 (32,768 bytes) (RFC 7692 7.1.2.1 and 7.1.2.2). This change clarifies the documentation for the clientMaxWindowBits and serverMaxWindowBits fields by stating they can be null to request the protocol's default window size. The current implementation's behavior is reasonable. It could be changed to explicitly say 15 instead of null, but it's more efficient to omit the request for 15 bits from the protocol since it's default, and it's fine to allow callers to explicitly request 15 bits since the code already allows this behavior. This change simply codifies the existing behavior in the documentation. The co19 test LibTest/io/CompressionOptions/DEFAULT_A01_t01 was written based off the misleading documentation. An issue to test the intended behavior was filed at <https://github.com/dart-lang/co19/issues/364>. Closes https://github.com/dart-lang/sdk/issues/29436 Change-Id: If7645e7d5abd59715fd1eb0bfe8cbb877d776402 Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/103813 Commit-Queue: Jonas Termansen <sortie@google.com> Reviewed-by: Lasse R.H. Nielsen <lrn@google.com>
Dart is:
Optimized for UI: Develop with a programming language specialized around the needs of user interface creation
Productive: Make changes iteratively: use hot reload to see the result instantly in your running app
Fast on all platforms: Compile to ARM & x64 machine code for mobile, desktop, and backend. Or compile to JavaScript for the web
Dart has flexible compiler technology lets you run Dart code in different ways, depending on your target platform and goals:
Dart Native: For programs targeting devices (mobile, desktop, server, and more), Dart Native includes both a Dart VM with JIT (just-in-time) compilation and an AOT (ahead-of-time) compiler for producing machine code.
Dart Web: For programs targeting the web, Dart Web includes both a development time compiler (dartdevc) and a production time compiler (dart2js).
Dart is free and open source.
Visit the dart.dev to learn more about the language, tools, getting started, and more.
Browse pub.dev for more packages and libraries contributed by the community and the Dart team.
If you want to build Dart yourself, here is a guide to getting the source, preparing your machine to build the SDK, and building.
There are more documents on our wiki.
The easiest way to contribute to Dart is to file issues.
You can also contribute patches, as described in Contributing.