From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/62472 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel,gmane.emacs.gnus.general Subject: Re: defcustom :version Date: Sat, 01 Apr 2006 17:23:37 +0300 Message-ID: References: <15499.1142047137@olgas.newt.com> <200603110447.k2B4lbt10750@raven.dms.auburn.edu> <9584.1142109654@olgas.newt.com> <17232.1142195412@olgas.newt.com> <6274.1143596753@olgas.newt.com> <87zmj8zm7x.fsf@olgas.newt.com> <200603300311.k2U3BCa12687@raven.dms.auburn.edu> <1666.1143739738@olgas.newt.com> <11642.1143828719@olgas.newt.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1143901443 12573 80.91.229.2 (1 Apr 2006 14:24:03 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 1 Apr 2006 14:24:03 +0000 (UTC) Cc: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Apr 01 16:24:01 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FPh1A-0007Ri-Du for ged-emacs-devel@m.gmane.org; Sat, 01 Apr 2006 16:23:56 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FPh19-00086r-TM for ged-emacs-devel@m.gmane.org; Sat, 01 Apr 2006 09:23:55 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FPh0x-00086l-Qm for emacs-devel@gnu.org; Sat, 01 Apr 2006 09:23:43 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FPh0v-00086Z-Ee for emacs-devel@gnu.org; Sat, 01 Apr 2006 09:23:42 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FPh0v-00086W-9Z for emacs-devel@gnu.org; Sat, 01 Apr 2006 09:23:41 -0500 Original-Received: from [192.114.186.66] (helo=romy.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FPh3X-0004sA-FS; Sat, 01 Apr 2006 09:26:23 -0500 Original-Received: from HOME-C4E4A596F7 (IGLD-80-230-13-61.inter.net.il [80.230.13.61]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id DWI54373 (AUTH halo1); Sat, 1 Apr 2006 17:23:36 +0300 (IDT) Original-To: emacs-devel@gnu.org, ding@gnus.org In-reply-to: <11642.1143828719@olgas.newt.com> (message from Bill Wohler on Fri, 31 Mar 2006 10:11:59 -0800) 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:52289 gmane.emacs.gnus.general:62472 Archived-At: > Comments: In-reply-to Richard Stallman > message dated "Fri, 31 Mar 2006 12:28:34 -0500." > Date: Fri, 31 Mar 2006 10:11:59 -0800 > From: Bill Wohler > Cc: ding@gnus.org, emacs-devel@gnu.org > > Richard Stallman wrote: > > > I didn't realize that a face could have a version as the defface > > docstring doesn't indicate it. Sure enough, defface, as well as > > defgroup, call custom-handle-all-keywords so :version is supported. Why > > then, are not all the keywords documented in all three macros? > > > > They are, in the node Common Keywords. > > The docstring implies only :group is supported: > > The remaining arguments should have the form > > [KEYWORD VALUE]... > > The following KEYWORDs are defined: > > :group VALUE should be a customization group. > Add face to that group. > > It also doesn't mention the ARGS argument. I would suggest either > enumerating all the legal keywords, or: > > The remaining arguments ARGS should have the form > > [KEYWORD VALUE]... > > See Info node `(elisp)Common Keywords' for the list of KEYWORDs. The reference to the ELisp manual is already in the doc strings, and the doc string for defgroup already mentions :version explicitly.