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: Re: fancy-splash-screen customize group... Date: Tue, 6 Dec 2005 22:25:44 -0600 (CST) Message-ID: <200512070425.jB74PiR28191@raven.dms.auburn.edu> References: <200512061909.jB6J99lg007547@brains.moreideas.ca> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1133929731 25158 80.91.229.2 (7 Dec 2005 04:28:51 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 7 Dec 2005 04:28:51 +0000 (UTC) Cc: zedek@gnu-rox.org, cyd@stupidchicken.com, rms@gnu.org, drew.adams@oracle.com, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Dec 07 05:28:43 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Ejqu2-00044A-RO for ged-emacs-devel@m.gmane.org; Wed, 07 Dec 2005 05:27:39 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EjquG-0004KH-4o for ged-emacs-devel@m.gmane.org; Tue, 06 Dec 2005 23:27:52 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Ejqu1-0004Jq-KE for emacs-devel@gnu.org; Tue, 06 Dec 2005 23:27:37 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Ejqtz-0004Ix-R3 for emacs-devel@gnu.org; Tue, 06 Dec 2005 23:27:37 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Ejqtz-0004Ik-Nd for emacs-devel@gnu.org; Tue, 06 Dec 2005 23:27: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 1Ejqul-00018c-9Z; Tue, 06 Dec 2005 23:28:23 -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 jB74R7FU022172; Tue, 6 Dec 2005 22:27:07 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id jB74PiR28191; Tue, 6 Dec 2005 22:25:44 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: emacs@whaite.ca In-reply-to: <200512061909.jB6J99lg007547@brains.moreideas.ca> (message from Peter Whaite on Tue, 06 Dec 2005 14:09:09 -0500) X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-2.0.1 (manatee.dms.auburn.edu [131.204.53.104]); Tue, 06 Dec 2005 22:27:07 -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:47099 Archived-At: Peter Whaite wrote: The documentation for 'customize-apropos' is under 'Specific Customization' which doesn't exactly jump out at you. How about renaming it to 'Finding Customizations', That would be misleading, because only a small fraction of that node is about _finding_ customizations. Moreover the node does not discuss what is intended to be the main way to browse and find options, customize-browse. On top of that, one should not make node name changes lightly, because they may break existing links, some of them in docs not included in the Emacs distribution (and which we hence can not grep for). changing the info node header to 'Finding and Customizing Specific Items'? Less bad, but still somewhat misleading. There is also no mention of customize-apropos-options, customize-apropos-groups, or customize-apropos-faces. There should be. That is easy to do. I intend to send Richard a proposed set of changes to man/custom.texi (mostly unrelated to the present discussion) soon (probably tomorrow) and I can easily include a short description of these three in `(emacs)Specific Customization'. Sincerely, Luc.