From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Roland Winkler Newsgroups: gmane.emacs.devel Subject: Re: [roland.winkler@physik.uni-erlangen.de: documentation bug: customization type `option'] Date: Sun, 4 Jul 2004 16:57:46 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <16616.6890.589923.966980@tfkp07.physik.uni-erlangen.de> References: <871xjuojfl.fsf@emacswiki.org> <20040704023137.GA16549@fencepost> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1088953742 12703 80.91.224.253 (4 Jul 2004 15:09:02 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 4 Jul 2004 15:09:02 +0000 (UTC) Cc: emacs-devel@gnu.org, Richard Stallman , Alex Schroeder Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun Jul 04 17:08:54 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1Bh8bu-0005jD-00 for ; Sun, 04 Jul 2004 17:08:54 +0200 Original-Received: from lists.gnu.org ([199.232.76.165]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1Bh8bu-0006TR-00 for ; Sun, 04 Jul 2004 17:08:54 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Bh8dp-0004GE-Hm for emacs-devel@quimby.gnus.org; Sun, 04 Jul 2004 11:10:53 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1Bh8dm-0004E0-DK for emacs-devel@gnu.org; Sun, 04 Jul 2004 11:10:50 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1Bh8dk-0004BR-Ey for emacs-devel@gnu.org; Sun, 04 Jul 2004 11:10:49 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Bh8dk-0004BJ-CK for emacs-devel@gnu.org; Sun, 04 Jul 2004 11:10:48 -0400 Original-Received: from [199.232.41.8] (helo=mx20.gnu.org) by monty-python.gnu.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.34) id 1Bh8b4-0001Hg-45; Sun, 04 Jul 2004 11:08:02 -0400 Original-Received: from [131.188.3.181] (helo=max71.rrze.uni-erlangen.de) by mx20.gnu.org with esmtp (Exim 4.34) id 1Bh8Rk-0001b8-DV; Sun, 04 Jul 2004 10:58:24 -0400 Original-Received: from tfkp07.physik.uni-erlangen.de (tfkp07.physik.uni-erlangen.de [131.188.164.207]) by max71.rrze.uni-erlangen.de with ESMTP; Sun, 4 Jul 2004 16:58:15 +0200 Original-To: Miles Bader In-Reply-To: <20040704023137.GA16549@fencepost> X-Mailer: VM 7.17 under Emacs 21.3.50.6 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: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:25440 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:25440 On Sat, Jul 03, 2004 at 02:21:19PM -0400, Richard Stallman wrote: > It is not worth writing text in the manual for internal facilities. > Writing good manual text is hard work, and I don't want to do it > when it's not needed. Maybe this depends on the point of view. Being the maintainer of a high-level package I feel like the user of the low-level stuff such as widgets. So I am grateful when the low-level stuff is well documented and I need not spend too much time digging in its source code. On Sat Jul 3 2004 Miles Bader wrote: > What about just saying somethign like `some other widget types > exist, and are documented in their doc-string, for instance: of widget types>'. > > [Of course some of these widgets may be undocumented for good > reason -- e.g., they are incompletely implemented or something > (perhaps working only in the specific case where they are used).] I think that's a good idea. I spent a little time trying to make sure that I didn't overlook anything in the info files. So if there had been such a remark, it would have saved me some time. Roland