From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/62207 Path: news.gmane.org!not-for-mail From: Reiner Steib Newsgroups: gmane.emacs.devel,gmane.emacs.gnus.general Subject: Re: defcustom :version Date: Sat, 11 Mar 2006 14:57:20 +0100 Message-ID: References: <15499.1142047137@olgas.newt.com> Reply-To: Reiner Steib NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1142086741 2548 80.91.229.2 (11 Mar 2006 14:19:01 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 11 Mar 2006 14:19:01 +0000 (UTC) Cc: ding@gnus.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 11 15:18:57 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 1FI4vl-00008N-Jr for ged-emacs-devel@m.gmane.org; Sat, 11 Mar 2006 15:18:53 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FI4vl-0003eY-1Y for ged-emacs-devel@m.gmane.org; Sat, 11 Mar 2006 09:18:53 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FI4vY-0003dn-LO for emacs-devel@gnu.org; Sat, 11 Mar 2006 09:18:40 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FI4vW-0003dL-47 for emacs-devel@gnu.org; Sat, 11 Mar 2006 09:18:40 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FI4vW-0003dE-0l for emacs-devel@gnu.org; Sat, 11 Mar 2006 09:18:38 -0500 Original-Received: from [134.60.1.1] (helo=mail.uni-ulm.de) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA:32) (Exim 4.52) id 1FI4z2-0006aG-QQ for emacs-devel@gnu.org; Sat, 11 Mar 2006 09:22:17 -0500 Original-Received: from bridgekeeper.physik.uni-ulm.de (bridgekeeper.physik.uni-ulm.de [134.60.10.123]) by mail.uni-ulm.de (8.13.4/8.13.4) with ESMTP id k2BEIYgM005632; Sat, 11 Mar 2006 15:18:34 +0100 (MET) Original-Received: from viandante.physik.uni-ulm.de (bridgekeeper.physik.uni-ulm.de [134.60.10.123]) by bridgekeeper.physik.uni-ulm.de (Postfix) with SMTP id 2808A11431; Sat, 11 Mar 2006 15:18:32 +0100 (CET) Original-Received: (nullmailer pid 19924 invoked by uid 170); Sat, 11 Mar 2006 13:57:21 -0000 Original-To: emacs-devel@gnu.org Mail-Followup-To: emacs-devel@gnu.org, ding@gnus.org X-Face: 3Phac&+dw=IZHjhua]bp}LH<*p{qzj8u+ 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:51464 gmane.emacs.gnus.general:62207 Archived-At: On Sat, Mar 11 2006, Bill Wohler wrote: > We don't use any :version keywords in the MH-E package at the moment, > although I'd like to add them. Before doing so, I hope you can help me > answer a couple of questions about them. > > First, how are people using the defcustom :version keyword? Maybe you already know this but... you don't need to add the keyword to each variable: You can also add it to the custom group. > The big problem I have with them is that it seems we have to use the > Emacs version. That makes them pretty useless for the MH-E package which > has turned three *major* releases and a score of minor releases since > Emacs 21 came out. In the past few years, I would have used 21.4, 21.5, > 22.0, and 22.1 as the "next" version kept creeping up. How would I have > documented the variables? [...] > > I see the Gnus folks are using the Emacs version in their > variables. Admittedly, many Gnus developers weren't aware of :version, so I added many of version numbers after Jan D. pointed it out on emacs-devel after Gnus was updated there. > How have you folks answered these questions? Not really an answer to the questions you raised, but this is how I suggest to handle it in Gnus: ,----[ (info "(gnus-coding)Gnus Maintainance Guide") ] | For new customizable variables introduced in Oort Gnus (including the | v5-10 branch) use `:version "22.1" ;; Oort Gnus' including the comment. | If the variable is new in No Gnus use `:version "23.0" ;; No Gnus'. `---- > Unless, of course, folks think is reasonable and proper that large > independent packages that happen to be bundled with Emacs can use their > versions with the defcustom :version keyword. This only would make sense if `customize-changed-options' could handle such "package versions". Maybe extending the format to allow plists such as... :version '(:emacs 22.1 :mh-e 7.0) :version '(:emacs 22.1 :gnus 5.10.2) ("mh-e" / "gnus" could either refer to the package or to a customization group. The later might be difficult for Gnus because not everything included in Gnus is within the `gnus' customization group) Limiting `customize-changed-options' to certain custom groups (and subgroups) would be useful independent of extending :version keyword. Bye, Reiner. -- ,,, (o o) ---ooO-(_)-Ooo--- | PGP key available | http://rsteib.home.pages.de/