From b105ca7cbfe2258c4f1e3c29e03adf4583af5e5b Mon Sep 17 00:00:00 2001
From: Markos Chandras <hwoarang@gentoo.org>
Date: Sun, 12 May 2013 17:00:45 +0100
Subject: slotting: Add sub-slots carefully to avoid useless rebuilds

Fixes bug #458838
---
 general-concepts/slotting/text.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

(limited to 'general-concepts/slotting')

diff --git a/general-concepts/slotting/text.xml b/general-concepts/slotting/text.xml
index bbbfad4..96aa4fc 100644
--- a/general-concepts/slotting/text.xml
+++ b/general-concepts/slotting/text.xml
@@ -80,6 +80,15 @@ If an ebuild does not explicitly declare a sub-slot, the regular slot is used
 as the value of the sub-slot by default.
 </p>
 
+<note>
+Care must be taken when using sub-slots in a library ebuild for the first time.
+Adding sub-slots will trigger rebuilds for all the packages that already use sub-slot
+dependencies (e.g. Switching from SLOT="0" to SLOT="0/14" in <c>media-libs/libpng</c> and
+package <c>foo</c> depends on <c>libpng:0=</c>).
+Therefore, it's best if you start using sub-slots in the library when the existing library
+interface changes.
+</note>
+
 </body>
 </section>
 
-- 
cgit v1.2.3-65-gdbad