Want to contribute to JSDoc? Please read
Use git to clone the official JSDoc repository:
git clone https://github.com/jsdoc3/jsdoc.git
You can also install JSDoc within a Node.js project's
using npm. To install the latest development version, change directories to your
Node.js project, then run the following command:
npm install git://github.com/jsdoc3/jsdoc.git
Or to install JSDoc globally:
npm install -g git://github.com/jsdoc3/jsdoc.git
Note: Although you can install JSDoc with npm, JSDoc does not currently run on Node.js.
This example assumes that your working directory is the JSDoc application base directory:
For information about the supported command-line options, use the
Generated documentation will appear in the folder specified by the
--destination option, or in a folder named "out" by default.
JSDoc 3 uses the Mozilla Rhino engine, which requires Java. JSDoc 3 is known to work with version 1.6.0_24 of Java.
JSDoc 3 uses advanced features in Mozilla Rhino that are only available in or after version 1.7R3. In addition, JSDoc 3 requires several customizations to the standard Rhino distribution. The customized version of Rhino is included with JSDoc.
In rare cases, users may have their Java CLASSPATH configured to override the
included Rhino and point to an older version of Rhino instead. If this is the
case, simply correct the CLASSPATH to remove the older Rhino. (On OS X, you may
need to remove the file
The version of Rhino distributed with JSDoc 3 can be found here: https://github.com/hegemonic/rhino
Or on OS X, Linux, and other POSIX-compliant systems:
If you can't get the short-form commands to work, try invoking Java directly:
--debug must be the first argument to the short-form command.
This will open a debugging window. Click Debug > Break on Exceptions, then click Run. If there is an error, you should see exactly where it is in the source code.
Project Documentation: http://usejsdoc.org/ (under development)
Project Documentation Source: https://github.com/jsdoc3/jsdoc3.github.com
JSDoc User's Group: http://groups.google.com/group/jsdoc-users
JSDoc 3 Ant Task: https://github.com/jannon/jsdoc3-ant-task
Project Announcements: http://twitter.com/jsdoc3
JSDoc 3 is copyright (c) 2011-2012 Michael Mathews firstname.lastname@example.org.
JSDoc 3 is free software, licensed under the Apache License, Version 2.0. See
LICENSE.md in this distribution for more details.