From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Getting help for a widget Date: Sat, 01 Apr 2006 08:45:41 -0500 Message-ID: References: Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: sea.gmane.org 1143899235 6657 80.91.229.2 (1 Apr 2006 13:47:15 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 1 Apr 2006 13:47:15 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Apr 01 15:47:13 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FPgRY-0002vP-IS for ged-emacs-devel@m.gmane.org; Sat, 01 Apr 2006 15:47:08 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FPgRY-0005zb-4Y for ged-emacs-devel@m.gmane.org; Sat, 01 Apr 2006 08:47:08 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FPgQC-0005Me-2r for emacs-devel@gnu.org; Sat, 01 Apr 2006 08:45:44 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FPgQA-0005Lm-To for emacs-devel@gnu.org; Sat, 01 Apr 2006 08:45:43 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FPgQA-0005LH-My for emacs-devel@gnu.org; Sat, 01 Apr 2006 08:45:42 -0500 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FPgSn-0002DW-BL for emacs-devel@gnu.org; Sat, 01 Apr 2006 08:48:25 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1FPgQ9-0004mE-D5; Sat, 01 Apr 2006 08:45:41 -0500 Original-To: "Drew Adams" In-reply-to: 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:52285 Archived-At: This is perhaps the main difficulty of working with or even talking about widgets (and, so, with Customize too) as either a user or a casual developer: understanding what the &^!@% is going on. I agree. I find it very hard to understand that code. But what does it mean to "get help for a widget"? It is not clear to me, and maybe there is more than one kind we need. If you press C-h k on a file you get help for `widget-button-press'. But what does the button do? I don't really follow that, but it seems to be a request for a better answer to the question, "What happens if i click here"? That could be useful, and perhaps C-h k ought to make a special case for the function widget-button-press. That would not be hard. But where can it get the useful doc string to display? Meanwhile, this would not help people who are doing programming with widgets. They need a different kind of help. In other words, it will take some real thought and study to figure out what "good help for widgets" would mean. It would be useful for people to start exploring this now.