sbin/res/jsdoc/app/lib/JSDOC/JsDoc.js
changeset 1072 ac1eacb3aa33
parent 1071 02c04d2c8fd8
child 1073 687133dc13cf
--- a/sbin/res/jsdoc/app/lib/JSDOC/JsDoc.js	Sun Nov 12 22:07:33 2017 +0100
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,140 +0,0 @@
-/**
-	@constructor
-	@param [opt] Used to override the commandline options. Useful for testing.
-	@version $Id: JsDoc.js 831 2010-03-09 14:24:56Z micmath $
-*/
-JSDOC.JsDoc = function(/**object*/ opt) {
-	if (opt) {
-		JSDOC.opt = opt;
-	}
-	
-	if (JSDOC.opt.h) {
-		JSDOC.usage();
-		quit();
-	}
-	
-	// defend against options that are not sane 
-	if (JSDOC.opt._.length == 0) {
-		LOG.warn("No source files to work on. Nothing to do.");
-		quit();
-	}
-	if (JSDOC.opt.t === true || JSDOC.opt.d === true) {
-		JSDOC.usage();
-	}
-	
-	if (typeof JSDOC.opt.d == "string") {
-		if (!JSDOC.opt.d.charAt(JSDOC.opt.d.length-1).match(/[\\\/]/)) {
-			JSDOC.opt.d = JSDOC.opt.d+"/";
-		}
-		LOG.inform("Output directory set to '"+JSDOC.opt.d+"'.");
-		IO.mkPath(JSDOC.opt.d);
-	}
-	if (JSDOC.opt.e) IO.setEncoding(JSDOC.opt.e);
-	
-	// the -r option: scan source directories recursively
-	if (typeof JSDOC.opt.r == "boolean") JSDOC.opt.r = 10;
-	else if (!isNaN(parseInt(JSDOC.opt.r))) JSDOC.opt.r = parseInt(JSDOC.opt.r);
-	else JSDOC.opt.r = 1;
-	
-	// the -D option: define user variables
-	var D = {};
-	if (JSDOC.opt.D) {
-		for (var i = 0; i < JSDOC.opt.D.length; i++) {
-			var param = JSDOC.opt.D[i];
-			// remove first and last character if both == "
-			if ( 
-				param.length > 1
-				&& param.charAt(0) == '"'
-				&& param.charAt(param.length-1) == '"'
-			) {
-				param = param.substr(1, param.length-2);
-			}
-			var defineParts = param.split(":");
-			if (defineParts && defineParts.length > 1) {
-				for ( var dpIdx = 2; dpIdx < defineParts.length; dpIdx++ ) {
-					defineParts[1] += ':' + defineParts[dpIdx];
-				}
-				D[defineParts[0]] = defineParts[1];
-			}
-		}
-	}
-	JSDOC.opt.D = D;
-	// combine any conf file D options with the commandline D options
-	if (defined(JSDOC.conf)) for (var c in JSDOC.conf.D) {
- 		if (!defined(JSDOC.opt.D[c])) {
- 			JSDOC.opt.D[c] = JSDOC.conf.D[c];
- 		}
- 	}
-	
-	// Give plugins a chance to initialize
-	if (defined(JSDOC.PluginManager)) {
-		JSDOC.PluginManager.run("onInit", JSDOC.opt);
-	}
-
-	JSDOC.opt.srcFiles = JSDOC.JsDoc._getSrcFiles();
-	JSDOC.JsDoc._parseSrcFiles();
-	JSDOC.JsDoc.symbolSet = JSDOC.Parser.symbols;
-}
-
-/**
-	Retrieve source file list.
-	@returns {String[]} The pathnames of the files to be parsed.
- */
-JSDOC.JsDoc._getSrcFiles = function() {
-	JSDOC.JsDoc.srcFiles = [];
-	
-	var ext = ["js"];
-	if (JSDOC.opt.x) {
-		ext = JSDOC.opt.x.split(",").map(function($) {return $.toLowerCase()});
-	}
-	
-	for (var i = 0; i < JSDOC.opt._.length; i++) {
-		JSDOC.JsDoc.srcFiles = JSDOC.JsDoc.srcFiles.concat(
-			IO.ls(JSDOC.opt._[i], JSDOC.opt.r).filter(
-				function($) {
-					var thisExt = $.split(".").pop().toLowerCase();
-					
-					if (JSDOC.opt.E) {
-						for(var n = 0; n < JSDOC.opt.E.length; n++) {
-							if ($.match(new RegExp(JSDOC.opt.E[n]))) {
-								LOG.inform("Excluding " + $);
-								return false; // if the file matches the regex then it's excluded.
-							}
-						}
-					}
-					
-					return (ext.indexOf(thisExt) > -1); // we're only interested in files with certain extensions
-				}
-			)
-		);
-	}
-	
-	return JSDOC.JsDoc.srcFiles;
-}
-
-JSDOC.JsDoc._parseSrcFiles = function() {
-	JSDOC.Parser.init();
-	for (var i = 0, l = JSDOC.JsDoc.srcFiles.length; i < l; i++) {
-		var srcFile = JSDOC.JsDoc.srcFiles[i];
-		
-		if (JSDOC.opt.v) LOG.inform("Parsing file: " + srcFile);
-		
-		try {
-			var src = IO.readFile(srcFile);
-		}
-		catch(e) {
-			LOG.warn("Can't read source file '"+srcFile+"': "+e.message);
-		}
-
-		var tr = new JSDOC.TokenReader();
-		var ts = new JSDOC.TokenStream(tr.tokenize(new JSDOC.TextStream(src)));
-
-		JSDOC.Parser.parse(ts, srcFile);
-
-	}
-	JSDOC.Parser.finish();
-
-	if (JSDOC.PluginManager) {
-		JSDOC.PluginManager.run("onFinishedParsing", JSDOC.Parser.symbols);
-	}
-}