INSTALL: Document CMAKE_DLL_NAME_WITH_SOVERSION

This commit is contained in:
Lasse Collin 2024-12-27 16:23:12 +02:00
parent 260d5d3620
commit 8b7c55d148
No known key found for this signature in database
GPG Key ID: 38EE757D69184620
1 changed files with 19 additions and 0 deletions

19
INSTALL
View File

@ -726,6 +726,25 @@ XZ Utils Installation
- CMake build uses /bin/sh except on Solaris the - CMake build uses /bin/sh except on Solaris the
default is /usr/xpg4/bin/sh. default is /usr/xpg4/bin/sh.
CMAKE_DLL_NAME_WITH_SOVERSION=ON
CMake on native Windows (not Cygwin) only:
This changes the filename liblzma.dll to liblzma-5.dll.
The unversioned filename liblzma.dll has been used
since XZ Utils 5.0.0 when creating binary packages
using the included windows/build.bash. The same
unversioned filename is the default with CMake.
However, there are popular builds that, very
understandably and reasonably, use the versioned
filename produced by GNU Libtool.
This option should usually be left to its default value
(OFF). It can be set to ON if the liblzma DLL filename
must be compatible with the versioned filename
produced by GNU Libtool. For example, binaries
distributed in MSYS2 use a versioned DLL filename.
2.1. Static vs. dynamic linking of liblzma 2.1. Static vs. dynamic linking of liblzma