Reword library conflict paragraph.

This commit is contained in:
Bruce Dubbs 2023-05-27 17:07:58 -05:00
parent 55a29ccad2
commit d0da969c43

View File

@ -85,20 +85,18 @@
libraries until all the dependent packages have been recompiled.</para>
</listitem>
<listitem><para>If a package is (directly or indirectly) linked to
both the old and new names of one shared library (for example, the
package links to both
<filename class='libraryfile'>libfoo.so.2</filename> and
<listitem><para>If a package is (directly or indirectly) linked to both
the old and new versions of a shared library (for example, the package
links to both <filename class='libraryfile'>libfoo.so.2</filename> and
<filename class='libraryfile'>libbar.so.1</filename>, while the latter
links to
<filename class='libraryfile'>libfoo.so.3</filename> in turn), the
package may malfunction because the different names of the shared
library provide incompatible functions with same symbol names. This
can be caused by recompiling some (but not all) packages linked to the
old shared library name after the package providing the shared library
is upgraded. To avoid the issue, it's recommended to recompile every
package linked to a shared library of which the name has been changed
during an upgrade as soon as possible, in their dependency order.
links to <filename class='libraryfile'>libfoo.so.3</filename>), the
package may malfunction because the different revisions of the shared
library present conflicting locations for some symbol names. This can be
caused by recompiling some, but not all, of the packages linked to the
old shared library after the package providing the shared library is
upgraded. To avoid the issue, users will need to rebuild every package
linked to a shared library with an updated revision (e.g. libfoo.so.2 to
libfoo.so.3) as soon as possible.
</para></listitem>
<listitem> <para>If a package containing a shared library is updated,