Define the dict iteration order

PiperOrigin-RevId: 186616752
bazelbuild · Feb 22, 2018 · d605a62 · d605a62
1 parent f6cbbee
commit d605a62
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/src/main/java/com/google/devtools/build/lib/syntax/SkylarkDict.java b/src/main/java/com/google/devtools/build/lib/syntax/SkylarkDict.java
@@ -51,7 +51,9 @@
           + "<code>in</code> operator tests for membership in the keyset of the dict.<br>"
           + "<pre class=\"language-python\">\"a\" in {\"a\" : 2, \"b\" : 5} "
           + "# evaluates as True</pre>"
-          + "The iteration order for a dict is deterministic but not specified."
+          + "The iteration order for a dict is deterministic and specified as the order in which "
+          + "the keys have been added to the dict. The iteration order is not affected if a value "
+          + "associated with an existing key is updated."
 )
 public final class SkylarkDict<K, V> extends MutableMap<K, V>
     implements Map<K, V>, SkylarkIndexable {