JSDOC/BuildDocs.js
[gnome.introspection-doc-generator] / JSDOC / BuildDocs.js
index 531b19d..cb46ee7 100644 (file)
@@ -22,6 +22,17 @@ DocComment  = imports.DocComment.DocComment;
 
 // should not realy be here -- or anywhere...??
 
+function makeSortby(attribute) {
+    return function(a, b) {
+        if (a[attribute] != undefined && b[attribute] != undefined) {
+            a = a[attribute]; //.toLowerCase();
+            b = b[attribute];//.toLowerCase();
+            if (a < b) return -1;
+            if (a > b) return 1;
+            return 0;
+        }
+    }
+}
 
 Options = false; // refer to this everywhere!
 
@@ -137,7 +148,7 @@ BuildDocs = {
 
             var txs = new TextStream(src);
             
-            var tr = new TokenReader({ keepComments : true, keepWhite : true });
+            var tr = new TokenReader({ keepComments : true, keepWhite : true , sepIdents: false });
             
             var ts = new TokenStream(tr.tokenize(txs));
         
@@ -220,17 +231,7 @@ BuildDocs = {
         function isaClass($) { 
             return ($.is("CONSTRUCTOR") || $.isNamespace); 
         }
-        function makeSortby(attribute) {
-            return function(a, b) {
-                if (a[attribute] != undefined && b[attribute] != undefined) {
-                    a = a[attribute]; //.toLowerCase();
-                    b = b[attribute];//.toLowerCase();
-                    if (a < b) return -1;
-                    if (a > b) return 1;
-                    return 0;
-                }
-            }
-        }
+        
         
         
         
@@ -252,9 +253,11 @@ BuildDocs = {
         
         var classes = symbols.filter(isaClass).sort(makeSortby("alias"));
          
-       var classesIndex = classesTemplate.process(classes); // kept in memory
-        
+         //Options.LOG.inform("classTemplate Process : all classes");
+            
+       // var classesIndex = classesTemplate.process(classes); // kept in memory
         
+        Options.LOG.inform("iterate classes");
         
         for (var i = 0, l = classes.length; i < l; i++) {
             var symbol = classes[i];
@@ -269,7 +272,7 @@ BuildDocs = {
             
             // dump out a 
             
-            this.publishJSON(Options.target+"/json/" symbol.alias+'.json', symbol)
+            this.publishJSON(Options.target+"/json/" + symbol.alias+'.json', symbol)
             
             
             
@@ -277,9 +280,9 @@ BuildDocs = {
         
         // regenrate the index with different relative links
         Link.base = "";
-        var classesIndex = classesTemplate.process(classes);
+        //var classesIndex = classesTemplate.process(classes);
         
-          
+        Options.LOG.inform("build index");
         
         File.write(Options.target +  "/index."+ Options.publishExt, 
             classesindexTemplate.process(classes)
@@ -305,12 +308,19 @@ BuildDocs = {
         }
             
         allFiles = allFiles.sort(makeSortby("name"));
-        File.write(Options.target , "/files."+Options.publishExt, 
+        Options.LOG.inform("write files index");
+        
+        File.write(Options.target + "/files."+Options.publishExt, 
             fileindexTemplate.process(allFiles)
         );
         
     },
-
+    /**
+     * JSON files are lookup files for the documentation
+     * - can be used by IDE's or AJAX based doc tools
+     * 
+     * 
+     */
     publishJSON : function(file, data)
     {
         // what we need to output to be usefull...