From 34cdae35dba538a5d834b9ae18c4e493bbad878c Mon Sep 17 00:00:00 2001 From: Dmitry Lomov Date: Tue, 28 Jun 2016 16:13:35 +0000 Subject: Reorganize Skylark Reference documentation. -- MOS_MIGRATED_REVID=126081020 --- .../lib/analysis/TransitiveInfoCollection.java | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) (limited to 'src/main/java/com/google/devtools/build/lib/analysis/TransitiveInfoCollection.java') diff --git a/src/main/java/com/google/devtools/build/lib/analysis/TransitiveInfoCollection.java b/src/main/java/com/google/devtools/build/lib/analysis/TransitiveInfoCollection.java index ab53315111..6dd8dd7f13 100644 --- a/src/main/java/com/google/devtools/build/lib/analysis/TransitiveInfoCollection.java +++ b/src/main/java/com/google/devtools/build/lib/analysis/TransitiveInfoCollection.java @@ -17,26 +17,29 @@ package com.google.devtools.build.lib.analysis; import com.google.devtools.build.lib.analysis.config.BuildConfiguration; import com.google.devtools.build.lib.cmdline.Label; import com.google.devtools.build.lib.skylarkinterface.SkylarkModule; +import com.google.devtools.build.lib.skylarkinterface.SkylarkModuleCategory; import javax.annotation.Nullable; /** * Multiple {@link TransitiveInfoProvider}s bundled together. * - * Represents the information made available by a {@link ConfiguredTarget} to other ones that - * depend on it. For more information about the analysis phase, see - * {@link com.google.devtools.build.lib.rules.RuleConfiguredTargetFactory}. + *

Represents the information made available by a {@link ConfiguredTarget} to other ones that + * depend on it. For more information about the analysis phase, see {@link + * com.google.devtools.build.lib.rules.RuleConfiguredTargetFactory}. * - *

Implementations of build rules should not hold on to references to the - * {@link TransitiveInfoCollection}s representing their direct prerequisites in order to reduce - * their memory footprint (otherwise, the referenced object could refer one of its direct - * dependencies in turn, thereby making the size of the objects reachable from a single instance - * unbounded). + *

Implementations of build rules should not hold on to references to the {@link + * TransitiveInfoCollection}s representing their direct prerequisites in order to reduce their + * memory footprint (otherwise, the referenced object could refer one of its direct dependencies in + * turn, thereby making the size of the objects reachable from a single instance unbounded). * * @see com.google.devtools.build.lib.rules.RuleConfiguredTargetFactory * @see TransitiveInfoProvider */ -@SkylarkModule(name = "Target", doc = +@SkylarkModule( + name = "Target", + category = SkylarkModuleCategory.BUILTIN, + doc = "A BUILD target. It is essentially a struct with the following fields:" + "