From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: man/custom.texi Date: Fri, 16 Dec 2005 20:18:05 -0600 (CST) Message-ID: <200512170218.jBH2I5P05464@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1134786055 22278 80.91.229.2 (17 Dec 2005 02:20:55 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 17 Dec 2005 02:20:55 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 17 03:20:52 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EnRg4-0006vU-KG for ged-emacs-devel@m.gmane.org; Sat, 17 Dec 2005 03:20:05 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EnRgm-00081u-Ac for ged-emacs-devel@m.gmane.org; Fri, 16 Dec 2005 21:20:48 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EnRgc-00081o-Th for emacs-devel@gnu.org; Fri, 16 Dec 2005 21:20:39 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EnRgZ-00081S-Ss for emacs-devel@gnu.org; Fri, 16 Dec 2005 21:20:38 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EnRgZ-00081P-QZ for emacs-devel@gnu.org; Fri, 16 Dec 2005 21:20:35 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EnRj5-0007vP-Vh for emacs-devel@gnu.org; Fri, 16 Dec 2005 21:23:12 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.13.3+Sun/8.13.3) with ESMTP id jBH2JnQX021108 for ; Fri, 16 Dec 2005 20:19:49 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id jBH2I5P05464; Fri, 16 Dec 2005 20:18:05 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: emacs-devel@gnu.org X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-2.0.1 (manatee.dms.auburn.edu [131.204.53.104]); Fri, 16 Dec 2005 20:19:49 -0600 (CST) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:47925 Archived-At: Here is my patch to man/custom.texi making customize-browse more prominent (by giving it a separate node) and adding some other remarks about finding options. (We discussed this before.) I can install if desired. ===File ~/man-custom.texi-diff============================== *** custom.texi 12 Dec 2005 20:53:17 -0600 1.96 --- custom.texi 16 Dec 2005 20:06:24 -0600 *************** *** 206,211 **** --- 206,212 ---- @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,283 **** pertaining to that feature. You can also go straight to a particular group by name, using the command @kbd{M-x customize-group}. @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 customization buffer which shows only the names of the groups (and variables and faces), and their structure. --- 276,288 ---- pertaining to that feature. You can also go straight to a particular group by name, using the command @kbd{M-x customize-group}. + @node Browsing Custom + @subsection Browsing and Searching for Options and Faces @findex customize-browse ! 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,296 **** --- 296,308 ---- 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 + @code{customize-browse}, @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,633 **** 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. @findex customize-face Likewise, you can modify a specific face, chosen by name, using --- 639,647 ---- 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 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,652 **** 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. @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). @findex customize-changed-options When you upgrade to a new Emacs version, you might want to customize --- 652,667 ---- 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 (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 @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,660 **** 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. @findex customize-saved @findex customize-customized --- 669,676 ---- 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. (Not just ! those that are already loaded.) @findex customize-saved @findex customize-customized ============================================================