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
              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 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
              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 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@gmx.de>, for the Debian project (but
       may be used by others).

                                        February  12, 2005                               RHINO(1)