| CMP0182 |
| ------- |
| |
| .. versionadded:: 4.0 |
| |
| Create shared library archives by default on AIX. |
| |
| CMake 3.30 and below always represented ``SHARED`` library targets |
| as plain shared object ``.so`` files. This is consistent with other |
| UNIX platforms, but is not the preferred convention on AIX. |
| CMake 3.31 added the :prop_tgt:`AIX_SHARED_LIBRARY_ARCHIVE` target |
| property to create a shared library archive: the shared object ``.so`` |
| file is placed inside an archive ``.a`` file. However, the behavior |
| was disabled by default for compatibility with existing projects that |
| do not set :prop_tgt:`AIX_SHARED_LIBRARY_ARCHIVE`. |
| |
| CMake 4.0 and above prefer, when :prop_tgt:`AIX_SHARED_LIBRARY_ARCHIVE` |
| is not set, to enable creation of shared library archives by default |
| because it is the preferred convention on AIX. This policy provides |
| compatibility for projects that have not been updated. |
| |
| The ``OLD`` behavior for this policy is to disable shared library |
| archives when :prop_tgt:`AIX_SHARED_LIBRARY_ARCHIVE` is not set. |
| The ``NEW`` behavior for this policy is to enable shared library |
| archives when :prop_tgt:`AIX_SHARED_LIBRARY_ARCHIVE` is not set. |
| |
| .. |INTRODUCED_IN_CMAKE_VERSION| replace:: 4.0 |
| .. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn |
| .. include:: include/STANDARD_ADVICE.rst |
| |
| .. include:: include/DEPRECATED.rst |
