Properties

includePaths

Supported By

OpenXION (1.1, 1.2, 1.3, 1.4)
OpenXION Standard Module (1.1, 1.2, 1.3, 1.4)

Applies To

Global environment

Example

set includePaths to the includePaths & newline & "/home/jdoe/scripts/"

Description

The includePaths property determines or changes the list of file system paths searched by the include and require keywords and the includePath and includeFile functions to locate include files.

Notes

The default list of paths in OpenXION consists solely of the current working directory.

OpenXION reads the value of this property from a file at startup and writes it back to the file upon exit. This file is located at ~/Library/Preferences/com.kreative.openxion.conf (on Mac OS X), ~\Application Data\OpenXION\xion.conf (on Windows), or ~/.xion.conf (on all other systems). This is a plain text file that can be edited with any text editor.

The includePaths property is specific to OpenXION; it is not part of the XION Scripting Language Standard.

Security

To change the value of this property, OpenXION's security settings must allow the SEARCH_PATHS security key. If the required security key is denied, a script error will be triggered.