[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/man/custom.texi
From: |
Luc Teirlinck |
Subject: |
[Emacs-diffs] Changes to emacs/man/custom.texi |
Date: |
Mon, 19 Dec 2005 23:33:53 +0000 |
Index: emacs/man/custom.texi
diff -u emacs/man/custom.texi:1.96 emacs/man/custom.texi:1.97
--- emacs/man/custom.texi:1.96 Mon Dec 12 05:10:18 2005
+++ emacs/man/custom.texi Mon Dec 19 23:33:53 2005
@@ -206,6 +206,7 @@
@menu
* Groups: Customization Groups. How options are classified in a structure.
+* Browsing: Browsing Custom. Browsing and searching for options and faces.
* Changing a Variable:: How to edit a value and set an option.
* Saving Customizations:: Specifying the file for saving customizations.
* Face Customization:: How to edit the attributes of a face.
@@ -275,9 +276,13 @@
pertaining to that feature. You can also go straight to a particular
group by name, using the command @kbd{M-x customize-group}.
address@hidden Browsing Custom
address@hidden Browsing and Searching for Options and Faces
@findex customize-browse
- You can view the structure of customization groups on a larger scale
-with @kbd{M-x customize-browse}. This command creates a special kind of
+You can use @kbd{M-x customize} to browse the groups and options, but
+often @kbd{M-x customize-browse} is a more efficient alternative.
+That is because it lets you view the structure of customization groups
+on a larger scale. This command creates a special kind of
customization buffer which shows only the names of the groups (and
variables and faces), and their structure.
@@ -291,6 +296,13 @@
that group and its contents, just that variable, or just that face.
This is the way to set values in it.
+ If you can guess part of the name of the options you are interested
+in, then sometimes @kbd{M-x customize-apropos} can be another useful
+way to search for options. However, unlike @code{customize} and
address@hidden, @code{customize-apropos} can only find
+options that are loaded in the current Emacs session. @xref{Specific
+Customization,, Customizing Specific Items}.
+
@node Changing a Variable
@subsection Changing a Variable
@@ -627,7 +639,9 @@
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.
+but only for the specified variable. Minibuffer completion is very
+handy if you only know part of the name. However, it only finds
+options that have been loaded in the current Emacs session.
@findex customize-face
Likewise, you can modify a specific face, chosen by name, using
@@ -638,15 +652,16 @@
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 user options, faces, and other groups, all appear
-as well. However, these subgroups' own contents are not included.
+as well (even if not already loaded). However, the subgroups' own
+contents are not included.
@findex customize-apropos
To control more precisely what to customize, you can use @kbd{M-x
customize-apropos}. You specify a regular expression as argument; then
-all options, faces and groups whose names match this regular expression
-are set up in the customization buffer. If you specify an empty regular
-expression, this includes @emph{all} groups, options and faces (but
-that takes a long time).
+all @emph{loaded} options, faces and groups whose names match this
+regular expression are set up in the customization buffer. If you
+specify an empty regular expression, this includes @emph{all} groups,
+options and faces (but that takes a long time).
@findex customize-changed-options
When you upgrade to a new Emacs version, you might want to customize
@@ -654,7 +669,8 @@
To do this, use @kbd{M-x customize-changed-options} and specify a
previous Emacs version number using the minibuffer. It creates a
customization buffer which shows all the options (and groups) whose
-definitions have been changed since the specified version.
+definitions have been changed since the specified version. (Not just
+those that are already loaded.)
@findex customize-saved
@findex customize-customized