commit: 18fae61f40b425e7e7c66c2c1418a22581b38deb
Author: Thomas Bracht Laumann Jespersen <t <AT> laumann <DOT> xyz>
AuthorDate: Sun Oct 26 14:24:37 2025 +0000
Commit: Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Wed Nov 5 15:10:24 2025 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=18fae61f
general-concepts/slottting: explain sublotting on ${PV}
Signed-off-by: Thomas Bracht Laumann Jespersen <t <AT> laumann.xyz>
Part-of: https://github.com/gentoo/devmanual/pull/379
Closes: https://github.com/gentoo/devmanual/pull/379
Signed-off-by: Sam James <sam <AT> gentoo.org>
general-concepts/slotting/text.xml | 13 +++++++++++++
1 file changed, 13 insertions(+)
diff --git a/general-concepts/slotting/text.xml
b/general-concepts/slotting/text.xml
index 311719d..767238a 100644
--- a/general-concepts/slotting/text.xml
+++ b/general-concepts/slotting/text.xml
@@ -302,6 +302,19 @@ can then request to be automatically rebuilt when the
installed version of
<c>foo:2</c> or <c>foo:1</c> changes sub-slots <d/> for example, when the user
upgrades from <c>foo-2.0</c> to <c>foo-2.1</c>.
</p>
+
+<p>
+In some libraries, there is no expectation of ABI stability between versions
+and upstream does not provide a useful SONAME. For example, some programming
+languages, like OCaml and Haskell, do not provide stable ABIs and any update to
+a library would typically require consumers to be rebuilt. In these cases, an
+appropriate subslot can use <c>${PV}</c>:
+</p>
+
+<codesample lang="ebuild">
+SLOT="0/${PV}"
+</codesample>
+
</body>
</subsubsection>
