Add documentation for fragments type, and add the four fragments (apple, cpp, java, jvm) to the documentation.

--
MOS_MIGRATED_REVID=116092594

1 files changed, 6 insertions, 1 deletions

diff --git a/src/main/java/com/google/devtools/build/lib/analysis/config/FragmentCollection.java b/src/main/java/com/google/devtools/build/lib/analysis/config/FragmentCollection.java
index acc930afef..f1ff98f83b 100644
--- a/src/main/java/com/google/devtools/build/lib/analysis/config/FragmentCollection.java
+++ b/src/main/java/com/google/devtools/build/lib/analysis/config/FragmentCollection.java
@@ -28,7 +28,12 @@ import javax.annotation.Nullable;
  */
 // Documentation can be found at ctx.fragments
 @Immutable
-@SkylarkModule(name = "fragments", documented = false, doc = "")
+@SkylarkModule(name = "fragments", doc = "Possible fields are "
+    + "<a href=\"apple.html\">apple</a>, <a href=\"cpp.html\">cpp</a>, "
+    + "<a href=\"java.html\">java</a> and <a href=\"jvm.html\">jvm</a>. "
+    + "Access a specific fragment by its field name ex:</p><code>ctx.fragments.apple</code></p>"
+    + "Note that rules have to declare their required fragments in order to access them "
+    + "(see <a href=\"../rules.html#fragments\">here</a>).")
 public class FragmentCollection implements ClassObject {
   private final RuleContext ruleContext;
   private final ConfigurationTransition config;