X-Git-Url: http://git.roojs.org/?p=gnome.introspection-doc-generator;a=blobdiff_plain;f=JSDOC%2FBuildDocs.js;h=3a6529b1bb5adc3f5775ebac3438995f84d3261b;hp=314c4cc450d67ec4606071d1182147f8dcccacfa;hb=a67931117fc1f532da5016752f7dd3c625ce25d3;hpb=5d17f323c0f7c5204dc218917b4261415dcc60d5 diff --git a/JSDOC/BuildDocs.js b/JSDOC/BuildDocs.js index 314c4cc..3a6529b 100644 --- a/JSDOC/BuildDocs.js +++ b/JSDOC/BuildDocs.js @@ -11,11 +11,13 @@ File = imports.File.File; Template = imports.JsTemplate.Template.Template; Link = imports.JsTemplate.Link.Link; // ?? fixme!?? -Parser = imports.Parser.Parser; -TextStream = imports.TextStream.TextStream; +Parser = imports.Parser.Parser; +TextStream = imports.TextStream.TextStream; TokenReader = imports.TokenReader.TokenReader; TokenStream = imports.TokenStream.TokenStream; -Symbol = imports.Symbol.Symbol; +Symbol = imports.Symbol.Symbol; +DocComment = imports.DocComment.DocComment; + /****************** INCLUDES ARE ALL AT THE BOTTOM OF THIS FILE!!!!! *******************/ // should not realy be here -- or anywhere...?? @@ -135,7 +137,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)); @@ -250,22 +252,26 @@ 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]; var output = ""; + Options.LOG.inform("classTemplate Process : " + symbol.alias); + File.write(Options.target+"/symbols/" +symbol.alias+'.' + Options.publishExt , classTemplate.process(symbol)); - print("write " + Options.target+"/symbols/" +symbol.alias+'.' + Options.publishExt); + // dump out a - this.publishJSON(Options.target+"/json/", symbol.alias+'.json', symbol) + this.publishJSON(Options.target+"/json/" + symbol.alias+'.json', symbol) @@ -273,9 +279,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) @@ -292,7 +298,7 @@ BuildDocs = { var allFiles = []; for (var i = 0; i < files.length; i++) { - allFiles.push(new Symbol(files[i], [], "FILE", new JSDOC.DocComment("/** */"))); + allFiles.push(new Symbol(files[i], [], "FILE", new DocComment("/** */"))); } for (var i = 0; i < documentedFiles.length; i++) { @@ -301,12 +307,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... @@ -369,6 +382,8 @@ BuildDocs = { }, makeSrcFile: function(sourceFile) { + // this stuff works... + return; name = sourceFile.substring(Options.baseDir.length+1);