GNU Info
(emacs)Customization Groups
Customization Groups
....................
For customization purposes, user options are organized into "groups"
to help you find them. Groups are collected into bigger groups, all
the way up to a master group called `Emacs'.
`M-x customize' creates a customization buffer that shows the
top-level `Emacs' group and the second-level groups immediately under
it. It looks like this, in part:
/- Emacs group: ---------------------------------------------------\
[State]: visible group members are all at standard settings.
Customization of the One True Editor.
See also [Manual].
Confirm Kill Emacs: [Hide] [Value Menu] Don't confirm
[State]: this option is unchanged from its standard setting.
How to ask for confirmation when leaving Emacs. [More]
Editing group: [Go to Group]
Basic text editing facilities.
External group: [Go to Group]
Interfacing to external utilities.
MORE SECOND-LEVEL GROUPS
\- Emacs group end ------------------------------------------------/
This says that the buffer displays the contents of the `Emacs' group.
The other groups are listed because they are its contents. But they
are listed differently, without indentation and dashes, because _their_
contents are not included. Each group has a single-line documentation
string; the `Emacs' group also has a `[State]' line.
Most of the text in the customization buffer is read-only, but it
typically includes some "editable fields" that you can edit. There are
also "active fields"; this means a field that does something when you
"invoke" it. To invoke an active field, either click on it with
`Mouse-1', or move point to it and type <RET>.
For example, the phrase `[Go to Group]' that appears in a
second-level group is an active field. Invoking the `[Go to Group]'
field for a group creates a new customization buffer, which shows that
group and its contents. This field is a kind of hypertext link to
another group.
The `Emacs' group includes a few user options itself, but mainly it
contains other groups, which contain more groups, which contain the
user options. By browsing the hierarchy of groups, you will eventually
find the feature you are interested in customizing. Then you can use
the customization buffer to set the options and faces pertaining to
that feature. You can also go straight to a particular group by name,
using the command `M-x customize-group'.
You can view the structure of customization groups on a larger scale
with `M-x customize-browse'. This command creates a special kind of
customization buffer which shows only the names of the groups (and
options and faces), and their structure.
In this buffer, you can show the contents of a group by invoking
`[+]'. When the group contents are visible, this button changes to
`[-]'; invoking that hides the group contents.
Each group, option or face name in this buffer has an active field
which says `[Group]', `[Option]' or `[Face]'. Invoking that active
field creates an ordinary customization buffer showing just that group
and its contents, just that option, or just that face. This is the way
to set values in it.
automatically generated by info2www version 1.2.2.9