Index: trunk/web-app/js/assetTree.js
===================================================================
--- trunk/web-app/js/assetTree.js	(revision 312)
+++ trunk/web-app/js/assetTree.js	(revision 316)
@@ -1,6 +1,12 @@
 
 function showAssetTreePane(paneDivId, loadingImg, url) {
+
     Effect.Appear(paneDivId,{duration:0.4});
+
+    // Pulsing loadingImg blocks the default grails animated gif till complete.
+    // After which the default will show as normal.
     new Effect.Pulsate($(loadingImg), { pulses: 200, duration: 133 });
+
+    // The updater is only called once per page refresh.
     new Ajax.Updater({ success: paneDivId }, url, {asynchronous:true,evalScripts:true});
 }
@@ -8,5 +14,5 @@
 function hideAssetTreePane(paneDivId, tableDivId, saveUrl) {
 
-    // Collect the visible div's first.
+    // Collect the visible branch div's first.
     var visibleDivs = $(tableDivId).select('div').findAll(function(el) { return el.visible(); })
     var params = "assetTreeVisibleBranches=";
@@ -24,5 +30,5 @@
     params = params.slice(0,params.length-1);
 
-    // Post the id's of all visible divs.
+    // Post the id's of all visible branch div's.
     // asynchronous: false is against the prototype recommendations but appears to be needed in this case.
     new Ajax.Request(saveUrl, {parameters: params, asynchronous: false});