path: root/devdocs/elisp/applying-customizations.html

 <h3 class="section">Applying Customizations</h3>  <p>The following functions are responsible for installing the user’s customization settings for variables and faces, respectively. When the user invokes ‘<samp>Save for future sessions</samp>’ in the Customize interface, that takes effect by writing a <code>custom-set-variables</code> and/or a <code>custom-set-faces</code> form into the custom file, to be evaluated the next time Emacs starts. </p> <dl> <dt id="custom-set-variables">Function: <strong>custom-set-variables</strong> <em>&amp;rest args</em>
</dt> <dd>
<p>This function installs the variable customizations specified by <var>args</var>. Each argument in <var>args</var> should have the form </p> <div class="example"> <pre class="example">(<var>var</var> <var>expression</var> [<var>now</var> [<var>request</var> [<var>comment</var>]]])
</pre>
</div> <p><var>var</var> is a variable name (a symbol), and <var>expression</var> is an expression which evaluates to the desired customized value. </p> <p>If the <code>defcustom</code> form for <var>var</var> has been evaluated prior to this <code>custom-set-variables</code> call, <var>expression</var> is immediately evaluated, and the variable’s value is set to the result. Otherwise, <var>expression</var> is stored into the variable’s <code>saved-value</code> property, to be evaluated when the relevant <code>defcustom</code> is called (usually when the library defining that variable is loaded into Emacs). </p> <p>The <var>now</var>, <var>request</var>, and <var>comment</var> entries are for internal use only, and may be omitted. <var>now</var>, if non-<code>nil</code>, means to set the variable’s value now, even if the variable’s <code>defcustom</code> form has not been evaluated. <var>request</var> is a list of features to be loaded immediately (see <a href="named-features">Named Features</a>). <var>comment</var> is a string describing the customization. </p>
</dd>
</dl> <dl> <dt id="custom-set-faces">Function: <strong>custom-set-faces</strong> <em>&amp;rest args</em>
</dt> <dd>
<p>This function installs the face customizations specified by <var>args</var>. Each argument in <var>args</var> should have the form </p> <div class="example"> <pre class="example">(<var>face</var> <var>spec</var> [<var>now</var> [<var>comment</var>]])
</pre>
</div> <p><var>face</var> is a face name (a symbol), and <var>spec</var> is the customized face specification for that face (see <a href="defining-faces">Defining Faces</a>). </p> <p>The <var>now</var> and <var>comment</var> entries are for internal use only, and may be omitted. <var>now</var>, if non-<code>nil</code>, means to install the face specification now, even if the <code>defface</code> form has not been evaluated. <var>comment</var> is a string describing the customization. </p>
</dd>
</dl><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/Applying-Customizations.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Applying-Customizations.html</a>
  </p>
</div>