From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-739234-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
by finch.gentoo.org (Postfix) with ESMTP id 166DF13881C
for <garchives@archives.gentoo.org>; 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 72123E09C4;
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 AA229E09C1
for <gentoo-commits@lists.gentoo.org>; 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 A6EAA3402EC
for <gentoo-commits@lists.gentoo.org>; 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 5304282D5
for <gentoo-commits@lists.gentoo.org>; Sat, 18 Oct 2014 17:35:59 +0000 (UTC)
From: "Markos Chandras" <hwoarang@gentoo.org>
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" <hwoarang@gentoo.org>
Message-ID: <1388864399.ba2e7aa36d41c7a4e2caacd50bb2ae482934b23c.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: ba2e7aa36d41c7a4e2caacd50bb2ae482934b23c
X-VCS-Branch: master
Date: Sat, 18 Oct 2014 17:35:59 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Archives-Salt: b450a65a-b3e8-4b8a-8f19-deec28c68cb7
X-Archives-Hash: 038bb0178ad4d1c4183d2af3db260244
Message-ID: <20141018173559.u_bBj4uwkcPf17deD6eYs5qGHaoXUJIHyf8B0o0CCqU@z>
commit: ba2e7aa36d41c7a4e2caacd50bb2ae482934b23c
Author: Chris Reffett <creffett <AT> gentoo <DOT> org>
AuthorDate: Sat Jan 4 02:50:18 2014 +0000
Commit: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sat Jan 4 19:39:59 2014 +0000
URL: http://sources.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=ba2e7aa3
Clarify difference between _p and -r in ebuild names wrt bug 414867,
also mention the normal way of naming snapshots
---
ebuild-writing/file-format/text.xml | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/ebuild-writing/file-format/text.xml b/ebuild-writing/file-format/text.xml
index 9d00e6b..cffb9e4 100644
--- a/ebuild-writing/file-format/text.xml
+++ b/ebuild-writing/file-format/text.xml
@@ -70,7 +70,7 @@ what portage considers to be the 'lowest' version comes first.
</tr>
<tr>
<ti>_p</ti>
- <ti>Patch level</ti>
+ <ti>Patch release</ti>
</tr>
</table>
@@ -98,12 +98,19 @@ No integer part of the version may be longer than 18 digits.
Finally, version may have a Gentoo revision number in the form <c>-r1</c>. The initial
Gentoo version should have no revision suffix, the first revision should be
<c>-r1</c>, the second <c>-r2</c> and so on. See <uri link="::general-concepts/ebuild-revisions"/>.
+Revision numbers are distinguished from patch releases by revision bumps being
+changes by Gentoo developers, while patch releases are new releases by upstream.
</p>
<p>
Overall, this gives us a filename like <c>libfoo-1.2.5b_pre5-r2.ebuild</c>.
</p>
+<p>
+When packaging a snapshot of a source repository, the standard naming format is
+$(last-released-version)_pYYYYMMDD
+</p>
+
</body>
</section>