Bug 458838 – Tell people to only include subslots in their maintained libs when it starts to be needed

• Status: RESOLVED FIXED
• Product: Documentation

[Description Pacho Ramos 2013-02-23 08:44:31 UTC]

The problem is explained in bug 454530

In summary, subslots must be included only when a lib starts to require it over current version in the tree to prevent useless rebuilds

Reproducible: Always

[Comment 1 Markos Chandras (RETIRED) 2013-02-23 13:11:25 UTC]

Care to write a patch? I am not sure I understand the problem by reading that bug but this is probably because I am still confused about subslots.

[Comment 2 Pacho Ramos 2013-02-23 13:36:19 UTC]

Will try (I also was thinking in how to properly explain that :S)

In summary:
- If libpng-1.5.14 would have finally included SLOT="0/14" it would have triggered an unneeded rebuild on every package having libpng:0= dep due bump from "0" to "0/14".
- Then, when introducing the first subslot, it needs to be bumped when rdepending packages need to be rebuilt. In this case, subslot will need to be introduced only when rebuild on packages rdepending on libpng will be needed

[Comment 3 Markos Chandras (RETIRED) 2013-05-12 15:46:10 UTC]

How about that

<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>

[Comment 4 Pacho Ramos 2013-05-12 15:49:17 UTC]

looks fine to me

[Comment 5 Markos Chandras (RETIRED) 2013-05-12 16:03:30 UTC]

Thanks. Pushed

http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=b105ca7cbfe2258c4f1e3c29e03adf4583af5e5b