Next: , Previous: , Up: Miscellaneous Functions   [Contents][Index]


20.6 Sawfish Invocation Functions

Variable: sawfish-version

The version number of the running Sawfish.

Variable: sawfish-directory

The home directory for Sawfish files. For example: "/usr/share/sawfish". You can override it with the environment variable SAWFISHDIR.

Variable: sawfish-exec-directory

The directory for architechture-specific Sawfish executables. For example: "/usr/lib/sawfish/1.3/i386-pc-linux-gnu". You can override it with the environment variable SAWFISHEXECDIR.

Variable: sawfish-lisp-lib-directory

The top-level directory for Sawfish lisp files. For example: "/usr/share/sawfish/1.3/lisp". You can override it with the environment variable SAWFISHLISPDIR.

Variable: sawfish-locale-directory

The system directory where Sawfish can find locale files. This is not part of the Sawfish distribution. For example: "/usr/share/locale".

Variable: sawfish-site-lisp-directory

The top-level directory for site-specific Sawfish lisp files. For example: "/usr/share/sawfish/site-lisp". You can override it with the environment variable SAWFISHSITELISPDIR.

Variable: sawfish-user-lisp-directory

The list of user’s sawfish lisp directories. The default value is ($HOME/.sawfish/lisp). It is prepended to load-path, so that files under these directories are searched prior to sawfish-lisp-lib-directory.

You can override the value with environment variable SAWFISH_USER_LISP_DIR. Paths are seperated by colon, like the PATH environmental variable. Example: ~/.sawfish/lisp-test:~/.sawfish/lisp.

Function: quit
Function: restart

Quits and restart Sawfish.

Restart does exec (3), replacing the current process. All command line arguments are used again, except that session management related ones are updated.

There also exist same name commands.

Function: exit-type

If Sawfish is shutting down, this function returns one of the strings "user-quit", "user-restart" or "session-quit". If Sawfish is not shutting down, it returns nil.

Function: poweroff action

A function for rebooting, halting, suspending and hibernating your machine. Normally this is only used when running outside of GNOME or KDE; they provied their own versions of functions.

action is a symbol, and each invokes the shell command defined by the variable as follows:

actionvariable
rebootreboot-command
halthalt-command
suspendsuspend-command
hibernatehibernate-command

When action is reboot or halt, before-exit-hook is called, and delete-windows is applied to each window to ensure we safely quit the current session.

Variable: want-poweroff-menu

If you don’t use GNOME, KDE, nor XFCE, power off related actions are added under the root menu -> “Sessions”.


Next: , Previous: , Up: Miscellaneous Functions   [Contents][Index]