diff --git a/core/src/main/java/hudson/model/Computer.java b/core/src/main/java/hudson/model/Computer.java index 22ea1ad5bf..a4c1236070 100644 --- a/core/src/main/java/hudson/model/Computer.java +++ b/core/src/main/java/hudson/model/Computer.java @@ -271,6 +271,14 @@ public abstract class Computer extends AbstractModelObject { /** * Returns the time when this computer first became idle. + * + *
+ * If this computer is already idle, the return value will point to the + * time in the past since when this computer has been idle. + * + *
+ * If this computer is busy, the return value will point to the + * time in the future where this computer will be expected to become free. */ public final long getIdleStartMilliseconds() { long firstIdle = Long.MIN_VALUE;