Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
An automatic documentation generator for JavaScript.
JavaScript
branch: master

This branch is 1362 commits behind jsdoc3:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
Jake
lib
node_modules
plugins
rhino_modules
templates
test
.gitignore
Jakefile.js
LICENSE.md
README.md
changes.md
conf.json
jsdoc
jsdoc.js
package.json

README.md

JSDoc 3

An inline API documentation processor for JavaScript. JSDoc 3 is intended to be an upgrade to JsDoc Toolkit (JSDoc 2).

Notice

This is pre-release software! It is under active development, not complete and is not suitable for reqular use yet.

Installation

Download a copy of JSDoc 3 from the official Git Hub repository here: https://github.com/micmath/jsdoc

To test that jsdoc is working, change your working directory to the jsdoc folder and run the following command:

java -cp lib/js.jar org.mozilla.javascript.tools.shell.Main jsdoc.js -T

If you are operating on a Mac OSX or *nix platform, you can shorten that command to this:

./jsdoc -T

Usage

This example assumes that your working directory is the jsdoc application base directory:

./jsdoc yourSourceCodeFile.js

For help regarding the supported commandline options use the --help option.

./jsdoc --help

Generated documentation will appear in the folder specified by the --destination option, or in a folder named "out" by default.

Dependencies

JSDoc 3 utilises 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 the Rhino application which are only available in or after the 1.7 release 3. A copy of this version of Rhino is included in JSDoc so this is not normally an issue that the user needs to be concerned with. However, in rare cases, users may have their Java CLASSPATH configured to override that included Rhino and point to some older version of Rhino instead. If this is the case, simply correct the CLASSPATH to remove the older Rhino.

Debugging

Rhino is not always very friendly when it comes to reporting errors in JavaScript. Luckily it comes with a full-on debugger included that can be much more useful than a simple stack trace. To invoke JSDoc with the debugger try the following command:

$ java -classpath js.jar \
org.mozilla.javascript.tools.debugger.Main jsdoc.js \
your/script.js

This will open a debugging window. Choose "Break on Exceptions" from the "Debug" menu, then press the "Run" button. If there is an error, you should see exactly where it is in the source code.

See Also

Project Documentation: http://usejsdoc.org/ (under development) JSDoc User's Group: http://groups.google.com/group/jsdoc-users Subversion Mirror: http://code.google.com/p/jsdoc/source Project Annoncements: http://twitter.com/jsdoc3

License

JSDoc 3 is copyright (c) 2011 Michael Mathews micmath@gmail.com

See file "LICENSE.md" in this distribution for more details about terms of use.

Something went wrong with that request. Please try again.