devdocs/elisp/customization.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

 <h2 class="chapter">Customization Settings</h2>  <p>Users of Emacs can customize variables and faces without writing Lisp code, by using the Customize interface. See <a href="https://www.gnu.org/software/emacs/manual/html_node/emacs/Easy-Customization.html#Easy-Customization">Easy Customization</a> in <cite>The GNU Emacs Manual</cite>. This chapter describes how to define <em>customization items</em> that users can interact with through the Customize interface. </p> <p>Customization items include customizable variables, which are defined with the <code>defcustom</code> macro; customizable faces, which are defined with <code>defface</code> (described separately in <a href="defining-faces">Defining Faces</a>); and <em>customization groups</em>, defined with <code>defgroup</code>, which act as containers for groups of related customization items. </p> <table class="menu" border="0" cellspacing="0"> <tr>
<td align="left" valign="top">• <a href="common-keywords" accesskey="1">Common Keywords</a>
</td>
<td> </td>
<td align="left" valign="top">Common keyword arguments for all kinds of customization declarations. </td>
</tr> <tr>
<td align="left" valign="top">• <a href="group-definitions" accesskey="2">Group Definitions</a>
</td>
<td> </td>
<td align="left" valign="top">Writing customization group definitions. </td>
</tr> <tr>
<td align="left" valign="top">• <a href="variable-definitions" accesskey="3">Variable Definitions</a>
</td>
<td> </td>
<td align="left" valign="top">Declaring user options. </td>
</tr> <tr>
<td align="left" valign="top">• <a href="customization-types" accesskey="4">Customization Types</a>
</td>
<td> </td>
<td align="left" valign="top">Specifying the type of a user option. </td>
</tr> <tr>
<td align="left" valign="top">• <a href="applying-customizations" accesskey="5">Applying Customizations</a>
</td>
<td> </td>
<td align="left" valign="top">Functions to apply customization settings. </td>
</tr> <tr>
<td align="left" valign="top">• <a href="custom-themes" accesskey="6">Custom Themes</a>
</td>
<td> </td>
<td align="left" valign="top">Writing Custom themes. </td>
</tr> </table><div class="_attribution">
  <p class="_attribution-p">
    Copyright &copy; 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
    <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Customization.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Customization.html</a>
  </p>
</div>