aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
-rw-r--r--site/docs/skylark/backward-compatibility.md11
1 files changed, 6 insertions, 5 deletions
diff --git a/site/docs/skylark/backward-compatibility.md b/site/docs/skylark/backward-compatibility.md
index 52237e65c3..6ae198835c 100644
--- a/site/docs/skylark/backward-compatibility.md
+++ b/site/docs/skylark/backward-compatibility.md
@@ -236,8 +236,8 @@ If you really want to override a value, use a separate statement:
## New actions API
This change removes the old methods for registering actions within rules, and
-requires that you use the new methods instead (which are available regardless).
-The deprecated methods and their replacements are as follows.
+requires that you use the new methods instead. The deprecated methods and their
+replacements are as follows.
* `ctx.new_file(...)` --> `ctx.actions.declare_file(...)`
* `ctx.experimental_new_directory(...)` -->
@@ -265,9 +265,10 @@ All integers are stored using signed 32 bits.
## Descriptive string representations
-For certain types of objects, this changes the string representations returned
-by `str()` and `repr()` to be more uniform and safe. In particular, the new
-representations are hermetic and deterministic.
+For certain types of objects (such as `Label`, `File`, and rule contexts), this
+flag changes the string representations returned by `str()` and `repr()` to be
+more uniform and safe. In particular, the new representations are hermetic and
+deterministic.
* Flag: `--incompatible_descriptive_string_representations`
* Default: `true`