procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Mention `set-variable' in the Init Syntax Emacs manual node

Browse source 
* doc/emacs/custom.texi (Init Syntax): Mention set-variable
(bug#50248).
(Init Examples): Add an example.
This commit is contained in:
Lars Ingebrigtsen 2021-08-29 21:31:57 +02:00
parent 9117a76b53
commit 5bd23b0cd3
1 changed files with 21 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

29
doc/emacs/custom.texi
View file

@ -2366,14 +2366,19 @@ function @code{setq} to set the variable @code{fill-column}
(@pxref{Filling}) to 60.
You can set any Lisp variable with @code{setq}, but with certain
variables @code{setq} won't do what you probably want in the
init file. Some variables automatically become buffer-local
when set with @code{setq}; what you want in the init file is to set
the default value, using @code{setq-default}. Some customizable minor
mode variables do special things to enable the mode when you set them
with Customize, but ordinary @code{setq} won't do that; to enable the
mode in your init file, call the minor mode command. The
following section has examples of both of these methods.
variables @code{setq} won't do what you probably want in the init
file. Some variables automatically become buffer-local when set with
@code{setq}; what you want in the init file is to set the default
value, using @code{setq-default}. (The following section has examples
of both of these methods.)
Some customizable minor mode variables do special things to enable the
mode when you set them with Customize, but ordinary @code{setq} won't
do that; to enable the mode in your init file, call the minor mode
command. Finally, a few customizable user options are initialized in
complex ways, and these have to be set either via the customize
interface (@pxref{Customization}) or by using @code{set-variable}
(@pxref{Examining}).
The second argument to @code{setq} is an expression for the new
value of the variable. This can be a constant, a variable, or a
@ -2521,6 +2526,14 @@ Turn on Auto Fill mode automatically in Text mode and related modes
(add-hook 'text-mode-hook 'auto-fill-mode)
@end example
@item
Change the coding system used when using the clipboard
(@pxref{Communication Coding}).
@example
(set-variable 'selection-coding-system 'utf-8)
@end example
@item
Load the installed Lisp library named @file{foo} (actually a file
@file{foo.elc} or @file{foo.el} in a standard Emacs directory).