From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: [roland.winkler@physik.uni-erlangen.de: documentation bug: customization type `option'] Date: Sat, 3 Jul 2004 22:31:37 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <20040704023137.GA16549@fencepost> References: <871xjuojfl.fsf@emacswiki.org> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1088908350 9011 80.91.224.253 (4 Jul 2004 02:32:30 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 4 Jul 2004 02:32:30 +0000 (UTC) Cc: roland.winkler@physik.uni-erlangen.de, emacs-devel@gnu.org, Alex Schroeder Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun Jul 04 04:32:23 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 1Bgwnm-0003r6-00 for ; Sun, 04 Jul 2004 04:32:22 +0200 Original-Received: from lists.gnu.org ([199.232.76.165]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1Bgwnm-0002Y2-00 for ; Sun, 04 Jul 2004 04:32:22 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Bgwpf-0004u9-VG for emacs-devel@quimby.gnus.org; Sat, 03 Jul 2004 22:34:19 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1BgwpT-0004u4-0u for emacs-devel@gnu.org; Sat, 03 Jul 2004 22:34:07 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1BgwpS-0004ts-Ik for emacs-devel@gnu.org; Sat, 03 Jul 2004 22:34:06 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BgwpS-0004tp-Es for emacs-devel@gnu.org; Sat, 03 Jul 2004 22:34:06 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BgwnC-00044H-7g for emacs-devel@gnu.org; Sat, 03 Jul 2004 22:31:46 -0400 Original-Received: from miles by fencepost.gnu.org with local (Exim 4.34) id 1Bgwn3-0004Me-U7; Sat, 03 Jul 2004 22:31:38 -0400 Original-To: Richard Stallman Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.3.28i Blat: Foop 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:25431 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:25431 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. What about just saying somethign like `some other widget types exist, and are documented in their doc-string, for instance: '. [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).] -Miles -- We live, as we dream -- alone....