All the customization declarations accept keyword arguments for specifying various information. This section describes some keywords that apply to all three kinds of customization items (groups, variables, and faces).
Most of these keywords can be used more than once in a given item. Each
use of the keyword has an independent effect. The only keyword which
cannot meaningfully be used more than once is :tag
---because
only one name is displayed for a given item.
:group group
:group
in a defgroup
, it makes one group within another.
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. Be careful not to go overboard with this!
:link 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)
: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; most items have none at
all.
:load file
load-library
, and only if the file is
not already loaded.
:require feature
require
.
The most common reason to use :require
is when a variable enables
a feature, such as a minor mode, and it won't have any effect unless the
code which implements the mode is loaded.
:tag name
Go to the first, previous, next, last section, table of contents.