Provided by: jython_2.5.3-1ubuntu0.1_all bug

NAME

       jython - Python seamlessly integrated with Java

SYNOPSIS

       jython [ -i ] [ -S ] [ -v ] [ -Dproperty=value ... ] [ -Wargument ]
              [ -Ecodec ] [ -Qargument ]
              [ -jar jar | -c cmd | file | - ] [ script-args ]

       jython [ --help | --version ]

DESCRIPTION

       Jython  is  an  implementation of the high-level, dynamic, object-oriented language Python
       seamlessly integrated with the Java platform.  The  predecessor  to  Jython,  JPython,  is
       certified as 100% Pure Java.

       Jython is complementary to Java and is especially suited for the following tasks:

       Embedded scripting:
              Java programmers can add the Jython libraries to their system to allow end users to
              write simple or complicated scripts that add functionality to the application.

       Interactive experimentation:
              Jython provides an interactive interpreter that can be used to interact  with  Java
              packages  or with running Java applications.  This allows programmers to experiment
              with and debug any Java system using Jython.

       Rapid application development:
              Python programs are typically 2-10X shorter than the equivalent Java program.  This
              translates directly to increased programmer productivity.  The seamless interaction
              between Python and Java allows developers to freely  mix  the  two  languages  both
              during development and in shipping products.

       To  make  a  jython script executable on your system you can add the following line to the
       top of the file:

              #!/usr/bin/env jython

       You will also need to add execute permissions to the script  using  chmod(1).   Note  that
       #!/usr/bin/jython  will  not  work;  you  must use #!/usr/bin/env jython.  This is because
       /usr/bin/jython is a script itself, not a compiled binary.

OPTIONS

       A summary of options is included below.

       -i     Continue running Jython interactively after running the  given  script,  and  force
              prompts even if standard input doesn't appear to be a terminal.

       -S     Don't imply import site on initialisation.

       -v     Trace import statements on error output.

       -Dproperty=value
              Set  the  Jython  property  property  to  value;  see jython.conf(5) for details of
              available properties.

       -Wargument
              Warning control. The full form of argument is  action:message:category:module:line.
              Trailing  empty  fields  may  be  omitted.  Multiple  -W options may be given.  See
              documentation of the warnings module for details.

       -Ecodec
              Set the encoding used to read module source files from disk.

       -Qargument
              Division control. See PEP 239 for details. Valid arguments are old, new,  warn  and
              warnall.

       -jar jar
              The program to run is read from the file __run__.py in the specified jar archive.

       -c cmd The program to run is passed as the cmd string.  This option terminates the options
              list.

       file   The program to run is the script file.

       -      The program to run is read from standard input  (default  behaviour).   Interactive
              mode  is used if running on a tty.  This flag allows you to pipe a file into Jython
              and have it be treated correctly.

       script-args
              Command-line arguments to pass to the Jython script in sys.argv[1:].

       --help Print a usage message and exit.

       --version
              Print the Jython version number and exit.

ENVIRONMENT VARIABLES

       JAVA (default: /usr/bin/java)
              The Java interpreter to use when running Jython.

       JAVA_OPTIONS (default: empty)
              Options to pass to the Java interpreter when running Jython.

SEE ALSO

       jythonc(1), jython.conf(5).

       If the Debian package jython-doc is installed, full documentation from the Jython  authors
       will be available in /usr/share/doc/jython-doc/html/.

AUTHOR

       This  manual  page  was  prepared  by Ben Burton <bab@debian.org> for the Debian GNU/Linux
       system (but may be used by others).  It is based upon the official Jython documentation.

                                           July 7, 2001                                 JYTHON(1)