summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2020-01-08 11:57:35 +0100
committerMichał Górny <mgorny@gentoo.org>2020-01-08 11:57:35 +0100
commit2522244d1ad3f4976847edd0c8d9a1cc6ee4ac9c (patch)
tree1e7f619bd8fede0f3871374cac320a6fec30e278
parentImprove index terms (diff)
downloadpolicy-guide-2522244d1ad3f4976847edd0c8d9a1cc6ee4ac9c.tar.gz
policy-guide-2522244d1ad3f4976847edd0c8d9a1cc6ee4ac9c.tar.bz2
policy-guide-2522244d1ad3f4976847edd0c8d9a1cc6ee4ac9c.zip
More on slots and subslots
Signed-off-by: Michał Górny <mgorny@gentoo.org>
-rw-r--r--dependencies.rst37
-rw-r--r--other-metadata.rst2
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)