Installing JSDoc on Windows
The JSDoc tool is a perl script, which could be a problem in a Windows environment where perl is not part of the standard like in UNIX. Thus, in order to execute JSDoc you have to install a perl interpreter. JSDoc documentation recommends ActivePerl for Windows users. ActivePerl is an ActiveState’s quality-assured binary build of Perl, available for AIX, Linux, Mac OS X, Solaris and Windows . As part of ActiveState's support for Perl, ActiveState provides the ActivePerl binary packages free to the community. You can start directly with the customized installation for windows. Download the latest version of ActivePerl from http://www.activestate.com. Windows package ActivePerl-5.8.8.820-MSWin32-x86-274739.zip.
Next uncompressed the archive and point the installer to C:\perl, and answer "y" to the question "Add the Perl\bin directory to the PATH? [y]". After installing ActivePerl, in order to validate the installation and to make sure that the path to Perl was set in your environment, open a console window (Start->Run->'cmd') and type
perl –v.This should print the Perl version information.
Once Perl is installed now download JSDoc package. The latest realize can be found at http://www.sourceforge.net/projects/jsdoc. Download the archive with the tgz extension Jsdoc-1.10.1.tgz and simply uncompress it somewhere, for example C:\JSDoc. JSDoc comes with a javascript example "test.js" that shows how to use the syntax. By going into the JSDoc directory and entering the command "perl jsdoc.pl test.js", it will give a set of HTML files in a directory called js_docs_out. However, one library that JSDoc requires and doesn't come with the default ActivePerl install is HTML-Templates.
Next execute the command C:\ppm. The command will open the GUI interface and display a list of all available packages. Perl Package Manager is a graphical user interface that can manage different installation areas for ActivePerl . Click on the button that reads "View All Packages", and it will display a complete list of packages. Find the HTML-Template packages and install. ActivePerl will be now setup to run JSDoc properly.