doc improvements

remoting/src/main/java/hudson/remoting/ImportedClassLoaderTable.java

@@ -39,6 +39,12 @@ final class ImportedClassLoaderTable {
         this.channel = channel;
     }
 
+    /**
+     * Maps the exported object ID to the classloader.
+     *
+     * <p>
+     * This method "consumes" the given oid for the purpose of reference counting.
+     */
     public synchronized ClassLoader get(int oid) {
         return get(RemoteInvocationHandler.wrap(channel,oid,IClassLoader.class,false,false));
     }

remoting/src/main/java/hudson/remoting/MultiClassLoaderSerializer.java

@@ -61,6 +61,7 @@ class MultiClassLoaderSerializer {
                 }
 
                 // tell the receiving side that they need to import a new classloader
+                // this reference count is released when RemoteInvocationHandler backing IClassLoader is GCed on the remote node.
                 writeInt(TAG_EXPORTED_CLASSLOADER);
                 writeInt(RemoteClassLoader.exportId(cl,channel));
             } else {// reference to a classloader that's already written