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 program 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 environment 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 optimizations 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 infor‐
              mation 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 serial‐
              ize.

       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 coding 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 coding 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 synchronizes on the this object of its invo‐
              cation.

       quit() Quit  shell. The shell will also quit in interactive mode if an end-of-file charac‐
              ter is typed at the prompt.

       version([number])
              Get or set JavaScript version number. If no argument is supplied, the current  ver‐
              sion  number  is  returned. If an argument is supplied, 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 respectively.


SEE ALSO
       The online documentation under http://www.mozilla.org/rhino/shell.html


AUTHOR
       This  manual page was written by Wolfgang Baer <WBaer AT gmx.de>, for the Debian project (but
       may be used by others).



                                        February  12, 2005                               RHINO(1)