[lfs] 02/02: bzip2: add a compatibily symlink

This is an automated email from the git hooks/post-receive script.

git pushed a commit to branch trunk
in repository lfs.

commit 58e24fc912fc9766fbf3484511104cdd2c3e0d39
Author: Xi Ruoyao <[email protected]>
AuthorDate: Mon Jan 26 10:59:10 2026 +0800

    bzip2: add a compatibily symlink
    
    Resolve a test failure in kbd (failure to load bzip-compressed keymap).
    See the long note added in the commit for caveats.
    
    Link: https://github.com/legionus/kbd/blob/06957281fe21/src/libkbdfile/kbdfile-bzip2.c#L32
---
 chapter08/bzip2.xml | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/chapter08/bzip2.xml b/chapter08/bzip2.xml
index 21b8fd92c..5489befae 100644
--- a/chapter08/bzip2.xml
+++ b/chapter08/bzip2.xml
@@ -85,9 +85,30 @@ make clean</userinput></screen>
 <screen><userinput remap="install">make PREFIX=/usr install</userinput></screen>
 
     <para>Install the shared library:</para>
+
 <screen><userinput remap="install">cp -av libbz2.so.* /usr/lib
 ln -sv libbz2.so.&bzip2-version; /usr/lib/libbz2.so</userinput></screen>
 
+    <para>The name of the shared library isn't standardized and it varies
+    among distros.  The instruction above has installed
+    <filename class='libraryfile'>libbz2.so.1.0</filename>, but some
+    applications, for example Kbd, expects a different name
+    <filename class='libraryfile'>libbz2.so.1</filename> that some other
+    distros are using.  Create a compatibility symlink for them:</para>
+
+<screen><userinput>ln -sv libbz2.so.&bzip2-version; /usr/lib/libbz2.so.1</userinput></screen>
+
+    <note>
+      <para>The symlink approach is only valid here because the library
+      name difference is a result of different aesthetic views of the
+      distro maintainers, not real ABI incompatibilities.  In general
+      a library name difference most likely indicates an ABI incompatibility
+      and it would be very likely invalid to <quote>hide</quote> the
+      difference via a symlink.  Read
+      <xref linkend='pkgmgmt-upgrade-issues'/> for details about library
+      names.</para>
+    </note>
+
     <para>Install the shared <command>bzip2</command> binary into the
     <filename class="directory">/usr/bin</filename> directory, and replace
     two copies of <command>bzip2</command> with symlinks:</para>

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.

-- 
http://lists.linuxfromscratch.org/sympa/info/lfs-book
Unsubscribe: See the above information page