From c487cdb2874911a5495f2f05dae89d4253fa260f Mon Sep 17 00:00:00 2001
From: Michał Górny
Date: Sun, 6 Aug 2017 13:45:35 +0200
Subject: general-concepts/ebuild-revisions: Clearly define the purpose of
revisions
---
general-concepts/ebuild-revisions/text.xml | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/general-concepts/ebuild-revisions/text.xml b/general-concepts/ebuild-revisions/text.xml
index f2d7234..b0c0d97 100644
--- a/general-concepts/ebuild-revisions/text.xml
+++ b/general-concepts/ebuild-revisions/text.xml
@@ -13,6 +13,20 @@ An ebuild with no explicit revision number has the implicit -r0
revision.
+Ebuild revisions usually serve two purposes:
+
+ -
+ keeping an older copy of an ebuild around when doing a potentially
+ breaking change, and
+
+
+ -
+ propagating the rebuild of a package when performing a meaningful
+ change that would otherwise go unnoticed by users who have installed
+ the current version already.
+
+
+
Ebuilds should have their -rX incremented whenever a change is made which
will make a substantial difference to what gets installed by the package by
--
cgit v1.2.3-65-gdbad