manpagez: man pages & more
info emacs
Home | html | info | man
[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

57.2.6 Customizing Specific Items

Instead of finding the setting you want to change by navigating the structure of groups, here are other ways to specify the settings that you want to customize.

M-x customize-option <RET> option <RET>

Set up a customization buffer with just one user option variable, option.

M-x customize-face <RET> face <RET>

Set up a customization buffer with just one face, face.

M-x customize-group <RET> group <RET>

Set up a customization buffer with just one group, group.

M-x customize-apropos <RET> regexp <RET>

Set up a customization buffer with all the settings and groups that match regexp.

M-x customize-changed <RET> version <RET>

Set up a customization buffer with all the settings and groups whose meaning has changed since Emacs version version.

M-x customize-saved

Set up a customization buffer containing all settings that you have saved with customization buffers.

M-x customize-unsaved

Set up a customization buffer containing all settings that you have set but not saved.

If you want to alter a particular user option with the customization buffer, and you know its name, you can use the command M-x customize-option and specify the user option (variable) name. This sets up the customization buffer with just one user option—the one that you asked for. Editing, setting and saving the value work as described above, but only for the specified user option. Minibuffer completion is handy if you only know part of the name. However, this command can only see options that have been loaded in the current Emacs session.

Likewise, you can modify a specific face, chosen by name, using M-x customize-face. By default it operates on the face used on the character after point.

You can also set up the customization buffer with a specific group, using M-x customize-group. The immediate contents of the chosen group, including settings (user options and faces), and other groups, all appear as well (even if not already loaded). However, the subgroups' own contents are not included.

For a more general way of controlling what to customize, you can use M-x customize-apropos. You specify a regular expression as argument; then all loaded settings and groups whose names match this regular expression are set up in the customization buffer. If you specify an empty regular expression, this includes all loaded groups and settings—which takes a long time to set up.

When you upgrade to a new Emacs version, you might want to consider customizing new settings, and settings whose meanings or default values have changed. To do this, use M-x customize-changed and specify a previous Emacs version number using the minibuffer. It creates a customization buffer which shows all the settings and groups whose definitions have been changed since the specified version, loading them if necessary.

If you change settings and then decide the change was a mistake, you can use two special commands to revisit your previous changes. Use M-x customize-saved to look at the settings that you have saved. Use M-x customize-unsaved to look at the settings that you have set but not saved.


[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]
© manpagez.com 2000-2017
Individual documents may contain additional copyright information.