diff options
-rw-r--r-- | dependencies.rst | 37 | ||||
-rw-r--r-- | other-metadata.rst | 2 |
2 files changed, 36 insertions, 3 deletions
diff --git a/dependencies.rst b/dependencies.rst index ce9caf6..69dd4f5 100644 --- a/dependencies.rst +++ b/dependencies.rst @@ -31,11 +31,13 @@ This is especially important for packages that take long time to build. .. index:: - pair: slot; dependency - pair: subslot; dependency + pair: slot/subslot; dependency Slot and subslot dependencies ----------------------------- + +on (sub-)slotted packages +~~~~~~~~~~~~~~~~~~~~~~~~~ :Source: QA :Reference: https://archives.gentoo.org/gentoo-portage-dev/message/9cae3a92412a007febe7ac0612d50f5f :Reported: by repoman and pkgcheck @@ -64,5 +66,36 @@ means 'verified that any slot is acceptable'. to the newest package version available. +.. index:: + pair: slot/subslot; Qt + +special case: Qt packages +~~~~~~~~~~~~~~~~~~~~~~~~~ +:Source: Qt project +:Reference: https://wiki.gentoo.org/wiki/Project:Qt/Policies#Dependencies +:Reported: no + +The Qt packages use subslots in an uncommon way. The public ABI of Qt +libraries is stable within each slot, and the subslot is used to refer +to private ABI. Therefore, the ``:=`` operator must only be used +if your package uses one of the private API parts, and plain ``:5`` +or likewise dependency must be used otherwise. + +proactive use of slot operators +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +There is an open debate on whether developers should be proactively +adding ``:=`` slot operators on packages that do not define subslots +yet. + +Proponents of the idea point out that adding slot operators to reverse +dependencies after the package becomes slotted is cumbersome and usually +results in losing the subslot rebuild opportunity at least once. They +argue that in many cases the future use of subslots is reasonably +predictable. + +Opponents claim that the future use of subslots is not 100% predictable. +They point out the case of Qt packages as an example. + + .. _GLEP 62: https://www.gentoo.org/glep/glep-0062.html .. _Paludis: https://paludis.exherbo.org/ diff --git a/other-metadata.rst b/other-metadata.rst index 0b01c4b..ca3759a 100644 --- a/other-metadata.rst +++ b/other-metadata.rst @@ -1,7 +1,7 @@ Other metadata variables ======================== -.. index:: slot; dynamic +.. index:: slot/subslot; dynamic .. index:: USE flags; multislot Dynamic slots (multislot flag) |