New to JSDuck? Watch introductory talk by Nick Poulden:
Standard rubygems install should do:
$ [sudo] gem install jsduck
For the simplest test-run just use the
--builtin-classes option to
and Object into
$ jsduck --builtin-classes --output docs
To generate docs for Ext JS 4 add path to the corresponding src/ dir:
$ jsduck ext-4.2.1/src --output docs
And to create docs for your own Ext JS project, list the directory with your files in addition to the Ext JS source files (this way the docs of your classes will list all the properties and methods they inherit from Ext JS classes):
$ jsduck ext-4.2.1/src my-project/js --output docs
Unfortunately the above will throw lots of warnings at you, as building the full Ext JS docs requires lots of additional settings. For start you might want to simply ignore all these warnings originating from Ext JS source:
$ jsduck ext-4.2.1/src my-project/js --output docs \ --warnings=-all:ext-4.2.1/src
But see the Usage guide for more information on building Ext JS 4 docs.
Documenting your code
See Hacking guide in wiki.
Who's using JSDuck?
- Appcelerator Titanium SDK
- AT&T API Platform SDK for HTML5
- Bryntum Siesta unit testing framework
- GeoExt 2
- Rally Software Rally App SDK
- Sencha - obviously :)
These are some that we know of. Want your project listed here? Drop us a line.
JSDuck is distributed under the terms of the GNU General Public License version 3.
Thanks to Ondřej Jirman, Thomas Aylott, johnnywengluu, gevik, ligaard, Bill Hubbard, Ed Spencer, atian25, Katherine Chu, Rob Dougan, Dave Thompson, burnnat, vjetteam, Chris Westbrook, Scott Whittaker, Timo Tijhof, and many-many others who reported bugs, submitted patches, and provided a lot of useful input.
See Changelog page in wiki.