Remove Rhino support

Author: tschaub

.eslintignore

@@ -1,5 +1,3 @@
-node_modules/*
-rhino/*
 templates/default/static/scripts/*
 test/fixtures/*
 test/lib/*

.npmignore

@@ -4,11 +4,4 @@
 .gitignore
 .travis.yml
 gulpfile.js
-
-# scripts for launching JSDoc with Mozilla Rhino
-/jsdoc*
-!/jsdoc.js
-
-# Rhino and test directories
-rhino/
 test/

LICENSE.md

@@ -145,19 +145,6 @@ Copyright (c) 2011-2015 by the Espree contributors.
 The source code for Esprima is available at:
 https://github.com/eslint/espree
 
-## events ##
-
-Portions of the events source code are incorporated into the following files:
-
-+ `rhino/events.js`
-
-events is distributed under the MIT license, which is reproduced above.
-
-Copyright Joyent, Inc. and other Node contributors. All rights reserved.
-
-The source code for events is available at:
-https://github.com/Gozala/events
-
 ## github-flavored-markdown ##
 
 github-flavored-markdown is distributed under the BSD 3-clause license:
@@ -234,36 +221,6 @@ Copyright (c) 2012 Michael Kourlas.
 The source code for js2xmlparser is available at:
 https://github.com/michaelkourlas/node-js2xmlparser
 
-## Node.js ##
-
-Portions of the Node.js source code are incorporated into the following files:
-
-- `rhino/fs.js`
-- `rhino/path.js`
-- `rhino/querystring.js`
-- `rhino/util.js`
-
-Node.js is distributed under the MIT license, which is reproduced above.
-
-Copyright Joyent, Inc. and other Node contributors. All rights reserved.
-
-The source code for Node.js is available at:
-https://github.com/joyent/node
-
-## node-browser-builtins ##
-
-Portions of the node-browser-builtins source code are incorporated into the
-following files:
-
-- `rhino/assert.js`
-- `rhino/rhino-shim.js`
-
-node-browser-builtins is distributed under the MIT license, which is reproduced
-above.
-
-The source code for node-browser-builtins is available at:
-https://github.com/alexgorbatchev/node-browser-builtins
-
 ## Open Sans ##
 
 Open Sans is distributed under the Apache License 2.0, which is
@@ -284,46 +241,6 @@ Copyright (c) 2012-2013 Johannes Ewald.
 The source code for Requizzle is available at:
 https://github.com/hegemonic/requizzle
 
-## Rhino ##
-
-Rhino is distributed under the following licenses:
-
-### MPL 2.0 License ###
-The majority of the source code for Rhino is available under the Mozilla Public
-License (MPL) 2.0, which is included in this distribution.
-
-### License for portions of the Rhino debugger ###
-Additionally, some files are available under the BSD 3-clause license:
-
-> Copyright 1997, 1998 Sun Microsystems, Inc.  All Rights Reserved.
->
-> Redistribution and use in source and binary forms, with or without
-> modification, are permitted provided that the following conditions are met:
->
-> - Redistributions of source code must retain the above copyright notice,
->   this list of conditions and the following disclaimer.
-> - Redistributions in binary form must reproduce the above copyright
->   notice, this list of conditions and the following disclaimer in the
->   documentation and/or other materials provided with the distribution.
-> - Neither the name of Sun Microsystems nor the names of its contributors
->   may be used to endorse or promote products derived from this software
->   without specific prior written permission.
->
-> THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-> AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-> IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-> DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
-> FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-> DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-> SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-> CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-> OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-> OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-### Source Code ###
-The source code for Rhino is available at:
-https://github.com/jsdoc3/rhino
-
 ## TaffyDB ##
 
 TaffyDB is distributed under a modified BSD license:

README.md

@@ -9,17 +9,8 @@ Want to contribute to JSDoc? Please read `CONTRIBUTING.md`.
 Installation and Usage
 ----------------------
 
-You can run JSDoc on either Node.js or Mozilla Rhino.
-
-### Node.js
-
-Native support for Node.js is available in JSDoc 3.3.0 and later. JSDoc
-supports Node.js 0.10 and later.
-
-#### Installing JSDoc for Node.js
-
-You can install JSDoc in your project's `node_modules` folder, or you can
-install it globally.
+JSDoc supports Node.js 0.10 and later. You can install JSDoc in your project's
+`node_modules` folder, or you can install it globally.
 
 To install the latest version available on NPM:
 
@@ -29,8 +20,6 @@ To install the latest development version:
 
     npm install git+https://github.com/jsdoc3/jsdoc.git
 
-#### Running JSDoc with Node.js
-
 If you installed JSDoc locally, the JSDoc command-line tool is available in
 `./node_modules/.bin`. To generate documentation for the file
 `yourJavaScriptFile.js`:
@@ -46,47 +35,6 @@ can use the `--destination` (`-d`) option to specify another directory.
 
 Run `jsdoc --help` for a complete list of command-line options.
 
-### Mozilla Rhino
-
-All versions of JSDoc 3 run on a customized version of Mozilla Rhino, which
-requires Java. You can run JSDoc 3 on Java 1.6 and later.
-
-#### Installing JSDoc for Mozilla Rhino
-
-To install JSDoc, download a .zip file for the
-[latest development version](https://github.com/jsdoc3/jsdoc/archive/master.zip)
-or a [previous release](https://github.com/jsdoc3/jsdoc/tags).
-
-You can also use git to clone the
-[JSDoc repository](https://github.com/jsdoc3/jsdoc):
-
-    git clone git+https://github.com/jsdoc3/jsdoc.git
-
-The JSDoc repository includes a
-[customized version of Mozilla Rhino](https://github.com/jsdoc3/rhino). Make
-sure your Java classpath does not include any other versions of Rhino. (On OS X,
-you may need to remove the file `~/Library/Java/Extensions/js.jar`.)
-
-**Note**: In JSDoc 3.3.0 and later, if you need to run JSDoc on Mozilla Rhino,
-do not install JSDoc with npm. Use one of the methods described above.
-
-#### Running JSDoc with Mozilla Rhino
-
-On OS X, Linux, and other POSIX systems, to generate documentation for the file
-`yourJavaScriptFile.js`:
-
-    ./jsdoc yourJavaScriptFile.js
-
-Or on Windows:
-
-    jsdoc yourJavaScriptFile.js
-
-By default, the generated documentation is saved in a directory named `out`. You
-can use the `--destination` (`-d`) option to specify another directory.
-
-Run `jsdoc --help` for a complete list of command-line options.
-
-
 Templates and Build Tools
 -------------------------
 

cli.js

@@ -6,10 +6,7 @@
  * A few critical notes for anyone who works on this module:
  *
  * + The module should really export an instance of `cli`, and `props` should be properties of a
- * `cli` instance. However, Rhino interpreted `this` as a reference to `global` within the
- * prototype's methods, so we couldn't do that.
- * + On Rhino, for unknown reasons, the `jsdoc/fs` and `jsdoc/path` modules can fail in some cases
- * when they are required by this module. You may need to use `fs` and `path` instead.
+ * `cli` instance.
  *
  * @private
  */

