Improve documentation for the select function

PiperOrigin-RevId: 182796843
wiccasoft · Jan 22, 2018 · 772d958 · 772d958
1 parent 65797d4
commit 772d958
Showing 1 changed file with 4 additions and 1 deletion.
diff --git a/src/main/java/com/google/devtools/build/lib/syntax/BazelLibrary.java b/src/main/java/com/google/devtools/build/lib/syntax/BazelLibrary.java
@@ -238,7 +238,10 @@ public MutableList<Object> invoke(SkylarkNestedSet input, Environment env) {
    */
   @SkylarkSignature(
     name = "select",
-    doc = "Creates a select from the dict parameter, usable for setting configurable attributes.",
+    doc =
+        "<code>select()</code> is the helper function that makes a rule attribute "
+            + "<a href=\"$BE_ROOT/common-definitions.html#configurable-attributes\">configurable</a>. "
+            + "See <a href=\"$BE_ROOT/functions.html#select\">build encyclopedia</a> for details.",
     parameters = {
       @Param(name = "x", type = SkylarkDict.class, doc = "The parameter to convert."),
       @Param(