初始化

康凯

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
/**
    @overview
    @date $Date: 2010-06-13 22:02:44 +0100 (Sun, 13 Jun 2010) $
    @version $Revision: 837 $ 
    @location $HeadURL: https://jsdoc-toolkit.googlecode.com/svn/tags/jsdoc_toolkit-2.4.0/jsdoc-toolkit/app/lib/JSDOC.js $
    @name JSDOC.js
 */
 
/**
    This is the main container for the JSDOC application.
    @namespace
*/
JSDOC = {
};
 
/**
    @requires Opt
 */
if (typeof arguments == "undefined") arguments = [];
JSDOC.opt = Opt.get(
    arguments, 
    {
        a: "allfunctions", 
        c: "conf",
        d: "directory",
        "D[]": "define",
        e: "encoding",
        "E[]": "exclude",
        h: "help",
        m: "multiple",
        n: "nocode",
        o: "out",
        p: "private",
        q: "quiet",
        r: "recurse",
        S: "securemodules",
        s: "suppress",
        t: "template",
        T: "testmode",
        u: "unique",
        v: "verbose",
        x: "ext"
    }
);
 
/** The current version string of this application. */
JSDOC.VERSION = "2.4.0";
 
/** Print out usage information and quit. */
JSDOC.usage = function() {
    print("USAGE: java -jar jsrun.jar app/run.js [OPTIONS] <SRC_DIR> <SRC_FILE> ...");
    print("");
    print("OPTIONS:");
    print("  -a or --allfunctions\n          Include all functions, even undocumented ones.\n");
    print("  -c or --conf\n          Load a configuration file.\n");
    print("  -d=<PATH> or --directory=<PATH>\n          Output to this directory (defaults to \"out\").\n");
    print("  -D=\"myVar:My value\" or --define=\"myVar:My value\"\n          Multiple. Define a variable, available in JsDoc as JSDOC.opt.D.myVar.\n");
    print("  -e=<ENCODING> or --encoding=<ENCODING>\n          Use this encoding to read and write files.\n");
    print("  -E=\"REGEX\" or --exclude=\"REGEX\"\n          Multiple. Exclude files based on the supplied regex.\n");
    print("  -h or --help\n          Show this message and exit.\n");
    print("  -m or --multiples\n          Don't warn about symbols being documented more than once.\n");
    print("  -n or --nocode\n          Ignore all code, only document comments with @name tags.\n");
    print("  -o=<PATH> or --out=<PATH>\n          Print log messages to a file (defaults to stdout).\n");
    print("  -p or --private\n          Include symbols tagged as private, underscored and inner symbols.\n");
    print("  -q or --quiet\n          Do not output any messages, not even warnings.\n");
    print("  -r=<DEPTH> or --recurse=<DEPTH>\n          Descend into src directories.\n");
    print("  -s or --suppress\n          Suppress source code output.\n");
    print("  -S or --securemodules\n          Use Secure Modules mode to parse source code.\n");
    print("  -t=<PATH> or --template=<PATH>\n          Required. Use this template to format the output.\n");
    print("  -T or --test\n          Run all unit tests and exit.\n");
    print("  -u or --unique\n          Force file names to be unique, but not based on symbol names.\n");
    print("  -v or --verbose\n          Provide verbose feedback about what is happening.\n");
    print("  -x=<EXT>[,EXT]... or --ext=<EXT>[,EXT]...\n          Scan source files with the given extension/s (defaults to js).\n");
    
    quit();
}
 
/*t:
    plan(4, "Testing JSDOC namespace.");
    
    is(
        typeof JSDOC,
        "object",
        "JSDOC.usage is a function."
    );
    
    is(
        typeof JSDOC.VERSION,
        "string",
        "JSDOC.VERSION is a string."
    );
    
    is(
        typeof JSDOC.usage,
        "function",
        "JSDOC.usage is a function."
    );
    
    is(
        typeof JSDOC.opt,
        "object",
        "JSDOC.opt is a object."
    );
 */
 
if (this.IO) IO.includeDir("lib/JSDOC/");