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.