15 Customization Settings

Users of Emacs can customize variables and faces without writing Lisp code, by using the Customize interface. See Easy Customization in The GNU Emacs Manual. This chapter describes how to define customization items that users can interact with through the Customize interface.

Customization items include customizable variables, which are defined with the defcustom macro; customizable faces, which are defined with defface (described separately in Defining Faces); and customization groups, defined with defgroup, which act as containers for groups of related customization items.

• Common Keywords		Common keyword arguments for all kinds of customization declarations.
• Group Definitions		Writing customization group definitions.
• Variable Definitions		Declaring user options.
• Customization Types		Specifying the type of a user option.
• Applying Customizations		Functions to apply customization settings.
• Custom Themes		Writing Custom themes.