From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Yoni Rabkin Newsgroups: gmane.emacs.devel Subject: Re: version numbers in ELPA Date: Wed, 17 Feb 2021 12:34:25 -0500 Message-ID: <87czwy8uou.fsf@rabkins.net> References: <87h7ma8vrs.fsf@rabkins.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31202"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Cc: emacs-devel To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Feb 17 18:36:41 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lCQki-0007yO-D8 for ged-emacs-devel@m.gmane-mx.org; Wed, 17 Feb 2021 18:36:40 +0100 Original-Received: from localhost ([::1]:55872 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lCQkh-0000FL-CU for ged-emacs-devel@m.gmane-mx.org; Wed, 17 Feb 2021 12:36:39 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47456) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lCQib-0006YU-ND for emacs-devel@gnu.org; Wed, 17 Feb 2021 12:34:29 -0500 Original-Received: from smtprelay0230.hostedemail.com ([216.40.44.230]:50044 helo=smtprelay.hostedemail.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lCQiZ-0000VX-Pj for emacs-devel@gnu.org; Wed, 17 Feb 2021 12:34:29 -0500 Original-Received: from filter.hostedemail.com (clb03-v110.bra.tucows.net [216.40.38.60]) by smtprelay01.hostedemail.com (Postfix) with ESMTP id 8B1C1100E7B44; Wed, 17 Feb 2021 17:34:26 +0000 (UTC) X-Session-Marker: 796F6E69407261626B696E732E6E6574 X-HE-Tag: yard10_0610cdd2764e X-Filterd-Recvd-Size: 2217 Original-Received: from greenriver.rabkins.net (c-73-238-99-162.hsd1.ma.comcast.net [73.238.99.162]) (Authenticated sender: yoni@rabkins.net) by omf13.hostedemail.com (Postfix) with ESMTPA; Wed, 17 Feb 2021 17:34:26 +0000 (UTC) X-Ethics: Use GNU In-Reply-To: (Stefan Monnier's message of "Wed, 17 Feb 2021 12:30:50 -0500") Received-SPF: none client-ip=216.40.44.230; envelope-from=yoni@rabkins.net; helo=smtprelay.hostedemail.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:265025 Archived-At: Stefan Monnier writes: >> As I'm preparing another release of rt-liberation for ELPA I noticed >> that in my code I have: >> >> ;; Version: 2.01 >> >> ...but ELPA displays it, and makes the directories under >> ~/.emacs.d/elpa, as "2.1". > > Yes, version numbers are defined in ELPA (notice: not "GNU ELPA" but > "ELPA") as sequences of numbers. Since 1 and 01 are one and the same > number, then ... 2.01 is the same as 2.1. > >> Are there some implicit rules to follow as to how we should number >> versions going to ELPA? Are there some explicit rules I just skimmed >> over and didn't take note of? > > Yes, the version numbers need to obey `version-to-list` and the actual > string used to represent the version number in the name of the tarball > need to be "canonicalized" by passing them to `version-to-list` and then > recreating a corresponding string out of it with `package-version-join` > (defined in `package.el`). This need is because the `archive-contents` > file (which lists the tarballs available in a given ELPA server) give > the versions in the form of a list of numbers rather than a string, and > then `package.el` needs to "guess" the name of the corresponding tarball > by creating a string out of it. Understood; thank you. I'll change the version numbering accordingly. -- "Cut your own wood and it will warm you twice"