Properties

documentPaths

Supported By

Applies To

Global environment

Example

set documentPaths to the documentPaths & newline & "/home/jdoe/work/"

Description

The documentPaths property determines or changes the list of file system paths searched by the open command and the docPath, docFile, appOrDocPath, and appOrDocFile functions to locate document files.

Notes

HyperTalk did not have this property but used a Documents global variable for the same purpose. OpenXION avoids using any XION global variables for special purposes.

The default list of paths in OpenXION is, on Mac OS X:

~/Desktop/
~/Documents/
~/Downloads/
~/Pictures/
~/Music/
~/Movies/
~/Public/
~/Sites/
~/

On Windows:

~\Desktop\
~\My Documents\
~\My Photos\
~\My Music\
~\My Videos\
~\

On all other systems:

~/

(The ~ refers to the user's home 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 documentPaths 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.

See Also

open, docPath, docFile, appOrDocPath, appOrDocFile