2. Environment variables
Prev | A. Command line options | Next

### 2. Environment variables

All scripts used to start XXE (that is, `xxe`, `xxe.bat` and `xxe.jstart`) automatically define system properties corresponding to the following environment variables.

Note that, due to limitations in Apple's Java™ launcher, you cannot use the following environment variables on the Mac[13].

Variable name | Value | Description
--- | --- | ---
XXE_ADDON_PATH | List of directory names separated by semi-colons ('`;`'). | All the directories referenced in this list are recursively scanned by XXE during its startup to dynamically discover add-ons. More info in chapter "The lookup phase during XXE startup" of Section 1, “Dynamic discovery of add-ons” in XMLmind XML Editor - Configuration and Deployment.
XXE_GUI | Filename (relative or absolute) or URL of an XXE GUI specification (`.xxe_gui`) file. | Specifies which GUI to use for newly started XXE. More info in XMLmind XML Editor - Customizing the User Interface.

XXE_USER_PREFERENCES

Filename of a property file

Specifies the location of a user preferences property file different from the default one: ``XXE_user_preferences_dir`/preferences.property`.

This alternate user preferences property file is created (if needed to)/read from/written to by XXE exactly like the default one.

Note that the hierarchy of directories containing this alternate user preferences property file is also created by XXE when it does not already exist.

[13] This is the case only when XXE is started normally, that is, by double-clicking on the XMLEditor application. There are no such problems if you download the `.tar.gz` or `.zip` distributions and you start XXE by executing the `xxe` shell script. However, doing so is definitely not recommended on the Mac.

Prev | Up | Next
1. Command line | Home | 3. System properties