From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Richard M. Stallman" Newsgroups: gmane.emacs.devel Subject: Re: Faces customization group linked from mode groups Date: Tue, 15 Nov 2005 18:21:11 -0500 Message-ID: References: <436BDAC7.2090704@student.lu.se> <87hdarodih.fsf@jurta.org> <436D0F14.7000908@student.lu.se> <87irv4d00h.fsf@jurta.org> <87u0eeam1d.fsf@jurta.org> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: sea.gmane.org 1132096926 21891 80.91.229.2 (15 Nov 2005 23:22:06 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 15 Nov 2005 23:22:06 +0000 (UTC) Cc: lennart.borgman.073@student.lu.se, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Nov 16 00:22:04 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EcA7H-0000el-70 for ged-emacs-devel@m.gmane.org; Wed, 16 Nov 2005 00:21:31 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EcA7G-00085O-Hw for ged-emacs-devel@m.gmane.org; Tue, 15 Nov 2005 18:21:30 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EcA78-00085H-56 for emacs-devel@gnu.org; Tue, 15 Nov 2005 18:21:22 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EcA77-00084v-J2 for emacs-devel@gnu.org; Tue, 15 Nov 2005 18:21:21 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EcA77-00084p-FJ for emacs-devel@gnu.org; Tue, 15 Nov 2005 18:21:21 -0500 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EcA77-0002d9-KC for emacs-devel@gnu.org; Tue, 15 Nov 2005 18:21:21 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1EcA6x-0005a2-E3; Tue, 15 Nov 2005 18:21:16 -0500 Original-To: Juri Linkov In-reply-to: <87u0eeam1d.fsf@jurta.org> (message from Juri Linkov on Tue, 15 Nov 2005 02:42:54 +0200) 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:46056 Archived-At: >From all these link types only four are documented in the Emacs Lisp manual in the node (info "(elisp)Common Keywords"): custom-manual, info-link, url-link and emacs-commentary-link. What about documenting remaining six types: custom-group-link, function-link, variable-link, file-link, emacs-library-link and documentation-link? In principle it sounds good. Please write a patch we could consider. Maybe Widget link types should be documented in the Widget manual, and No, no, no! That idea comes from trying to organize things in the most logical structure--which is the wrong approach to structuring documentation. The main goal of the manual is _to be convenient_. I put this info in the Emacs Lisp Manual because people need it for writing ordinary Lisp programs well. To put it somewhere else would be a more logical structure, but it would be less convenient. Logical structuring of the documentation sometimes increases convenience, and sometimes gets in the way. When it increases convenience, it is good. When it gets in the way, it is bad.