初始化

康凯

2022-05-20 aa4c235a8ca67ea8b731f90c951a465e92c0a865

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
/**
 * @version $Id: main.js 818 2009-11-08 14:51:41Z micmath $
 */
 
function main() {
    IO.include("lib/JSDOC.js");
    IO.includeDir("plugins/");
    
    // process the options
    
    // the -c option: options are defined in a configuration file
    if (JSDOC.opt.c) {
        eval("JSDOC.conf = " + IO.readFile(JSDOC.opt.c));
        
        LOG.inform("Using configuration file at '"+JSDOC.opt.c+"'.");
        
        for (var c in JSDOC.conf) {
            if (c !== "D" && !defined(JSDOC.opt[c])) { // commandline overrules config file
                JSDOC.opt[c] = JSDOC.conf[c];
            }
        }
        
        if (typeof JSDOC.conf["_"] != "undefined") {
            JSDOC.opt["_"] = JSDOC.opt["_"].concat(JSDOC.conf["_"]);
        }
        
        LOG.inform("With configuration: ");
        for (var o in JSDOC.opt) {
            LOG.inform("    "+o+": "+JSDOC.opt[o]);
        }
    }
    
    // be verbose
    if (JSDOC.opt.v) LOG.verbose = true;
    
    // send log messages to a file
    if (JSDOC.opt.o) LOG.out = IO.open(JSDOC.opt.o);
    
    // run the unit tests
    if (JSDOC.opt.T) {
        LOG.inform("JsDoc Toolkit running in test mode at "+new Date()+".");
        IO.include("frame/Testrun.js");
        IO.include("test.js");
    }
    else {
        // a template must be defined and must be a directory path
        if (!JSDOC.opt.t && System.getProperty("jsdoc.template.dir")) {
            JSDOC.opt.t = System.getProperty("jsdoc.template.dir");
        }
        if (JSDOC.opt.t && SYS.slash != JSDOC.opt.t.slice(-1)) {
            JSDOC.opt.t += SYS.slash;
        }
        
        // verbose messages about the options we were given
        LOG.inform("JsDoc Toolkit main() running at "+new Date()+".");
        LOG.inform("With options: ");
        for (var o in JSDOC.opt) {
            LOG.inform("    "+o+": "+JSDOC.opt[o]);
        }
        
        // initialize and build a symbolSet from your code
        JSDOC.JsDoc();
        
        // debugger's option: dump the entire symbolSet produced from your code
        if (JSDOC.opt.Z) {
            LOG.warn("So you want to see the data structure, eh? This might hang if you have circular refs...");
            IO.include("frame/Dumper.js");
            var symbols = JSDOC.JsDoc.symbolSet.toArray();
            for (var i = 0, l = symbols.length; i < l; i++) {
                var symbol = symbols[i];
                print("// symbol: " + symbol.alias);
                print(symbol.serialize());
            }
        }
        else {
            if (typeof JSDOC.opt.t != "undefined") {
                try {
                    // a file named "publish.js" must exist in the template directory
                    load(JSDOC.opt.t+"publish.js");
                    
                    // and must define a function named "publish"
                    if (!publish) {
                        LOG.warn("No publish() function is defined in that template so nothing to do.");
                    }
                    else {
                        // which will be called with the symbolSet produced from your code
                        publish(JSDOC.JsDoc.symbolSet);
                    }
                }
                catch(e) {
                    LOG.warn("Sorry, that doesn't seem to be a valid template: "+JSDOC.opt.t+"publish.js : "+e);
                }
            }
            else {
                LOG.warn("No template given. Might as well read the usage notes.");
                JSDOC.usage();
            }
        }
    }
    
    // notify of any warnings
    if (!JSDOC.opt.q && LOG.warnings.length) {
        print(LOG.warnings.length+" warning"+(LOG.warnings.length != 1? "s":"")+".");
    }
    
    // stop sending log messages to a file
    if (LOG.out) {
        LOG.out.flush();
        LOG.out.close();
    }
}