add some comments about referencing

Author: Myron Scott

common/src/main/java/com/tc/net/protocol/transport/ConnectionWatcher.java

@@ -39,6 +39,7 @@ public class ConnectionWatcher implements MessageTransportListener {
    * Listens to events from a MessageTransport, acts on them, and passes events through to target
    */
   public ConnectionWatcher(ClientMessageChannel target, ClientConnectionEstablisher cce) {
+  // this the channel is no longer reachable, make sure all the the connection threads are cleaned up
     this.targetHolder = new WeakReference<>(target, stopQueue);
     this.cce = cce;
     this.connection = target.getConnectionID();

tc-client/src/main/java/com/tc/object/DistributedObjectClientFactory.java

@@ -74,6 +74,9 @@ public Void call() throws Exception {
 
     DistributedObjectClient client = ClientFactory.createClient(serverAddresses, builder, group, uuid, name);
     client.addShutdownHook(shutdown);
+    
+    //  weak reference to make sure threads associated with the client aren't preventing 
+    //  garbage collection of the client
     Reference<DistributedObjectClient> ref = new WeakReference<>(client);
 
     throwableHandler.addCallbackOnExitDefaultHandler(state->{