aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/main/java/com
diff options
context:
space:
mode:
authorGravatar Laurent Le Brun <laurentlb@google.com>2015-04-01 14:16:30 +0000
committerGravatar Han-Wen Nienhuys <hanwen@google.com>2015-04-01 15:36:38 +0000
commitd90db7fc816339c9f40f51cc893524b5b9584846 (patch)
tree0fdec5a80a23561089a42c18ce5043e55eabd20c /src/main/java/com
parentf94cfd397347b5dd6c5c85a0e69924f0bbe54910 (diff)
Skylark: Improve documentation for configuration transitions.
-- MOS_MIGRATED_REVID=90061800
Diffstat (limited to 'src/main/java/com')
-rw-r--r--src/main/java/com/google/devtools/build/lib/packages/Attribute.java4
-rw-r--r--src/main/java/com/google/devtools/build/lib/rules/SkylarkRuleClassFunctions.java4
2 files changed, 5 insertions, 3 deletions
diff --git a/src/main/java/com/google/devtools/build/lib/packages/Attribute.java b/src/main/java/com/google/devtools/build/lib/packages/Attribute.java
index cdd2c0ff83..38bab82545 100644
--- a/src/main/java/com/google/devtools/build/lib/packages/Attribute.java
+++ b/src/main/java/com/google/devtools/build/lib/packages/Attribute.java
@@ -89,7 +89,9 @@ public final class Attribute implements Comparable<Attribute> {
* label list attribute.
*/
@SkylarkModule(name = "ConfigurationTransition", doc =
- "Declares how the configuration should change when following a dependency.")
+ "Declares how the configuration should change when following a dependency. "
+ + "It can be either <a href=\"#modules._top_level.DATA_CFG\">DATA_CFG</a> or "
+ + "<a href=\"#modules._top_level.HOST_CFG\">HOST_CFG</a>.")
public enum ConfigurationTransition implements Transition {
/** No transition, i.e., the same configuration as the current. */
NONE,
diff --git a/src/main/java/com/google/devtools/build/lib/rules/SkylarkRuleClassFunctions.java b/src/main/java/com/google/devtools/build/lib/rules/SkylarkRuleClassFunctions.java
index f173218727..36444a3d04 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/SkylarkRuleClassFunctions.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/SkylarkRuleClassFunctions.java
@@ -85,11 +85,11 @@ public class SkylarkRuleClassFunctions {
//TODO(bazel-team): proper enum support
@SkylarkBuiltin(name = "DATA_CFG", returnType = ConfigurationTransition.class,
- doc = "The default runfiles collection state.")
+ doc = "Experimental. Specifies a transition to the data configuration.")
private static final Object dataTransition = ConfigurationTransition.DATA;
@SkylarkBuiltin(name = "HOST_CFG", returnType = ConfigurationTransition.class,
- doc = "The default runfiles collection state.")
+ doc = "Specifies a transition to the host configuration.")
private static final Object hostTransition = ConfigurationTransition.HOST;
private static final LateBoundLabel<BuildConfiguration> RUN_UNDER =