commit 34cdae35dba538a5d834b9ae18c4e493bbad878c
author Dmitry Lomov <dslomov@google.com> Tue Jun 28 16:13:35 2016 +0000
committer Dmitry Lomov <dslomov@google.com> Wed Jun 29 08:53:49 2016 +0000
tree fdfe717f6033aaf26144bd320fff0da0d6a6bc48
parent 116c2f6724718fc408e0c73c9026d89281c75e87

Reorganize Skylark Reference documentation.

--
MOS_MIGRATED_REVID=126081020

src/main/java/com/google/devtools/build/lib/rules/SkylarkAttr.java

diff --git a/src/main/java/com/google/devtools/build/lib/rules/SkylarkAttr.java b/src/main/java/com/google/devtools/build/lib/rules/SkylarkAttr.java
index 7038b43..5b0fd57 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/SkylarkAttr.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/SkylarkAttr.java
@@ -26,6 +26,7 @@
 import com.google.devtools.build.lib.packages.SkylarkAspect;
 import com.google.devtools.build.lib.skylarkinterface.Param;
 import com.google.devtools.build.lib.skylarkinterface.SkylarkModule;
+import com.google.devtools.build.lib.skylarkinterface.SkylarkModuleCategory;
 import com.google.devtools.build.lib.skylarkinterface.SkylarkSignature;
 import com.google.devtools.build.lib.syntax.BuiltinFunction;
 import com.google.devtools.build.lib.syntax.Environment;
@@ -54,13 +55,14 @@
 /**
  * A helper class to provide Attr module in Skylark.
  *
- * <p>It exposes functions (e.g. 'attr.string', 'attr.label_list', etc.) to Skylark
- * users. The functions are executed through reflection. As everywhere in Skylark,
- * arguments are type-checked with the signature and cannot be null.
+ * <p>It exposes functions (e.g. 'attr.string', 'attr.label_list', etc.) to Skylark users. The
+ * functions are executed through reflection. As everywhere in Skylark, arguments are type-checked
+ * with the signature and cannot be null.
  */
 @SkylarkModule(
   name = "attr",
   namespace = true,
+  category = SkylarkModuleCategory.BUILTIN,
   doc =
       "Module for creating new attributes. "
           + "They are only for use with the <a href=\"globals.html#rule\">rule</a> function."
@@ -1054,9 +1056,14 @@
         }
       };
 
-  /**
-   * A descriptor of an attribute defined in Skylark.
-   */
+  /** A descriptor of an attribute defined in Skylark. */
+  @SkylarkModule(
+    name = "attr_defintion",
+    category = SkylarkModuleCategory.NONE,
+    doc =
+        "Representation of a definition of an attribute; cobnstructed by <code>attr.*</code>"
+            + " functions."
+  )
   public static final class Descriptor {
     private final Attribute.Builder<?> attributeBuilder;
     private final ImmutableList<SkylarkAspect> aspects;