Expose more documentation to Skylark.

--
MOS_MIGRATED_REVID=117123912

3 files changed, 8 insertions, 3 deletions

diff --git a/src/main/java/com/google/devtools/build/lib/rules/android/AndroidSkylarkApiProvider.java b/src/main/java/com/google/devtools/build/lib/rules/android/AndroidSkylarkApiProvider.java
index 707e8ed794..a8b81ddbaf 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/android/AndroidSkylarkApiProvider.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/android/AndroidSkylarkApiProvider.java
@@ -36,7 +36,8 @@ import javax.annotation.Nullable;
  */
 @SkylarkModule(
   name = "AndroidSkylarkApiProvider",
-  doc = "Provides access to information about Android rules"
+  doc = "Provides access to information about Android rules. Every Android-related target provides "
+  + "this struct, accessible as a 'java' field on a Target struct."
 )
 public class AndroidSkylarkApiProvider extends SkylarkApiProvider {
   /** The name of the field in Skylark used to access this class. */
diff --git a/src/main/java/com/google/devtools/build/lib/rules/cpp/CcSkylarkApiProvider.java b/src/main/java/com/google/devtools/build/lib/rules/cpp/CcSkylarkApiProvider.java
index 8bffba6719..674e68c6ca 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/cpp/CcSkylarkApiProvider.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/cpp/CcSkylarkApiProvider.java
@@ -28,7 +28,9 @@ import com.google.devtools.build.lib.vfs.PathFragment;
  * simple and stable interface for Skylark users.
  */
 @SkylarkModule(
-    name = "CcSkylarkApiProvider", doc = "Provides access to information about C++ rules")
+    name = "CcSkylarkApiProvider", doc = "Provides access to information about C++ rules.  "
+    + "Every C++-related target provides this struct, accessible as a 'cc' field on "
+    + "a Target struct.")
 public final class CcSkylarkApiProvider extends SkylarkApiProvider {
   /** The name of the field in Skylark used to access this class. */
   public static final String NAME = "cc";
diff --git a/src/main/java/com/google/devtools/build/lib/rules/java/JavaSkylarkApiProvider.java b/src/main/java/com/google/devtools/build/lib/rules/java/JavaSkylarkApiProvider.java
index f06dd905d6..0ec029e1fd 100644
--- a/src/main/java/com/google/devtools/build/lib/rules/java/JavaSkylarkApiProvider.java
+++ b/src/main/java/com/google/devtools/build/lib/rules/java/JavaSkylarkApiProvider.java
@@ -28,7 +28,9 @@ import com.google.devtools.build.lib.skylarkinterface.SkylarkModule;
  * simple and stable interface for Skylark users.
  */
 @SkylarkModule(
-    name = "JavaSkylarkApiProvider", doc = "Provides access to information about Java rules")
+    name = "JavaSkylarkApiProvider",
+    doc = "Provides access to information about Java rules. Every Java-related target provides "
+    + "this struct, accessible as a 'java' field on a Target struct.")
 public final class JavaSkylarkApiProvider extends SkylarkApiProvider {
   /** The name of the field in Skylark used to access this class. */
   public static final String NAME = "java";