Locating The Session File

Lugaru's Epsilon
Programmer's
Editor 14.04

Context:

Epsilon User's Manual and Reference

    Commands by Topic

       Starting and Stopping Epsilon

          Session Files

             Locating The Session File

          File Associations

          . . .

Previous	Up	Next
Session Files	Commands by Topic	File Associations

Epsilon User's Manual and Reference > Commands by Topic > Starting and Stopping Epsilon > Session Files >

Locating The Session File

By default, Epsilon restores your previous session by consulting a single session file named epsilon.ses, which is normally stored in your customization directory. (See The Customization Directory.) Epsilon will write such a file when you exit.

You can set Epsilon to use multiple session files by having it search for an existing session file, starting from the current directory. If a session file doesn't exist in the current directory, then Epsilon looks in its parent directory, then in that directory's parent, and so forth, until it reaches the root directory or finds a session file. Or you can have it always read and create its session file in the current directory.

To make Epsilon look for its session file only in the current directory, and create a new session file there on exiting, set the session-default-directory variable to ".".

To make Epsilon search through a directory hierarchy for an existing session file, set the session-tree-root variable to empty. If this variable is set to a directory name in absolute form, Epsilon will only search for an existing session file in the named directory or one of its children. For example, if session-tree-root holds c:\joe\proj, and the current directory is c:\joe\proj\src, Epsilon will search in c:\joe\proj\src, then c:\joe\proj, for a session file. If the current directory is c:\joe\misc, on the other hand, Epsilon won't search at all (since \joe\misc isn't a child of \joe\proj), but will use the rules below. By default this variable is set to the word NONE, an impossible absolute directory name, so searching is disabled.

If Epsilon finds no such file by searching as described above (or if such searching is disabled, as it usually is), then Epsilon looks for a session file in each of these places, in this order:

If the session-default-directory variable is non-empty, in the directory it names. (This variable is empty by default.)
If the configuration variable EPSPATH can be found, in the first directory it names. (See Configuration Variables for more on configuration variables.)
In your customization directory.

There are three ways to tell Epsilon to search for a file with a different name, instead of the default of epsilon.ses. With any of these methods, specifying an absolute path keeps Epsilon from searching and forces it to use a particular file. Epsilon checks for alternate names in this order:

The -p flag can specify a different session file name.
An ESESSION configuration variable can specify a different session file name.
The session-file-name variable can specify a name.

Standard bindings:

read-session

write-session

Previous Up Next
Session Files Commands by Topic File Associations