diff --git a/core/src/main/java/hudson/model/Computer.java b/core/src/main/java/hudson/model/Computer.java
index 8e86fbfe034f15943a58eb1e8875db937d0c0110..28d1a711e65b4e087b67d2dcdbf31727bf967362 100644
--- a/core/src/main/java/hudson/model/Computer.java
+++ b/core/src/main/java/hudson/model/Computer.java
@@ -117,6 +117,10 @@ public final class Computer implements ModelObject {
         return r;
     }
 
+    /**
+     * Called to notify {@link Computer} that its corresponding {@link Node}
+     * configuration is updated.
+     */
     /*package*/ void setNode(Node node) {
         assert node!=null;
         if(node instanceof Slave)
@@ -127,6 +131,9 @@ public final class Computer implements ModelObject {
         setNumExecutors(node.getNumExecutors());
     }
 
+    /**
+     * Called to notify {@link Computer} that it will be discarded.
+     */
     /*package*/ void kill() {
         setNumExecutors(0);
     }