wts的专栏

原文章：《JavaScript世界的一等公民 - 函数》http://software.intel.com/zh-cn/articles/javascript-first-class-citizen-function/?cid=sw:prccsdn229032 其中2.3节非常清晰明了的解释了闭包。以前从其他文章看到的解释都不是很明了，看了2.3节终于明白了。摘录如下：2.

jsdoc3官方网站：https://github.com/jsdoc3/jsdoc/我使用的时候，从首页上通过“Download Zip ”直接下载到的是3.3.0 alpha4版本，解压后配置好path，结果使用jsdoc命令的时候，遇到错误：js: exception from uncaught JavaScript throw: Error: Module "C:\abc\jsdo

官方网站：https://github.com/jsdoc3/jsdoc/建议不要直接通过“Download ZIP”功能直接下载，而是到Release中下载稳定版本，比如3.2.2下载后，直接解压到某个目录，比如d:\jsdoc然后设置windows环境变量，在path中增加d:\jsdoc，这样我们在那个目录下，都可以执行jsdoc命令了。假设要对d:\js\myjs.js生成

JSDoc3默认提供了两个模板，默认的模板生成的doc还是比较难看的，另外一个haruki只提供命令行状态下的json输出，不是我们要的。网络上搜了一下，找到Docstrap，提供多种模板效果，还不错。1、JSDoc3JSDoc3这里不说了，下载和配置，见《JSDoc3的简单使用》。2、Docstrap官方开源地址：https://github.com/terryweiss/d

这几天需要对开发的js文件生成doc，简单了解了一下，直接选用了JSDoc3，但JSDoc3默认生成的doc比较难看。于是就再看看其它的生成软件。看了一篇写的不错的文章，对JSDoc、Doxx、YUIDoc、Docoo做了对比，地址：http://blog.fusioncharts.com/2013/12/jsdoc-vs-yuidoc-vs-doxx-vs-docco-choosing-a-

默认生成的JSDoc3文档只有类和方法的导航。我前面文档提到如何为index.html增加内容描述。但当我们从导航菜单切换到具体某个类的doc时，再想切换会index首页，默认生成doc中没有这样的能力。其实JSDoc3现在的版本（3.2.2）确实没有这个功能，但我们可以通过JSDoc3提供的Tutorials功能，折中实现这个功能。JSDoc3的Tutorials本意是，让使用者提供

之前简单介绍了如何用JSDoc3以及JSDoc3+Docstrap生成jsdoc。但生成的文档首页Index.html都是一片空白，我们可能需要在这里增加一些说明性的文字。JSDoc的自定义能力确实很强，我们增加一个readme.md这样的markdown格式的文件就可以了。比如我的js文件位于：d:\myjs\，要生成的jsdoc放在d:\mydoc。我们首先可以在任意位置创建一