commit:     b611f8da75d11ec59e2abce77dd5c553eb8a3404
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Sat Sep 20 13:02:26 2025 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Sat Sep 20 13:03:44 2025 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=b611f8da

general-concepts/slotting: rephrase SONAME change text

Make some small tweaks based on Arfrever's suggestions:

1) As Arfrever pointed out [0], incrementing SONAME isn't really what matters,
it's that it changed at all. They're not numbers anyway.

2) The SONAME doesn't exactly match the filename, so don't imply that
it should [1].

[0] https://github.com/gentoo/devmanual/pull/225#discussion_r664399156
[1] https://github.com/gentoo/devmanual/pull/225#discussion_r664409058

Closes: https://bugs.gentoo.org/804468
Signed-off-by: Sam James <sam <AT> gentoo.org>

 general-concepts/slotting/text.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/general-concepts/slotting/text.xml 
b/general-concepts/slotting/text.xml
index 83a2aa7..311719d 100644
--- a/general-concepts/slotting/text.xml
+++ b/general-concepts/slotting/text.xml
@@ -270,7 +270,7 @@ this case would be <c>libfoo.so.1</c>.
 </p>
 
 <p>
-The SONAME being incremented implies that the library's ABI has been broken.
+The SONAME being changed implies that the library's ABI has been broken.
 </p>
 
 <p>
@@ -330,8 +330,8 @@ SLOT="0/56.58.58"
 <p>
 In such cases, make the subslot a composite of the major SONAMEs of each of
 the installed libraries. This emphasises a point made above <d/> subslots do
-not need to be equal to the exact SONAME of installed libraries, they only need
-to represent in some way ABI compatibility.
+not need to be equal to the SONAME-derived version of installed libraries,
+they only need to represent in some way ABI compatibility.
 </p>
 
 </body>

Reply via email to