| OLD | NEW |
| 1 // This is a complex script used for producing doxygen-readable input | 1 // This is a complex script used for producing doxygen-readable input |
| 2 | 2 |
| 3 /* The following is a sample doxygen input file: | 3 /* The following is a sample doxygen input file: |
| 4 FILE doxygen.js | 4 FILE doxygen.js |
| 5 // Documentation for thing | 5 // Documentation for thing |
| 6 0:0 VARIABLE variable1 | 6 0:0 VARIABLE variable1 |
| 7 // More documentation | 7 // More documentation |
| 8 1:0 FUNCTION function ARGS a b c | 8 1:0 FUNCTION function ARGS a b c |
| 9 // Yet more documentation | 9 // Yet more documentation |
| 10 25:0 CLASS clazz INHERITS base1 base2 | 10 25:0 CLASS clazz INHERITS base1 base2 |
| 11 40:2 CLASS VARIABLE clazzvar | 11 40:2 CLASS VARIABLE clazzvar |
| 12 41:2 CLASS METHOD clazzfunc ARGS | 12 41:2 CLASS METHOD clazzfunc ARGS |
| 13 52:2 CLASS GETTER vara ARGS | 13 52:2 CLASS GETTER vara ARGS |
| 14 // Some Constant | 14 // Some Constant |
| 15 101:0 CONSTANT const1 VALUE 10 | 15 101:0 CONSTANT const1 VALUE 10 |
| 16 */ | 16 */ |
| 17 | 17 |
| 18 include("../utils/dumpast.js"); | 18 include("../utils/dumpast.js"); |
| 19 include("../utils/cleanast.js"); | 19 include("../utils/cleanast.js"); |
| 20 include("../utils/comments.js"); | 20 include("../utils/comments.js"); |
| 21 include("../utils/jstypes.js"); | 21 include("../utils/jstypes.js"); |
| 22 | 22 |
| 23 function process_js(ast, f) { | 23 function process_js(ast, f) { |
| 24 _print("FILE " + f); | 24 _print("FILE " + f); |
| 25 function loc(l) { | 25 function loc(l) { |
| 26 return l.line + ":" + l.column; | 26 return l.line + ":" + l.column; |
| 27 } | 27 } |
| 28 let toplevel = clean_ast(ast); | 28 let toplevel = clean_ast(ast); |
| 29 associate_comments(f, toplevel); | 29 associate_comments(f, toplevel); |
| 30 for each (let v in toplevel.variables) { | 30 for (let v of toplevel.variables) { |
| 31 if (v.comment) | 31 if (v.comment) |
| 32 _print(v.comment); | 32 _print(v.comment); |
| 33 _print(loc(v.loc) + " VARIABLE " + v.name); | 33 _print(loc(v.loc) + " VARIABLE " + v.name); |
| 34 } | 34 } |
| 35 for each (let v in toplevel.constants) { | 35 for (let v of toplevel.constants) { |
| 36 if (v.comment) | 36 if (v.comment) |
| 37 _print(v.comment); | 37 _print(v.comment); |
| 38 _print(loc(v.loc) + " CONST " + v.name); | 38 _print(loc(v.loc) + " CONST " + v.name); |
| 39 } | 39 } |
| 40 for each (let v in toplevel.objects) { | 40 for (let v of toplevel.objects) { |
| 41 divine_inheritance(v, toplevel.constants); | 41 divine_inheritance(v, toplevel.constants); |
| 42 if (v.comment) | 42 if (v.comment) |
| 43 _print(v.comment); | 43 _print(v.comment); |
| 44 let inherits = v.inherits ? (" INHERITS " + v.inherits.join(", ")) : ""; | 44 let inherits = v.inherits ? (" INHERITS " + v.inherits.join(", ")) : ""; |
| 45 _print(loc(v.loc) + " CLASS " + v.name + inherits); | 45 _print(loc(v.loc) + " CLASS " + v.name + inherits); |
| 46 let attrs = { METHOD: v.functions, VARIABLE: v.variables, GETTER: v.getters, | 46 let attrs = { METHOD: v.functions, VARIABLE: v.variables, GETTER: v.getters, |
| 47 SETTER: v.setters }; | 47 SETTER: v.setters }; |
| 48 for (let attr in attrs) { | 48 for (let attr in attrs) { |
| 49 for (let name in attrs[attr]) { | 49 for (let name in attrs[attr]) { |
| 50 if (attrs[attr][name].comment) | 50 if (attrs[attr][name].comment) |
| 51 _print(attrs[attr][name].comment); | 51 _print(attrs[attr][name].comment); |
| 52 _print(loc(attrs[attr][name].loc) + " CLASS " + attr + " " + name); | 52 _print(loc(attrs[attr][name].loc) + " CLASS " + attr + " " + name); |
| 53 } | 53 } |
| 54 } | 54 } |
| 55 _print("CLASS END"); | 55 _print("CLASS END"); |
| 56 } | 56 } |
| 57 for each (let v in toplevel.classes) { | 57 for (let v of toplevel.classes) { |
| 58 divine_inheritance(v, toplevel.constants); | 58 divine_inheritance(v, toplevel.constants); |
| 59 if (v.constructor && v.constructor.comment) | 59 if (v.constructor && v.constructor.comment) |
| 60 _print(v.constructor.comment); | 60 _print(v.constructor.comment); |
| 61 if (v.comment) | 61 if (v.comment) |
| 62 _print(v.comment); | 62 _print(v.comment); |
| 63 let inherits = v.inherits ? (" INHERITS " + v.inherits.join(", ")) : ""; | 63 let inherits = v.inherits ? (" INHERITS " + v.inherits.join(", ")) : ""; |
| 64 _print(loc(v.loc) + " CLASS " + v.name + inherits); | 64 _print(loc(v.loc) + " CLASS " + v.name + inherits); |
| 65 let attrs = { METHOD: v.functions, VARIABLE: v.variables, GETTER: v.getters, | 65 let attrs = { METHOD: v.functions, VARIABLE: v.variables, GETTER: v.getters, |
| 66 SETTER: v.setters }; | 66 SETTER: v.setters }; |
| 67 for (let attr in attrs) { | 67 for (let attr in attrs) { |
| 68 for (let name in attrs[attr]) { | 68 for (let name in attrs[attr]) { |
| 69 if (attrs[attr][name].comment) | 69 if (attrs[attr][name].comment) |
| 70 _print(attrs[attr][name].comment); | 70 _print(attrs[attr][name].comment); |
| 71 _print(loc(attrs[attr][name].loc) + " CLASS " + attr + " " + name); | 71 _print(loc(attrs[attr][name].loc) + " CLASS " + attr + " " + name); |
| 72 } | 72 } |
| 73 } | 73 } |
| 74 _print("CLASS END"); | 74 _print("CLASS END"); |
| 75 } | 75 } |
| 76 for each (let v in toplevel.functions) { | 76 for (let v of toplevel.functions) { |
| 77 if (v.comment) | 77 if (v.comment) |
| 78 _print(v.comment); | 78 _print(v.comment); |
| 79 _print(loc(v.loc) + " FUNCTION " + v.name); | 79 _print(loc(v.loc) + " FUNCTION " + v.name); |
| 80 } | 80 } |
| 81 } | 81 } |
| OLD | NEW |