Previous: , Up: Custom Themes   [Index]


4.3.4.2 Custom Theme Procedures

Function: custom-file &optional no-error

Compiled lisp function in cus-edit.el.

Return the file name for saving customizations.

Function: customize-themes &optional buffer

Autoloaded interactive compile lisp function in cus-theme.el.

Display a selectable list of custom themes.

BUFFER

buffer to use when called from lisp, or if omitted, then use a buffer named *Custom Themes*.

Function: load-theme theme &optional no-confirm no-enable

Interactive compiled lisp function in custom.el.

Load the custom theme named ‘THEME’ from its file (=THEME=~-theme.el~) found in one of the directories specified by custom-theme-load-path.

NO-CONFIRM

When loading, Emacs will take into consideration the value of the variable custom-safe-themes unless NO-CONFIRM is ‘t’, in which case Emacs will load the theme without prompting.

NO-ENABLE

Emacs will enable the theme unless the variable no-enable is ‘t’. Enabling a theme DOES NOT disable any already-enabled theme. To disable other themes, use disable-theme.

This function is normally called through Customize when setting custom-enabled themes. See custom-enabled-themes for a list of enabled themes.

Function: load-theme theme

Interactive compiled lisp function in custom.el.

Reenable all variable and face settings defined by theme.

THEME

theme should be either ‘user’, or a theme loaded via load-theme. After this function completes, theme will have the highest precedence (after ‘user’) among enabled themes. See custom-enabled-themes for a list of enabled themes.

Function: disable-theme theme

Interactive compiled lisp function in custom.el.

Disable all variable and face settings defined by theme.

Function: customize-create-theme &optional theme buffer

Autoloaded interactive compilded lisp function in cus-theme.el.

Create or edit a custom theme.

THEME

theme, if non-‘nil’, should be an existing theme to edit. If theme is ‘user’, the resulting *Custom Theme* buffer also contains a checkbox for removing the theme settings specified in the buffer from the Custom save file.

BUFFER

buffer, if non-‘nil’, should be a buffer to use; the default is named *Custom Theme*.


Previous: Custom Theme Variables, Up: Custom Themes   [Index]