From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: Faces customization group linked from mode groups Date: Tue, 08 Nov 2005 14:45:21 +0200 Organization: JURTA Message-ID: <87mzkfwc52.fsf@jurta.org> References: <436BDAC7.2090704@student.lu.se> <87hdarodih.fsf@jurta.org> <436D0F14.7000908@student.lu.se> <87irv4d00h.fsf@jurta.org> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1131461576 23824 80.91.229.2 (8 Nov 2005 14:52:56 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 8 Nov 2005 14:52:56 +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 Tue Nov 08 15:52:55 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EZUnF-0004QJ-5M for ged-emacs-devel@m.gmane.org; Tue, 08 Nov 2005 15:49:49 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EZUnD-0006is-RF for ged-emacs-devel@m.gmane.org; Tue, 08 Nov 2005 09:49:47 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EZTQO-0004zg-3X for emacs-devel@gnu.org; Tue, 08 Nov 2005 08:22:08 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EZTQE-0004jE-7i for emacs-devel@gnu.org; Tue, 08 Nov 2005 08:21:59 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EZTQ0-0004Q3-Lq for emacs-devel@gnu.org; Tue, 08 Nov 2005 08:21:44 -0500 Original-Received: from [194.126.101.111] (helo=mail.neti.ee) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EZTPz-0001QX-JP; Tue, 08 Nov 2005 08:21:43 -0500 Original-Received: from mail.neti.ee (80-235-37-183-dsl.mus.estpak.ee [80.235.37.183]) by Relayhost1.neti.ee (Postfix) with ESMTP id 98D9320DE; Tue, 8 Nov 2005 15:21:57 +0200 (EET) Original-To: rms@gnu.org In-Reply-To: (Richard M. Stallman's message of "Mon, 07 Nov 2005 16:56:28 -0500") User-Agent: Gnus/5.110004 (No Gnus v0.4) Emacs/22.0.50 (gnu/linux) X-Virus-Scanned: by amavisd-new-2.2.1 (20041222) (Debian) at neti.ee 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:45594 Archived-At: > The cost is adding this link is losing another link in the same buffer > which looks like: > > Parent documentation: [Manual]. > > I don't understand what such a link would mean. > What is "parent documentation"? What is "Manual" the name of? It is a link in the parent group pointing to the Info manual. For example, with group definitions: (defgroup c nil :link '(custom-manual "(ccmode)")) (defgroup cpp nil :group 'c) the customization buffer of the `cpp' group has the link to the Info manual "ccmode". The customization buffer of the `c' group has the same link too. > What in the source code produces such a link? The function `custom-add-parent-links' in cus-edit.el: (and (null (get name 'custom-links)) ;No links of its own. (= (length parents) 1) ;A single parent. (let* ((links (get (car parents) 'custom-links)) (many (> (length links) 2))) (when links (insert "\nParent documentation: ") (while links (push (widget-create-child-and-convert widget (car links)) ... adds a link to the manual from the parent, if the group has no own links. There is nothing bad not having a parent documentation link, since the user can go to the parent group, and find the same link in the parent customization buffer. -- Juri Linkov http://www.jurta.org/emacs/