Clarify docs on which flags can be set in the platform rule's flags attribute.

katre · copybara-github · commit 0a7cab1f527b · 2025-04-14T09:03:18.000-07:00
PiperOrigin-RevId: 747440090
Change-Id: I1264d01fc985b262cb2c2d54aa8fc1b8e63fe80b
diff --git a/src/main/java/com/google/devtools/build/lib/rules/platform/PlatformRule.java b/src/main/java/com/google/devtools/build/lib/rules/platform/PlatformRule.java
@@ -119,7 +119,8 @@ public RuleClass build(RuleClass.Builder builder, RuleDefinitionEnvironment env)
 
         /* <!-- #BLAZE_RULE(platform).ATTRIBUTE(flags) -->
         A list of flags that will be enabled when this platform is used as the target platform in
-        a configuration. Only flags that can be set in transitions are allowed to be used.
+        a configuration. Only flags that are part of the configuration can be set, such as those
+        that can be used in transitions, or the <code>--define</code> flag.
         <!-- #END_BLAZE_RULE.ATTRIBUTE --> */
         .add(
             attr(FLAGS_ATTR, Types.STRING_LIST)
