From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: doc elisp intro cross reference fixes Date: Wed, 26 Nov 2003 21:22:05 -0600 (CST) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200311270322.hAR3M5X03101@raven.dms.auburn.edu> References: <87wua28zux.fsf@zip.com.au> <87ad6vdsxi.fsf@mail.jurta.org> <200311190418.hAJ4ITC02466@raven.dms.auburn.edu> <200311190528.hAJ5SrK02553@raven.dms.auburn.edu> <3FBBD155.2050703@yahoo.com> <200311192238.hAJMcTM06424@raven.dms.auburn.edu> <3FBD2533.6090503@yahoo.com> <200311262349.hAQNn2l02786@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1069904018 22289 80.91.224.253 (27 Nov 2003 03:33:38 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 27 Nov 2003 03:33:38 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Thu Nov 27 04:33:35 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1APCuN-00088q-00 for ; Thu, 27 Nov 2003 04:33:35 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1APCuM-00016L-00 for ; Thu, 27 Nov 2003 04:33:35 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1APDoV-0000Rv-1v for emacs-devel@quimby.gnus.org; Wed, 26 Nov 2003 23:31:35 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1APDne-0008Oh-BS for emacs-devel@gnu.org; Wed, 26 Nov 2003 23:30:42 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1APDmb-0007YB-PF for emacs-devel@gnu.org; Wed, 26 Nov 2003 23:30:08 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.24) id 1APDma-0007XJ-PO for emacs-devel@gnu.org; Wed, 26 Nov 2003 23:29:36 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id hAR3SGKk015927; Wed, 26 Nov 2003 21:28:16 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.6+Sun/8.11.6) id hAR3M5X03101; Wed, 26 Nov 2003 21:22:05 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: monnier@IRO.UMontreal.CA In-reply-to: (message from Stefan Monnier on 26 Nov 2003 19:51:47 -0500) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 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:18156 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:18156 Stefan Monnier wrote: BZZT! Thanks for playing, it works exactly as I showed: (defcustom a b "c") OK, but in which node of the Elisp manual is this feature documented? Which node of the Elisp manual contains the guidelines on when it is appropriate to use this feature? The only answer to that question I was able to find was in (elisp)Group Definitions. This clearly suggests to me that it is _never_ appropriate to use the "feature": Each Emacs Lisp package should have one main customization group which contains all the options, faces and other groups in the package. My comments: To me, this clearly says that every package containing defcustom's or defface's should have a customization group and that _all_ options of the package should be in that group or a subgroup of it. If that would not be the present standard, then the above sentence, quoted from (elisp)Group Definitions, should be quantified. Sincerely, Luc. `