Update documentation about `exec_tools` vs `tools`.
@@ -96,10 +96,11 @@ public class GenRuleBaseRule implements RuleDefinition {
<a href="#genrule.tools"><code>tools</code></a> for further details.
<p>
- Note that eventually the host configuration will be replaced by the execution
- configuration. When that happens, this attribute will be deprecated in favor of
- <code>tools</code>. Until then, this attribute allows users to selectively migrate
- dependencies to the execution configuration.
+ The Blaze team is migrating all uses of <code>tools</code> to use <code>exec_tools</code>
+ semantics. Users are encouraged to prefer <code>exec_tools</code> to <code>tools</code>
+ where this does not cause any issues. After the functional migration is complete, we may
+ rename <code>exec_tools</code> to <code>tools</code>. You will receive a deprecation
+ warning and migration instructions before this happens.
</p>
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.add(
