projects
/
gnome.introspection-doc-generator
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
JSDOC/BuildDocs.js
[gnome.introspection-doc-generator]
/
JSDOC
/
BuildDocs.js
diff --git
a/JSDOC/BuildDocs.js
b/JSDOC/BuildDocs.js
index
314c4cc
..
3a6529b
100644
(file)
--- 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!??
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;
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...??
/****************** 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 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));
var ts = new TokenStream(tr.tokenize(txs));
@@
-250,22
+252,26
@@
BuildDocs = {
var classes = symbols.filter(isaClass).sort(makeSortby("alias"));
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 = "";
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));
File.write(Options.target+"/symbols/" +symbol.alias+'.' + Options.publishExt ,
classTemplate.process(symbol));
- print("write " + Options.target+"/symbols/" +symbol.alias+'.' + Options.publishExt);
+
// dump out a
// 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 = "";
// 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)
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++) {
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++) {
}
for (var i = 0; i < documentedFiles.length; i++) {
@@
-301,12
+307,19
@@
BuildDocs = {
}
allFiles = allFiles.sort(makeSortby("name"));
}
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)
);
},
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...
publishJSON : function(file, data)
{
// what we need to output to be usefull...
@@
-369,6
+382,8
@@
BuildDocs = {
},
makeSrcFile: function(sourceFile)
{
},
makeSrcFile: function(sourceFile)
{
+ // this stuff works...
+ return;
name = sourceFile.substring(Options.baseDir.length+1);
name = sourceFile.substring(Options.baseDir.length+1);