Separate out team-specific parts of mkws.debug_function() into inner
[mkws-moved-to-github.git] / tools / htdocs / mkws.js
index e9da39d..df00102 100644 (file)
@@ -66,18 +66,11 @@ Handlebars.registerHelper('commaList', function(items, options) {
 
 
 
-// Some functions are visible to be called from outside code, namely
-// generated HTML: that.switchView(), showDetails(), limitTarget(),
-// limitQuery(), delimitTarget(), delimitQuery(), pagerPrev(),
-// pagerNext(), showPage(). Also mkws.M() is made available for the
-// Handlebars helper 'translate'
-
-
-// Set up global mkws object. Contains a hash of team objects,
-// indexed by windowid.
+// Set up global mkws object. Contains truly global state such as SP
+// authentication, and a hash of team objects, indexed by windowid.
+//
 var mkws = {
     authenticated: false,
-    debug_function: undefined, // will be set during initialisation
     debug_level: undefined, // will be initialised from mkws_config
     paz: undefined, // will be set up during initialisation
     teams: {},
@@ -149,7 +142,15 @@ if (mkws_config == null || typeof mkws_config != 'object') {
 }
 
 
-// wrapper for jQuery lib
+// Factory function for team objects. As much as possible, this uses
+// only member variables (prefixed "m_") and inner functions with
+// private scope. Some functions are visibl as member-functions to be
+// called from outside code -- specifically, from generated
+// HTML. These functions are that.switchView(), showDetails(),
+// limitTarget(), limitQuery(), delimitTarget(), delimitQuery(),
+// pagerPrev(), pagerNext(), showPage(). Also mkws.M() is made
+// available for the Handlebars helper 'translate'
+//
 function team($, teamName) {
     var that = {};
     var m_teamName = teamName;
@@ -184,19 +185,23 @@ function team($, teamName) {
            return;
        }
 
-       var now = $.now();
-       var timestamp = ((now - m_debug_time.start)/1000).toFixed(3) + " (+" + ((now - m_debug_time.last)/1000).toFixed(3) + ") "
-       m_debug_time.last = now;
-
        // you need to disable use strict at the top of the file!!!
        if (mkws.debug_level >= 3) {
-           console.log(timestamp + arguments.callee.caller);
+           console.log(arguments.callee.caller);
        } else if (mkws.debug_level >= 2) {
-           console.log(timestamp + ">>> called from function " + arguments.callee.caller.name + ' <<<');
+           console.log(">>> called from function " + arguments.callee.caller.name + ' <<<');
        }
-       console.log(m_teamName + ": " + timestamp + string);
+       console.log(string);
     }
-    var debug = mkws.debug_function; // local alias
+
+    var debug = function (s) {
+       var now = $.now();
+       var timestamp = ((now - m_debug_time.start)/1000).toFixed(3) + " (+" + ((now - m_debug_time.last)/1000).toFixed(3) + ") "
+       m_debug_time.last = now;
+
+       mkws.debug_function(m_teamName + ": " + timestamp + s);
+    }
+
     debug("start running MKWS");
 
     m_sort = mkws_config.sort_default;