comparison man/custom.texi @ 90734:e4e4a56ef723

Merge from emacs--devo--0 Patches applied: * emacs--devo--0 (patch 583-585) - Update from CVS - Fix admin/quick-install-emacs to work with recent versions of autoconf Revision: [e-mail]/emacs--unicode--0--patch-160

90733:99e0a3426753

  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.

@table @kbd
@item M-x customize-variable @key{RET} @var{variable} @key{RET}
Set up a customization buffer with just one variable, @var{variable}.
@item M-x customize-face @key{RET} @var{face} @key{RET}
Set up a customization buffer with just one face, @var{face}.
@item M-x customize-group @key{RET} @var{group} @key{RET}
Set up a customization buffer with just one group, @var{group}.
@item M-x customize-apropos @key{RET} @var{regexp} @key{RET}
Set up a customization buffer with all the settings and groups that
match @var{regexp}.
@item M-x customize-changed-options @key{RET} @var{version} @key{RET}
Set up a customization buffer with all the settings and groups
whose meaning has changed since Emacs version @var{version}.
@item M-x customize-saved
Set up a customization buffer containing all settings that you
have saved with customization buffers.
@item M-x customize-customized
Set up a customization buffer containing all settings that you have
customized but not saved.
@end table

@findex customize-variable
  If you want to alter a particular variable with the customization
buffer, and you know its name, you can use the command @kbd{M-x
customize-variable} and specify the variable name.  This sets up the
customization buffer with just one variable---the one that you asked
for.  Editing, setting and saving the value work as described above,
but only for the specified variable.  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.

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

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

@findex customize-apropos
  For a more general way of controlling what to customize, you can use
@kbd{M-x customize-apropos}.  You specify a regular expression as
argument; then all @emph{loaded} settings and groups whose names match

90734:e4e4a56ef723

  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.

@table @kbd
@item M-x customize-option @key{RET} @var{option} @key{RET}
Set up a customization buffer with just one user option variable,
@var{option}.
@item M-x customize-face @key{RET} @var{face} @key{RET}
Set up a customization buffer with just one face, @var{face}.
@item M-x customize-group @key{RET} @var{group} @key{RET}
Set up a customization buffer with just one group, @var{group}.
@item M-x customize-apropos @key{RET} @var{regexp} @key{RET}
Set up a customization buffer with all the settings and groups that
match @var{regexp}.
@item M-x customize-changed @key{RET} @var{version} @key{RET}
Set up a customization buffer with all the settings and groups
whose meaning has changed since Emacs version @var{version}.
@item M-x customize-saved
Set up a customization buffer containing all settings that you
have saved with customization buffers.
@item M-x customize-customized
Set up a customization buffer containing all settings that you have
customized but not saved.
@end table

@findex customize-option
  If you want to alter a particular user option with the customization
buffer, and you know its name, you can use the command @kbd{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.

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

@findex customize-group
  You can also set up the customization buffer with a specific group,
using @kbd{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.

@findex customize-apropos
  For a more general way of controlling what to customize, you can use
@kbd{M-x customize-apropos}.  You specify a regular expression as
argument; then all @emph{loaded} settings and groups whose names match