[gentoo-commits] proj/devmanual:master commit in: general-concepts/slotting/

["Markos Chandras" <hwoarang@gentoo.org>]

commit:     b105ca7cbfe2258c4f1e3c29e03adf4583af5e5b
Author:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
AuthorDate: Sun May 12 16:00:45 2013 +0000
Commit:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sun May 12 16:00:45 2013 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=b105ca7c

slotting: Add sub-slots carefully to avoid useless rebuilds

Fixes bug #458838

---
 general-concepts/slotting/text.xml |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)

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>