/[emacs]/emacs/man/custom.texi
ViewVC logotype

Diff of /emacs/man/custom.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.89 by rms, Thu Aug 18 15:01:06 2005 UTC revision 1.90 by cyd, Mon Sep 5 11:52:21 2005 UTC
# Line 199  the active fields and other features. Line 199  the active fields and other features.
199  * Face Customization::       How to edit the attributes of a face.  * Face Customization::       How to edit the attributes of a face.
200  * Specific Customization::   Making a customization buffer for specific  * Specific Customization::   Making a customization buffer for specific
201                                  variables, faces, or groups.                                  variables, faces, or groups.
202    * Custom Themes::            How to define collections of customized options
203                                    that can be loaded and unloaded together.
204  @end menu  @end menu
205    
206  @node Customization Groups  @node Customization Groups
# Line 652  changes.  Use @kbd{M-x customize-saved} Line 654  changes.  Use @kbd{M-x customize-saved}
654  you have saved.  Use @kbd{M-x customize-customized} to look at the  you have saved.  Use @kbd{M-x customize-customized} to look at the
655  options that you have set but not saved.  options that you have set but not saved.
656    
657    @node Custom Themes
658    @subsection Customization Themes
659    @cindex custom themes
660    
661    @dfn{Custom themes} are collections of customized options that can be
662    enabled or disabled as a unit.  You can use Custom themes to switch
663    quickly and easily between various collections of settings, and to
664    transfer such collections from one computer to another.
665    
666    @findex customize-create-theme
667    To define a Custom theme, use the command
668    @kbd{M-x customize-create-theme}, which brings up a buffer named
669    @samp{*New Custom Theme*}.  At the top of the buffer is an editable
670    field where you can specify the name of the theme.  To add a
671    customization option to the theme, click on the @samp{INS} button to
672    open up a field where you can insert the name of the option.  The
673    current value of that option is applied to the theme.  After adding as
674    many options as you like, click on @samp{Done} to save the Custom
675    theme.
676    
677    @vindex custom-theme-directory
678    Saving a Custom theme named @var{foo} writes its definition into the
679    file @file{@var{foo}-theme.el}, in the directory @file{~/.emacs.d/}
680    (you can specify the directory by setting
681    @code{custom-theme-directory}).
682    
683    @findex load-theme
684    @findex enable-theme
685    @findex disable-theme
686    You can load the themes you've previously defined with the command
687    @code{load-theme}.  It prompts for a theme name in the minibuffer,
688    then loads that theme if it isn't already loaded.  It also
689    @dfn{enables} the theme, which means putting its settings into effect.
690    An enabled theme can be @dfn{disabled} with the command
691    @kbd{M-x disable-theme}; this returns the options specified in the
692    theme to their original values.  To re-enable the theme, use the
693    command @kbd{M-x enable-theme}.
694    
695    To enable a Custom theme named @var{foo} whenever Emacs is started up,
696    add the line @code{(load-theme '@var{foo})} to your @file{.emacs} file
697    (@pxref{Init File}).
698    
699    Enabling a custom theme does not disable the themes already enabled;
700    instead, they are all enabled together.  If two enabled Custom themes
701    specify different values for an option, the last theme to be enabled
702    takes effect.
703    
704    The options that you set in the ordinary customization buffer
705    (@pxref{Easy Customization}) are also considered part of a Custom
706    theme, called @samp{user}.  The @samp{user} theme is always enabled,
707    and always takes precedence over all other enabled Custom themes.
708    Additionally, the @samp{user} theme is recorded in your @file{.emacs}
709    file, rather than a @file{user-theme.el} file.
710    
711  @node Variables  @node Variables
712  @section Variables  @section Variables
713  @cindex variable  @cindex variable

Legend:
Removed from v.1.89  
changed lines
  Added in v.1.90

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26