Cleanup javadoc around Mutability / SkylarkMutable
Also throw IllegalArgumentException instead of AssertionError.
A follow-up CL will look to eliminate the SkylarkMutable#checkMutable(Location, Environment) override in favor of checkMutable(Location, Mutability). This will make it easier to manipulate Skylark values in specialized contexts aside from normal evaluation.
RELNOTES: None
PiperOrigin-RevId: 163978262
diff --git a/src/main/java/com/google/devtools/build/lib/syntax/Environment.java b/src/main/java/com/google/devtools/build/lib/syntax/Environment.java
index 4bec1c6..0ae54ff 100644
--- a/src/main/java/com/google/devtools/build/lib/syntax/Environment.java
+++ b/src/main/java/com/google/devtools/build/lib/syntax/Environment.java
@@ -238,7 +238,7 @@
*/
public void put(Environment env, String varname, Object value)
throws MutabilityException {
- Mutability.checkMutable(this, env);
+ Mutability.checkMutable(this, env.mutability());
bindings.put(varname, value);
}
@@ -247,7 +247,7 @@
* be part of the public interface.
*/
void remove(Environment env, String varname) throws MutabilityException {
- Mutability.checkMutable(this, env);
+ Mutability.checkMutable(this, env.mutability());
bindings.remove(varname);
}