|  |  | 
 The Jython RegistryBecause there is no good platform independent equivalent of the Windows
Registry (or Unix envrionment variables) Java has it's own environment
variable namespace.  Jython aquires it's namespace from the following
three sources (later sources override defaults found in earlier
places).
    The Java system properties: typically passed in on the command
	line as options to the java interpreter.
    The Jython "registry" file, which contains
	prop=value pairs.
	See below for the
	algorithm Jython uses to find the registry file.
    The user's personal registry file, which contains
	similarly formated prop/value pairs.  The user's registry file 
	is at "user.home"+"/.jython"
    Jython properties: Specified on the command line as options
        to the jython class. See the -D 
        option to the interpreter.
 Registry PropertiesThe following properties are recognized by Jython.  There may be
others that aren't documented here; consult the comments in registry
file for details.
    The following steps are used to find the Jython registry file, and
also to set the Python values for sys.prefix.  First a
root directory is calculated:python.path
    Equivalent to CPython's PYTHONPATH environment variable
    python.cachedir
    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, it is used as given, otherwise it
    is interpreted as relative to sys.prefix.
    python.verbose
    Sets the verbosity level for varying degrees of informative
    messages.  Valid values in order of increasing verbosity are
    "error", "warning", "message", "comment", "debug"
    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.jythonc.compiler
    The Java compiler to use with the jythonc tool,
    which now generates Java source code.  This should be the absolute 
    path to a Java compiler, or the name of a compiler on your
    standard PATH.
    python.jythonc.classpath
    Extensions to the standard java.class.path property
    for use with jythonc.  This is useful if you use Jikes as your
    compiler.
    python.jythonc.compileropts
    Options to pass to the Java compiler when using jythonc.
    python.console
    The name of a console class. An alternative console class
    that supports 
    GNU readline
    can be installed with this property. Jython already include such a 
    console class and it can be enabled by setting this property to
    org.python.util.ReadlineConsolepython.console.readlinelib
    Allow a choice of backing implementation for GNU readline support.
    Can be either GnuReadlineorEditline.
    This property is only used when python.console is set toorg.python.util.ReadlineConsole. 
    Once the root directory is found, sys.prefix and
sys.exec_prefix are set to this, and sys.path has
rootdir/Lib appended to it.  The registry file used is then
rootdir/registry.If there is a property called
    python.home, this is used as the root directory.
    Otherwise, the property install.root is used if it 
    exists.
    If neither of those properties exist, then Jython searches 
    for the file "jython.jar" on the Java classpath, as defined in
    the system property java.class.path.  The actual file
    system isn't searched, only the paths defined on the classpath
    (one of them must literally include "jython.jar").
 |