NAME

       jython.conf - Jython registry for system-wide options

DESCRIPTION

       When  running jython(1) or jythonc(1), a number of properties may be set to customise Jython's behaviour.
       Properties can be assigned values in any of the following four ways.  This list is arranged  from  lowest
       to  highest  priority;  thus  for instance a property set in a user's personal registry will override the
       same property set in the system-wide registry.

       Java system properties
              Jython options may be set in the standard Java system properties.  However, since the  jython  and
              jythonc startup scripts take responsibility for starting the Java interpreter, it is unlikely that
              you will use this method of Jython configuration.

       Jython system-wide registry
              The  system-wide  registry  is the file /etc/jython/jython.conf.  It contains a number of lines of
              the form property=value.  Lines that are empty or that begin with a hash (#) are ignored.

       User's personal registry
              The user's personal registry is the file ~/.jython.  Its format is the same as for the system-wide
              registry.

       Command-line options
              Properties may be specified when running jython or jythonc at  the  command-line.   They  are  set
              using command-line options of the form -Dproperty=value.

PROPERTIES

       The  following  properties  may  be  set  in  the  Jython  registry.  Other less used properties are also
       available; see the comments in the default system-wide registry for further details.

       If a property is marked (auto), the jython and jythonc startup scripts will attempt to set this  property
       automatically, although it can still be overridden in the system or user registry or on the command-line.

       python.cachedir (auto)
              The  directory  to  use  for  caches (currently just package information).  This directory must be
              writable by the user.  If the directory is an absolute path then it is used as given; otherwise it
              is interpreted as relative to the root Jython directory (/usr/share/jython/).

       python.console
              The name of the console class to use when running Jython from the command prompt.  An  alternative
              console class that emulates GNU readline can be specified using this property.

       python.jythonc.classpath (auto)
              Extensions  to  the Java property java.class.path for use with jythonc.  This is used to put extra
              classes on your Java compiler's classpath (and the core Java classes as well if your Java compiler
              requires them).

       python.jythonc.compiler (auto)
              The Java compiler to use with jythonc when turning generated Java  code  into  Java  class  files.
              This  should  be  the absolute path to a Java compiler, or the name of a compiler on your standard
              PATH.

       python.jythonc.compileropts
              Options to pass to the Java compiler when using jythonc.

       python.path (auto)
              The path on which Jython will look for additional python modules when  importing.   This  variable
              has a similar function to CPython's PYTHONPATH environment variable.

       python.security.respectJavaAccessibility
              Normally,  Jython  can only provide access to public members of classes.  However if this property
              is set to false and you are using Java 1.2 then Jython can access non-public fields,  methods  and
              constructors.

       python.verbose
              Sets  the  verbosity  level  for  informative  messages.  All messages with at least the specified
              severity will be displayed.  Valid values in order of increasing  verbosity  are  error,  warning,
              message, comment and debug.

SEE ALSO

       jython(1), jythonc(1).

       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.

                                                September 2, 2001                                 JYTHON.CONF(5)