后来发现这样的文档很不方便查看, 且又听我们BOSS说phper能生成他们的文档, 我在想js会不会也有一个呢, 于是...你懂的... 通过@广州♂lxrmido 知道了 jsdoc, 于是 github上down下来; 附地址: https://g*ithub.*c*om/jsdoc3/jsdoc
他可以让你的js生成HTML文档,如:
	  
		| 代码如下 | 复制代码 | 
	  
		| /*** 打开新窗口
 * @param {string} [url] 连接
 * @param {object} [options] 配置参数
 * @return {object} msc对象
 * @example
 * 1, msc.open("/");
 * 2, msc.open("/",{
 * width:1000,
 * height:300
 * });
 */ www.111com.net
 function open(url, options) {
 var str = "";
 if (options) {
 options.height = options.height || 420;
 options.width = options.width || 550;
 options.left = options.left || ((screen.width - options.width) / 2); //默认为居中
 options.top = options.top || ((screen.height - options.height) / 2); //默认为居中
         for (var i in options) {str += ',' + i + '=' + options[i];
 }
 str = str.substr(1);
 };
 window.open(url, 'connect_window_' + (+new Date), str);
 str = null;
 return msc;
 };
 | 
	
使用 jsdoc 后可以解析成,文件,方法名,参数,例子,返回值作者等等信息,且有目录索引和源码..相当赞.如图:

且这只是她功能的冰山一角, 更多功能有待你的挖掘, 我也是刚刚知道, 不敢独藏, 于是分享!
注: 有什么问题可以回复啊, 大家一起研究/讨论
我是用node中的cnpm(npm大家都懂的)安装下
cnpm install jsdoc -g
然后用cmd进行需要的目录, 直接
jsdoc xl.js
//jsdoc 目录名
运行, 她会在同目录生成 out 文件夹, 然后你就打开吧. 注: 你的注释必须按标准走, 我用的sublime里的DocBlockr加的 ps:标准的注释会使我们以后的工作更帅气 更多参数说明请看 github, 或者 官网 http://*usejsdo*c*.org/