diff options
Diffstat (limited to 'devdocs/elisp/applying-customizations.html')
| -rw-r--r-- | devdocs/elisp/applying-customizations.html | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/devdocs/elisp/applying-customizations.html b/devdocs/elisp/applying-customizations.html new file mode 100644 index 00000000..d4914497 --- /dev/null +++ b/devdocs/elisp/applying-customizations.html @@ -0,0 +1,18 @@ + <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>&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>&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 © 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> |