@@ -292,25 +293,22 @@ public abstract class SCM implements Describable<SCM>, ExtensionPoint {
...
@@ -292,25 +293,22 @@ public abstract class SCM implements Describable<SCM>, ExtensionPoint {
* during check out, in which case this method will not called.
* during check out, in which case this method will not called.
*
*
* @param build
* @param build
* The calculated {@link SCMRevisionState} is for the files checked out in this build. Never null.
* The calculated {@link SCMRevisionState} is for the files checked out in this build.
* If {@link #requiresWorkspaceForPolling()} returns true, Hudson makes sure that the workspace of this
* If {@link #requiresWorkspaceForPolling()} returns true, Hudson makes sure that the workspace of this
* build is available and accessible by the callee.
* build is available and accessible by the callee.
* @param workspace the location of the checkout
* @param workspace the location of the checkout; normally not null, since this will normally be called immediately after checkout,
* though could be null if data is being loaded from a very old version of Jenkins and the SCM declares that it does not require a workspace for polling
* @param launcher
* @param launcher
* Abstraction of the machine where the polling will take place. If SCM declares
* Abstraction of the machine where the polling will take place. Nullness matches that of {@code workspace}.
* that {@linkplain #requiresWorkspaceForPolling() the polling doesn't require a workspace},
* this parameter is null. Otherwise never null.
* @param listener
* @param listener
* Logs during the polling should be sent here.
* Logs during the polling should be sent here.
*
*
* @return can be null.
*
* @throws InterruptedException
* @throws InterruptedException
* interruption is usually caused by the user aborting the computation.
* interruption is usually caused by the user aborting the computation.
* this exception should be simply propagated all the way up.
* this exception should be simply propagated all the way up.