X-Git-Url: http://git.roojs.org/?p=gnome.introspection-doc-generator;a=blobdiff_plain;f=JSDOC%2FBuildDocs.js;h=8c8552e39bd43923087604ce4316791c25743863;hp=8b83273e4a977005f64ecf3cc7cc0856333ef7f4;hb=HEAD;hpb=b28d3b2ac4880f6fd9d2aefda6e89181bb621361 diff --git a/JSDOC/BuildDocs.js b/JSDOC/BuildDocs.js index 8b83273..8c8552e 100644 --- a/JSDOC/BuildDocs.js +++ b/JSDOC/BuildDocs.js @@ -83,7 +83,10 @@ BuildDocs = { for (var i = 0; i < Options.src.length; i++) { // add to sourcefiles.. - + if (!File.isDirectory(Options.src[i])) { + _this.srcFiles.push(Options.src[i]); + continue; + } File.list(Options.src[i] ).forEach(function($) { if (Options['exclude-src'].indexOf($) > -1) { return; @@ -122,22 +125,37 @@ BuildDocs = { if (cacheFile && File.exists(cacheFile)) { // check filetime? - var c_mt = File.getTimes(cacheFile); - var o_mt = File.getTimes(srcFile); + var c_mt = File.mtime(cacheFile); + var o_mt = File.mtime(srcFile); //println(c_mt.toSource()); // println(o_mt.toSource()); // this check does not appear to work according to the doc's - need to check it out. - if (c_mt[0] > o_mt[0]) { // cached time > original time! + if (c_mt > o_mt) { // cached time > original time! // use the cached mtimes.. - var syms = JSON.parse(File.read(cacheFile)); - - throw "Conversion of cache not done yet!"; - - for (var sy in syms) { - //println("ADD:" + sy ); - Parser.symbols.addSymbol(syms[sy]); + print("Read " + cacheFile); + var syms = JSON.parse(File.read(cacheFile), function(k, v) { + //print(k); + if (typeof(v) != 'object') { + return v; + } + if (typeof(v['*object']) == 'undefined') { + return v; + } + var cls = imports[v['*object']][v['*object']]; + //print(v['*object']); + delete v['*object']; + var ret = new cls(); + XObject.extend(ret, v); + return ret; + + + }); + //print("Add sybmols " + cacheFile); + for (var sy in syms._index) { + // print("ADD:" + sy ); + Parser.symbols.addSymbol(syms._index[sy]); } continue; } @@ -161,6 +179,15 @@ BuildDocs = { Parser.parse(ts, srcFile); + if (cacheFile) { + File.write(cacheFile, + JSON.stringify( + Parser.symbolsToObject(srcFile), + null,2 + ) + ); + + } //var outstr = JSON.stringify( // Parser.filesSymbols[srcFile]._index //); @@ -238,8 +265,8 @@ BuildDocs = { function isaFile($) { return ($.is("FILE")) } - function isaClass($) { - return ($.is("CONSTRUCTOR") || $.isNamespace); + function isaClass($) { + return ($.is("CONSTRUCTOR") || $.isNamespace || $.isClass); } @@ -260,6 +287,7 @@ BuildDocs = { var targetDir = Options.target + "/symbols/src/"; this.makeSrcFile(file, targetDir); } + //print(JSON.stringify(symbols,null,4)); var classes = symbols.filter(isaClass).sort(makeSortby("alias")); @@ -358,12 +386,17 @@ BuildDocs = { var p =''; for(var i =0; i < cfgProperties.length;i++) { p = cfgProperties[i]; - props.push( { + var add = { name : p.name, type : p.type, desc : p.desc, + memberOf : p.memberOf == data.alias ? '' : p.memberOf - }); + } + if (p.optvalues) { + add.optvals = p.optvalues; + } + props.push(add ); } @@ -383,6 +416,24 @@ BuildDocs = { desc : m.desc }); } + + var ownMethods = data.methods.filter( function(e){ + return !e.isEvent && !e.comment.getTag('hide').length; + }).sort(makeSortby("name")); + + + var methods = []; + + for(var i =0; i < ownMethods.length;i++) { + m = ownMethods[i]; + methods.push( { + name : m.name, + sig : this.makeMethodSkel(m.params), + type : 'function', + desc : m.desc + }); + } + //println(props.toSource()); // we need to output: //classname => { @@ -393,7 +444,8 @@ BuildDocs = { var ret = { props : props, - events: events + events: events, + methods : methods, }; return ret; @@ -445,8 +497,17 @@ BuildDocs = { } ).map( function($) { return $.name == 'this' ? '_self' : $.name; } ).join(", ") + ")\n{\n\n}"; + }, + makeMethodSkel :function(params) { + if (!params) return "()"; + return "(" + + params.filter( + function($) { + return $.name.indexOf(".") == -1; // don't show config params in signature + } + ).map( function($) { return $.type + " " +( $.name == 'this' ? '_self' : $.name ); } ).join(", ") + + ")"; } - };