jython.conf - Jython registry for system-wide options
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
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
- 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
- Options to pass to the Java compiler when using
- 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.
- 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
- 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.
If the Debian package jython-doc
is installed, full documentation from
the Jython authors will be available in
This manual page was prepared by Ben Burton <email@example.com> for the
Debian GNU/Linux system (but may be used by others). It is based upon the
official Jython documentation.