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 166DF13881C 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 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 ; 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 ; 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 ; 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: <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: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail 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 gentoo org> AuthorDate: Sat Jan 4 02:50:18 2014 +0000 Commit: Markos Chandras gentoo 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. _p - Patch level + Patch release @@ -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 -r1. The initial 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.

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 +

+