diff --git a/core/src/main/java/hudson/scm/SCM.java b/core/src/main/java/hudson/scm/SCM.java index cd38c8dd4b..cee145b09b 100644 --- a/core/src/main/java/hudson/scm/SCM.java +++ b/core/src/main/java/hudson/scm/SCM.java @@ -244,6 +244,12 @@ public abstract class SCM implements Describable, ExtensionPoint { *

* This can be used to propagate information from SCM to builds * (for example, SVN revision number.) + * + *

+ * This method is invoked whenever someone does {@link AbstractBuild#getEnvironment(TaskListener)}, which + * can be before/after your checkout method is invoked. So if you are going to provide information about + * check out (like SVN revision number that was checked out), be prepared for the possibility that the + * check out hasn't happened yet. */ public void buildEnvVars(AbstractBuild build, Map env) { // default implementation is noop.