gulpfile.js

@@ -31,16 +31,7 @@ var options = {
         'test/specs/**/*.js'
     ],
     nodeBin: path.resolve(__dirname, './jsdoc.js'),
-    nodePath: process.execPath,
-    rhinoBin: (function() {
-        var filepath = path.resolve(__dirname, './jsdoc');
-
-        if (os.platform().indexOf('win') === 0) {
-            filepath += '.cmd';
-        }
-
-        return filepath;
-    })()
+    nodePath: process.execPath
 };
 
 gulp.task('bump', function() {
@@ -63,20 +54,9 @@ gulp.task('lint', function() {
         .pipe(eslint.failOnError());
 });
 
-gulp.task('test-node', function(cb) {
+gulp.task('test', function(cb) {
     var cmd = util.format('%s "%s" -T', options.nodePath, options.nodeBin);
     exec(cmd, execCb.bind(null, cb));
 });
 
-gulp.task('test-rhino', function(cb) {
-    var cmd = util.format('"%s" -T -q "parser=rhino"', options.rhinoBin);
-    exec(cmd, execCb.bind(null, cb));
-});
-
-gulp.task('test-rhino-jsparser', function(cb) {
-    var cmd = util.format('"%s" -T -q "parser=js"', options.rhinoBin);
-    exec(cmd, execCb.bind(null, cb));
-});
-
-gulp.task('test', ['test-node', 'test-rhino', 'test-rhino-jsparser']);
 gulp.task('default', ['lint', 'test']);

jsdoc

@@ -45,16 +45,7 @@
  */
 global.env = (function() {
     'use strict';
-
-    // This bit of joy is here because Rhino treats `./lib/jsdoc/env` and `jsdoc/env` as separate
-    // modules. In contrast, Node.js errors out on `jsdoc/env` because we don't patch `require()`
-    // until after this file is loaded.
-    if (require('./lib/jsdoc/util/runtime').isRhino()) {
-        return require('jsdoc/env');
-    }
-    else {
-        return require('./lib/jsdoc/env');
-    }
+    return require('./lib/jsdoc/env');
 })();
 
 /**
@@ -67,14 +58,7 @@ global.env = (function() {
  */
 global.app = (function() {
     'use strict';
-
-    // See comment in `global.env` to find out why we jump through this hoop.
-    if (require('./lib/jsdoc/util/runtime').isRhino()) {
-        return require('jsdoc/app');
-    }
-    else {
-        return require('./lib/jsdoc/app');
-    }
+    return require('./lib/jsdoc/app');
 })();
 
 (function() {
@@ -102,8 +86,7 @@ global.app = (function() {
     if (env.opts.debug) {
         /**
          * Recursively print an object's properties to stdout. This method is safe to use with
-         * objects that contain circular references. In addition, on Mozilla Rhino, this method is
-         * safe to use with native Java objects.
+         * objects that contain circular references.
          *
          * This method is available only when JSDoc is run with the `--debug` option.
          *
@@ -117,21 +100,5 @@ global.app = (function() {
         };
     }
 
-    // On Rhino, we use a try/catch block so we can log the Java exception (if available)
-    if ( runtime.isRhino() ) {
-        try {
-            cli.runCommand(cb);
-        }
-        catch (e) {
-            if (e.rhinoException) {
-                logger.fatal( e.rhinoException.printStackTrace() );
-            } else {
-                console.trace(e);
-                cli.exit(1);
-            }
-        }
-    }
-    else {
-        cli.runCommand(cb);
-    }
+    cli.runCommand(cb);
 })();

jsdoc.cmd

@@ -24,7 +24,7 @@ function parseQuery(str) {
 argParser.addOption('a', 'access',      true,  'Only display symbols with the given access: "public", "protected", "private" or "undefined", or "all" for all access levels. Default: all except "private"', true);
 argParser.addOption('c', 'configure',   true,  'The path to the configuration file. Default: path/to/jsdoc/conf.json');
 argParser.addOption('d', 'destination', true,  'The path to the output folder. Use "console" to dump data to the console. Default: ./out/');
-argParser.addOption('',  'debug',       false, 'Log information for debugging JSDoc. On Rhino, launches the debugger when passed as the first option.');
+argParser.addOption('',  'debug',       false, 'Log information for debugging JSDoc.');
 argParser.addOption('e', 'encoding',    true,  'Assume this encoding when reading all source files. Default: utf8');
 argParser.addOption('h', 'help',        false, 'Print this message and quit.');
 argParser.addOption('',  'match',       true,  'When running tests, only use specs whose names contain <value>.', true);