RHINO-JSC(1) General Commands Manual RHINO-JSC(1)NAME
rhino-jsc - invokes the rhino JavaScript compiler
SYNOPSIS
rhino-jsc [options] file1.js [file2.js...]
DESCRIPTION
This manual page documents briefly the rhino-jsc command. This manual page was written for the Debian distribution because the original
program does not have a manual page. It is written according to the html documentation.
rhino-jsc is a start script for the rhino JavaScript compiler. The JavaScript compiler translates JavaScript source into Java class files.
The resulting Java class files can then be loaded and executed at another time, providing a convenient method for transferring JavaScript,
and for avoiding translation cost. Note that the top-level functions available to the shell (such as print) are not available to compiled
scripts when they are run outside the shell.
OPTIONS -extends java_class_name
Specifies that a java class extending the Java class java_class_name should be generated from the incoming JavaScript source file.
Each global function in the source file is made a method of the generated class, overriding any methods in the base class by the
same name.
-implements java_intf_name
Specifies that a java class implementing the Java interface java_intf_name should be generated from the incoming JavaScript source
file. Each global function in the source file is made a method of the generated class, implementing any methods in the interface by
the same name.
-debug, -g
Specifies that debug information should be generated. May not be combined with optimization at an optLevel greater than zero.
-nosource
Does not save the source in the class file. Functions and scripts compiled this way cannot be decompiled. This option can be used to
avoid distributing source or simply to save space in the resulting class file.
-o outputFile
Writes the class file to the given file (which should end in .class). The string outputFile must be a writable filename.
-opt, -O optLevel
Optimizes at level optLevel, which must be an integer between 0 and 9.
-package packageName
Specifies the package to generate the class into. The string packageName must be composed of valid identifier characters optionally
separated by periods.
-version versionNumber
Specifies the language version to compile with. The string versionNumber must be one of 100, 110, 120, 130, or 140. See JavaScript
Language Versions for more information on language versions.
EXAMPLE
Example compiling the NervousText.js applet written in JavaScript. The example is provided in the librhino-java-doc package.
$ rhino-jsc -extends java.applet.Applet -implements java.lang.Runnable NervousText.js
SEE ALSO
The online documentation under http://www.mozilla.org/rhino/jsc.html
AUTHOR
This manual page was written by Wolfgang Baer <WBaer@gmx.de>, for the Debian project (but may be used by others).
February 12, 2005 RHINO-JSC(1)
Check Out this Related Man Page
RHINO(1) General Commands Manual RHINO(1)NAME
rhino - invokes the JavaScript shell for running scripts in batch mode or interactive
SYNOPSIS
rhino [options] script_filename_or_url [script_arguments]
DESCRIPTION
This manual page documents briefly the rhino command. This manual page was written for the Debian distribution because the original pro-
gram does not have a manual page. It is written according to the html documentation.
rhino is a start script for the rhino JavaScript shell which provides a simple way to run scripts in batch mode or an interactive environ-
ment for exploratory programming.
OPTIONS -e script_source
Executes script_source as a JavaScript script.
-f script_filename_or_url
Reads script_filename_or_url content and execute it as a JavaScript script.
-opt, -O optLevel
Optimizes at level optLevel, which must be an integer between -1 and 9. -1 means Interpretive mode is always used. 0 means no opti-
mizations whereas 9 means all optimizations are performed.
-version versionNumber
Specifies the language version to compile with. The string versionNumber must be one of 100, 110, 120, 130, or 140. See JavaScript
Language Versions for more information on language versions.
-strict
Enable strict mode.
PREDEFINED PROPERTIES
Scripts executing in the shell have access to some additional properties of the top-level object.
arguments
The arguments object is an array containing the strings of all the arguments given at the command line when the shell was invoked.
help() Executing the help function will print usage and help messages.
defineClass(className)
Define an extension using the Java class named with the string argument className. Uses ScriptableObject.defineClass() to define the
extension.
deserialize(filename)
Restore from the specified file an object previously written by a call to serialize.
load([filename,...])
Load JavaScript source files named by string arguments. If multiple arguments are given, each file is read in and executed in turn.
loadClass(className)
Load and execute the class named by the string argument className. The class must be a class that implements the Script interface,
as will any script compiled by jsc.
print([expr...])
Evaluate and print expressions. Evaluates each expression, converts the result to a string, and prints it.
readFile(path[,characterCoding])
Read given file and convert its bytes to a string using the specified character coding or default character coding if explicit cod-
ing argument is not given.
readUrl(url[,characterCoding])
Open an input connection to the given string url, read all its bytes and convert them to a string using the specified character cod-
ing or default character coding if explicit coding argument is not given.
runCommand(commandName,[arg,...][options])
Execute the specified command with the given argument and options as a separate process and return the exit status of the process.
For details, see JavaDoc for org.mozilla.javascript.tools.shell.Global#runCommand.
serialize(object,filename)
Serialize the given object to the specified file.
spawn(functionOrScript)
Run the given function or script in a different thread.
sync(function)
creates a synchronized function (in the sense of a Java synchronized method) from an existing function. The new function synchro-
nizes on the this object of its invocation.
quit() Quit shell. The shell will also quit in interactive mode if an end-of-file character is typed at the prompt.
version([number])
Get or set JavaScript version number. If no argument is supplied, the current version number is returned. If an argument is sup-
plied, it is expected to be one of 100, 110, 120, 130, or 140 to indicate JavaScript version 1.0, 1.1, 1.2, 1.3, or 1.4 respec-
tively.
SEE ALSO
The online documentation under http://www.mozilla.org/rhino/shell.html
AUTHOR
This manual page was written by Wolfgang Baer <WBaer@gmx.de>, for the Debian project (but may be used by others).
February 12, 2005 RHINO(1)