Merge topic 'aix-archive-shared-libraries' into release-3.31

4207687a5f Help: Update AIX_SHARED_LIBRARY_ARCHIVE for versioned shared objects

Acked-by: Kitware Robot <[email protected]>
Merge-request: !9954

Help/prop_tgt/AIX_SHARED_LIBRARY_ARCHIVE.rst

@@ -11,9 +11,9 @@ shared object ``.so`` files for consistency with other UNIX platforms.
 Alternatively, set this property to a true value to create a shared
 library archive instead, as is AIX convention.
 
-When a shared library is archived the shared object in the archive
-does not record any version information from :prop_tgt:`VERSION` or
-:prop_tgt`SOVERSION` target properties.
+The shared object name in the archive encodes version information from
+the :prop_tgt:`SOVERSION` target property, if set, and otherwise from
+the :prop_tgt:`VERSION` target property, if set.
 
 This property defaults to :variable:`CMAKE_AIX_SHARED_LIBRARY_ARCHIVE`
 if that variable is set when a ``SHARED`` library target is created