aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/main/java/com/google/devtools/build/lib/analysis/AnalysisEnvironment.java
diff options
context:
space:
mode:
authorGravatar Janak Ramakrishnan <janakr@google.com>2016-03-22 20:07:43 +0000
committerGravatar Damien Martin-Guillerez <dmarting@google.com>2016-03-23 12:19:51 +0000
commit81c5bd88bed02f7541cf56dd27d96867a560c4b7 (patch)
tree6b3211f489f64dbcf2f9829fdf89b3daa2f9c741 /src/main/java/com/google/devtools/build/lib/analysis/AnalysisEnvironment.java
parent73f2a45d3a601b43e72c866e44f4ba3eaa782aeb (diff)
Add comments to analysis-phase objects so future developers won't accidentally keep references to them after the analysis phase.
-- MOS_MIGRATED_REVID=117855145
Diffstat (limited to 'src/main/java/com/google/devtools/build/lib/analysis/AnalysisEnvironment.java')
-rw-r--r--src/main/java/com/google/devtools/build/lib/analysis/AnalysisEnvironment.java5
1 files changed, 5 insertions, 0 deletions
diff --git a/src/main/java/com/google/devtools/build/lib/analysis/AnalysisEnvironment.java b/src/main/java/com/google/devtools/build/lib/analysis/AnalysisEnvironment.java
index bf0213959e..cf1b16b8d7 100644
--- a/src/main/java/com/google/devtools/build/lib/analysis/AnalysisEnvironment.java
+++ b/src/main/java/com/google/devtools/build/lib/analysis/AnalysisEnvironment.java
@@ -29,6 +29,11 @@ import com.google.devtools.build.skyframe.SkyFunction;
/**
* The set of services that are provided to {@link ConfiguredTarget} objects
* during initialization.
+ *
+ * <p>These objects should not outlast the analysis phase. Do not pass them to {@link Action}
+ * objects or other persistent objects. There are internal tests to ensure that AnalysisEnvironment
+ * objects are not persisted that check the name of this class, so update those tests you change the
+ * names of any implementation of this class.
*/
public interface AnalysisEnvironment extends ActionRegistry {
/**