From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 1005E1384C3 for ; Sat, 5 Sep 2015 06:31:34 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id D389E14209; Sat, 5 Sep 2015 06:31:23 +0000 (UTC) Received: from plane.gmane.org (plane.gmane.org [80.91.229.3]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id D7F74141EA for ; Sat, 5 Sep 2015 06:31:22 +0000 (UTC) Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1ZY70Q-0000dc-Gh for gentoo-dev@lists.gentoo.org; Sat, 05 Sep 2015 08:31:18 +0200 Received: from ip98-167-165-199.ph.ph.cox.net ([98.167.165.199]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 05 Sep 2015 08:31:18 +0200 Received: from 1i5t5.duncan by ip98-167-165-199.ph.ph.cox.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 05 Sep 2015 08:31:18 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: gentoo-dev@lists.gentoo.org From: Duncan <1i5t5.duncan@cox.net> Subject: [gentoo-dev] Re: gnatbuild.eclass refactoring: new/transitory eclass? Date: Sat, 5 Sep 2015 06:31:12 +0000 (UTC) Message-ID: References: <1964623.1PWUb7kWtd@phycelpc12.univ-lille1.fr> <1441375531.4764.30.camel@gentoo.org> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: ip98-167-165-199.ph.ph.cox.net User-Agent: Pan/0.140 (Chocolate Salty Balls; GIT af87825) X-Archives-Salt: a51a2368-22d5-4d0c-b279-b4458499533c X-Archives-Hash: 4be51b3fd1e603e713d3c0bb39c55680 Alexandre Rostovtsev posted on Fri, 04 Sep 2015 10:05:31 -0400 as excerpted: > On Thu, 2015-09-03 at 16:00 +0200, George Shapovalov wrote: >> 2. Is there some standard naming scheme? Should the new eclass be >> called, say, >> gnatbuild2.eclass or gnatbuild-ng.eclass? Of course this only matters >> if old eclass is there to stay. If not I'll just call the transitory >> eclass something like gnatbuild-refactor.eclass for the duration of its >> existence.. > > I suggest gnatbuild-r1.eclass, that seems to be the most widely used > eclass versioning pattern. Some examples: > > bash-completion.eclass → bash-completion-r1.eclass (2011) > distutils.eclass → distutils-r1.eclass (2012) > emboss.eclass → emboss-r1.eclass (2015) > git.eclass → git-2.eclass (2011) → git-r3.eclass (2013) > myspell.eclass → myspell-r2.eclass (2012) > office-ext.eclass → office-ext-r1.eclass (2013) > python.eclass → python-r1.eclass (2012) > qt4.eclass → qt4-r2.eclass (2009) > > Other patterns: > > java-utils.eclass → java-utils-2.eclass (2006) > mysql.eclass → mysql-v2.eclass (2011) > ruby.eclass → ruby-ng.eclass (2009) Just to add... As the folks doing the git eclasses found out, bare generation numbers are all too easily confused with upstream version numbers -- git-2.eclass, is that for use with git-2*? Given that gentooers are already familiar with the -rN identifier from ebuilds and know that there it unambiguously indicates a gentoo revision, as opposed to upstream, the same idea was eventually borrowed for eclasses identifiers -- git-r3.eclass unambiguously indicates what git-2.eclass didn't, that it's the third /gentoo/ generation of git eclass, *not* just for /upstream/ git-v3 (when there is one). (Xref eclasses such as qt4, kde4, qt5... where the number indicates upstream version.) So -rN has become the standard gentoo-generation identifier for eclasses, meaning much the same thing as it does when used for ebuilds. If you'll note, the other listed patterns are from 2011 or earlier, when the git-2.eclass experience proved its name a confusing mistake and effectively catalyzed the standardization around the -rN pattern that was apparently (based on the above dates) first used with qt4-r2.eclass in 2009. -- Duncan - List replies preferred. No HTML msgs. "Every nonfree program has a lord, a master -- and if you use the program, he is your master." Richard Stallman