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 0C2761387B1
for ; Sat, 18 Oct 2014 17:36:03 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id 720F7E09C1;
Sat, 18 Oct 2014 17:36:02 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
(No client certificate requested)
by pigeon.gentoo.org (Postfix) with ESMTPS id BBDF7E09C4
for ; Sat, 18 Oct 2014 17:36:01 +0000 (UTC)
Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52])
(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id B70B33402FB
for ; Sat, 18 Oct 2014 17:36:00 +0000 (UTC)
Received: from localhost.localdomain (localhost [127.0.0.1])
by oystercatcher.gentoo.org (Postfix) with ESMTP id 6455682D8
for ; Sat, 18 Oct 2014 17:35:59 +0000 (UTC)
From: "Markos Chandras"
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Markos Chandras"
Message-ID: <1388865081.b4972b20f9dae97f6b86d2da51f8831bce6c625e.hwoarang@gentoo>
Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/file-format/
X-VCS-Repository: proj/devmanual
X-VCS-Files: ebuild-writing/file-format/text.xml
X-VCS-Directories: ebuild-writing/file-format/
X-VCS-Committer: hwoarang
X-VCS-Committer-Name: Markos Chandras
X-VCS-Revision: b4972b20f9dae97f6b86d2da51f8831bce6c625e
X-VCS-Branch: master
Date: Sat, 18 Oct 2014 17:35:59 +0000 (UTC)
Precedence: bulk
List-Post:
List-Help:
List-Unsubscribe:
List-Subscribe:
List-Id: Gentoo Linux mail
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Archives-Salt: 5bcf02d6-60c5-48e0-b797-893d5a4aa4c5
X-Archives-Hash: 3f0ec005cd8ff1eb31f4ce35ace9c1e6
commit: b4972b20f9dae97f6b86d2da51f8831bce6c625e
Author: Chris Reffett gentoo org>
AuthorDate: Sat Jan 4 19:51:21 2014 +0000
Commit: Markos Chandras gentoo org>
CommitDate: Sat Jan 4 19:51:21 2014 +0000
URL: http://sources.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=b4972b20
Further changes to ebuild naming, clarify snapshot naming scheme
---
ebuild-writing/file-format/text.xml | 10 +++++++---
1 file changed, 7 insertions(+), 3 deletions(-)
diff --git a/ebuild-writing/file-format/text.xml b/ebuild-writing/file-format/text.xml
index cffb9e4..aa76952 100644
--- a/ebuild-writing/file-format/text.xml
+++ b/ebuild-writing/file-format/text.xml
@@ -99,7 +99,8 @@ Finally, version may have a Gentoo revision number in the form -r1. The i
Gentoo version should have no revision suffix, the first revision should be
-r1, the second -r2 and so on. See .
Revision numbers are distinguished from patch releases by revision bumps being
-changes by Gentoo developers, while patch releases are new releases by upstream.
+changes by Gentoo developers, while patch releases are new releases by upstream (with the exception
+of snapshots, see below).
@@ -107,8 +108,11 @@ Overall, this gives us a filename like libfoo-1.2.5b_pre5-r2.ebuild.
-When packaging a snapshot of a source repository, the standard naming format is
-$(last-released-version)_pYYYYMMDD
+When packaging a snapshot of a source repository, there are two commonly used formats. The first
+treats the snapshot as a patch to the previous version, and so the ebuild version is in the format
+$(last-released-version)_pYYYYMMDD. Alternatively, the snapshot may be treated as a pre-release to
+an upcoming version, usually used when a release is anticipated but not out yet. The format for this
+is $(upcoming-version)_preYYYYMMDD.