Next: Group Definitions, Up: Customization
All kinds of customization declarations (for variables and groups, and for faces) accept keyword arguments for specifying various information. This section describes some keywords that apply to all kinds.
All of these keywords, except :tag
, can be used more than once
in a given item. Each use of the keyword has an independent effect.
The keyword :tag
is an exception because any given item can only
display one name.
:tag
label:group
group:group
in a defgroup
, it makes the new group a subgroup of
group.
If you use this keyword more than once, you can put a single item into
more than one group. Displaying any of those groups will show this
item. Please don't overdo this, since the result would be annoying.
:link
link-dataThere are three alternatives you can use for link-data:
(custom-manual
info-node)
"(emacs)Top"
. The link appears as
‘[manual]’ in the customization buffer.
(info-link
info-node)
custom-manual
except that the link appears
in the customization buffer with the Info node name.
(url-link
url)
(emacs-commentary-link
library)
You can specify the text to use in the customization buffer by adding
:tag
name after the first element of the link-data;
for example, (info-link :tag "foo" "(emacs)Top")
makes a link to
the Emacs manual which appears in the buffer as ‘foo’.
An item can have more than one external link; however, most items have
none at all.
:load
fileload-library
, and only if the file is
not already loaded.
:require
featurerequire
.
The most common reason to use :require
is when a variable enables
a feature such as a minor mode, and just setting the variable won't have
any effect unless the code which implements the mode is loaded.