tree 0eb917a9bd610be9bb2202954fad65b1401ecb14
parent e5732b1886af797c23bb7886c045081cb1334009
author Lasse Reichstein Holst Nielsen <lrn@google.com> 1613566323 +0000
committer commit-bot@chromium.org <commit-bot@chromium.org> 1613566323 +0000

Add documentation saying that `String.fromEnvironment` etc. must behave consistently.

AAll calls to those constructors must behave as if there is a single consistent
environment backing them.
This will force compilers to reject programs where that wouldn't be the case,
which is possible if doing modular compilation with different settings.

If a library doesn't check the environment, it doesn't matter whether the
environment was declared differently, the requirement is only that when actually checking,
the values must be consistent.

Bug: https://github.com/dart-lang/language/issues/304
Change-Id: Ie52ecc3ea49ed87297fab92e5e7bb6d9f96a495d
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/184467
Commit-Queue: Lasse R.H. Nielsen <lrn@google.com>
Reviewed-by: Sigmund Cherem <sigmund@google.com>
Reviewed-by: Leaf Petersen <leafp@google.com>
Reviewed-by: Erik Ernst <eernst@google.com>